wxWidgets/interface/fontdlg.h
Francesco Montorsi 328f5751e8 add const qualifiers
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52414 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2008-03-09 16:24:26 +00:00

87 lines
2.6 KiB
Objective-C

/////////////////////////////////////////////////////////////////////////////
// Name: fontdlg.h
// Purpose: documentation for wxFontDialog class
// Author: wxWidgets team
// RCS-ID: $Id$
// Licence: wxWindows license
/////////////////////////////////////////////////////////////////////////////
/**
@class wxFontDialog
@wxheader{fontdlg.h}
This class represents the font chooser dialog.
@library{wxcore}
@category{cmndlg}
@seealso
Overview, wxFontData, wxGetFontFromUser
*/
class wxFontDialog : public wxDialog
{
public:
//@{
/**
Constructor. Pass a parent window, and optionally the
@ref overview_wxfontdata "font data" object to be used to initialize the dialog
controls. If the default constructor is used,
Create() must be called before the dialog can be
shown.
*/
wxFontDialog();
wxFontDialog(wxWindow* parent);
wxFontDialog(wxWindow* parent, const wxFontData& data);
//@}
//@{
/**
Creates the dialog if it the wxFontDialog object had been initialized using the
default constructor. Returns @true on success and @false if an error
occurred.
*/
bool Create(wxWindow* parent);
bool Create(wxWindow* parent, const wxFontData& data);
//@}
//@{
/**
Returns the @ref overview_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.
*/
int ShowModal();
};
// ============================================================================
// Global functions/macros
// ============================================================================
/**
Shows the font selection dialog and returns the font selected by user or
invalid font (use @ref wxFont::isok 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.
*/
wxFont wxGetFontFromUser(wxWindow* parent,
const wxFont& fontInit,
const wxString& caption = wxEmptyString);