File: fontdlg.h

package info (click to toggle)
wxpython3.0 3.0.2.0%2Bdfsg-4
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 482,760 kB
  • ctags: 518,293
  • sloc: cpp: 2,127,226; python: 294,045; makefile: 51,942; ansic: 19,033; sh: 3,013; xml: 1,629; perl: 17
file content (105 lines) | stat: -rw-r--r-- 2,924 bytes parent folder | download | duplicates (11)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
/////////////////////////////////////////////////////////////////////////////
// Name:        fontdlg.h
// Purpose:     interface of wxFontDialog
// Author:      wxWidgets team
// Licence:     wxWindows licence
/////////////////////////////////////////////////////////////////////////////

/**
    @class wxFontDialog

    This class represents the font chooser dialog.

    @library{wxcore}
    @category{cmndlg}

    @see @ref overview_cmndlg_font, wxFontData, wxGetFontFromUser()
*/
class wxFontDialog : public wxDialog
{
public:
    /**
        Default ctor.
        Create() must be called before the dialog can be shown.
    */
    wxFontDialog();

    /**
        Constructor with parent window.
    */
    wxFontDialog(wxWindow* parent);

    /**
        Constructor.
        Pass a parent window, and the @ref wxFontData "font data" object
        to be used to initialize the dialog controls.
    */
    wxFontDialog(wxWindow* parent, const wxFontData& data);

    /**
        Creates the dialog if the wxFontDialog object had been initialized using
        the default constructor.

        @return @true on success and @false if an error occurred.
    */
    bool Create(wxWindow* parent);

    /**
        Creates the dialog if the wxFontDialog object had been initialized using
        the default constructor.

        @return @true on success and @false if an error occurred.
    */
    bool Create(wxWindow* parent, const wxFontData& data);

    //@{
    /**
        Returns the @ref wxFontData "font data" associated with the
        font dialog.
    */
    const wxFontData& GetFontData() const;
    wxFontData& GetFontData();
    //@}

    /**
        Shows the dialog, returning @c wxID_OK if the user pressed Ok, and
        @c wxID_CANCEL otherwise.

        If the user cancels the dialog (ShowModal returns @c wxID_CANCEL), no font
        will be created. If the user presses OK, a new wxFont will be created and
        stored in the font dialog's wxFontData structure.

        @see GetFontData()
    */
    int ShowModal();
};



// ============================================================================
// Global functions/macros
// ============================================================================

/** @addtogroup group_funcmacro_dialog */
//@{

/**
    Shows the font selection dialog and returns the font selected by user or
    invalid font (use wxFont::IsOk() to test whether a font is valid) if the
    dialog was cancelled.

    @param parent
        The parent window for the font selection dialog.
    @param fontInit
        If given, this will be the font initially selected in the dialog.
    @param caption
        If given, this will be used for the dialog caption.

    @header{wx/fontdlg.h}
*/
wxFont wxGetFontFromUser(wxWindow* parent,
                         const wxFont& fontInit,
                         const wxString& caption = wxEmptyString);

//@}