#include <wx/control.h>
This is the base class for a control or "widget".
A control is generally a small window which processes user input and/or displays one or more item of data.
The following event handler macros redirect the events to member function handlers 'func' with prototypes like:
Event macros for events emitted by this class:
Public Member Functions | |
virtual void | Command (wxCommandEvent &event) |
Simulates the effect of the user issuing a command to the item. | |
wxString | GetLabel () const |
Returns the control's text. | |
wxString | GetLabelText () const |
Returns the control's label without mnemonics. | |
void | SetLabel (const wxString &label) |
Sets the item's text. | |
void | SetLabelText (const wxString &text) |
Sets the item's text to exactly the given string. | |
Static Public Member Functions | |
static wxString | Ellipsize (const wxString &label, const wxDC &dc, wxEllipsizeMode mode, int maxWidth, int flags=wxELLIPSIZE_FLAGS_DEFAULT) |
Replaces parts of the label string with ellipsis, if needed, so that it doesn't exceed maxWidth. | |
static wxString | GetLabelText (const wxString &label) |
Returns the given label string without mnemonics ("&" characters). | |
static wxString | RemoveMnemonics (const wxString &str) |
Removes the mnemonics ("&" characters) from the given string. | |
static wxString | EscapeMnemonics (const wxString &text) |
Escape the special mnemonics characters ("&") in the given string. |
virtual void wxControl::Command | ( | wxCommandEvent & | event | ) | [virtual] |
Simulates the effect of the user issuing a command to the item.
static wxString wxControl::Ellipsize | ( | const wxString & | label, | |
const wxDC & | dc, | |||
wxEllipsizeMode | mode, | |||
int | maxWidth, | |||
int | flags = wxELLIPSIZE_FLAGS_DEFAULT | |||
) | [static] |
Replaces parts of the label string with ellipsis, if needed, so that it doesn't exceed maxWidth.
label | The string to ellipsize | |
dc | The DC used to retrieve the character widths through the wxDC::GetPartialTextExtents() function. | |
mode | The ellipsization modes. See wxEllipsizeMode. | |
maxWidth | The maximum width of the returned string in pixels. | |
flags | One or more of the wxEllipsize |
Escape the special mnemonics characters ("&") in the given string.
This function can be helpful if you need to set the controls label to a user-provided string. If the string contains ampersands, they wouldn't appear on the display but be used instead to indicate that the character following the first of them can be used as a control mnemonic. While this can sometimes be desirable (e.g. to allow the user to configure mnemonics of the controls), more often you will want to use this function before passing a user-defined string to SetLabel(). Alternatively, if the label is entirely user-defined, you can just call SetLabelText() directly -- but this function must be used if the label is a combination of a part defined by program containing the control mnemonics and a user-defined part.
text | The string such as it should appear on the display. |
wxString wxControl::GetLabel | ( | ) | const [virtual] |
Returns the control's text.
Reimplemented from wxWindow.
Reimplemented in wxButton, and wxStaticText.
Returns the given label string without mnemonics ("&" characters).
Reimplemented in wxStaticText.
wxString wxControl::GetLabelText | ( | ) | const |
Returns the control's label without mnemonics.
Reimplemented in wxStaticText.
Removes the mnemonics ("&" characters) from the given string.
void wxControl::SetLabel | ( | const wxString & | label | ) | [virtual] |
Sets the item's text.
Any "&" characters in the label are special and indicate that the following character is a mnemonic for this control and can be used to activate it from the keyboard (typically by using Alt key in combination with it). To insert a literal ampersand character, you need to double it, i.e. use use "&&". If this behaviour is undesirable, use SetLabelText() instead.
Reimplemented from wxWindow.
Reimplemented in wxButton, and wxStaticText.
void wxControl::SetLabelText | ( | const wxString & | text | ) |
Sets the item's text to exactly the given string.
Unlike SetLabel(), this function shows exactly the text passed to it in the control, without interpreting ampersands in it in any way. Notice that it means that the control can't have any mnemonic defined for it using this function.
![]() |
[ top ] |