## wxMenuItem

A menu item represents an item in a popup menu. Note that the majority of this class is only implemented under Windows so far, but everything except fonts, colours and bitmaps can be achieved via wxMenu on all platforms.

Derived from

wxOwnerDrawn (Windows only)
wxObject

Include files

<wx/menuitem.h>

See also

wxMenuBar, wxMenu

Members

wxMenuItem::wxMenuItem
wxMenuItem::~wxMenuItem
wxMenuItem::Check
wxMenuItem::DeleteSubMenu
wxMenuItem::Enable
wxMenuItem::GetBackgroundColour
wxMenuItem::GetBitmap
wxMenuItem::GetFont
wxMenuItem::GetHelp
wxMenuItem::GetId
wxMenuItem::GetLabel
wxMenuItem::GetLabelFromText
wxMenuItem::GetMarginWidth
wxMenuItem::GetName
wxMenuItem::GetText
wxMenuItem::GetSubMenu
wxMenuItem::GetTextColour
wxMenuItem::IsCheckable
wxMenuItem::IsChecked
wxMenuItem::IsEnabled
wxMenuItem::IsSeparator
wxMenuItem::SetBackgroundColour
wxMenuItem::SetBitmaps
wxMenuItem::SetFont
wxMenuItem::SetHelp
wxMenuItem::SetMarginWidth
wxMenuItem::SetName
wxMenuItem::SetTextColour

### wxMenuItem::wxMenuItem

wxMenuItem(wxMenu* parentMenu = NULL, int id = ID_SEPARATOR, const wxString& text = "", const wxString& helpString = "", bool checkable = FALSE, wxMenu* subMenu = NULL, )

Constructs a wxMenuItem object.

Parameters

parentMenu

Menu that the menu item belongs to.

id

Identifier for this menu item, or ID_SEPARATOR to indicate a separator.

text

Text for the menu item, as shown on the menu.

helpString

Optional help string that will be shown on the status bar.

checkable

TRUE if this menu item is checkable.

subMenu

If non-NULL, indicates that the menu item is a submenu.

### wxMenuItem::~wxMenuItem

~wxMenuItem()

Destructor.

### wxMenuItem::Check

void Check(bool check)

Checks or unchecks the menu item.

### wxMenuItem::DeleteSubMenu

void DeleteSubMenu()

Deletes the submenu, if any.

### wxMenuItem::Enable

void Enable(bool enable)

Enables or disables the menu item.

### wxMenuItem::GetBackgroundColour

wxColour& GetBackgroundColour() const

Returns the background colour associated with the menu item (Windows only).

### wxMenuItem::GetBitmap

wxBitmap& GetBitmap(bool checked = TRUE) const

Returns the checked or unchecked bitmap (Windows only).

### wxMenuItem::GetFont

wxFont& GetFont() const

Returns the font associated with the menu item (Windows only).

### wxMenuItem::GetHelp

wxString GetHelp() const

Returns the help string associated with the menu item.

### wxMenuItem::GetId

int GetId() const

Returns the menu item identifier.

### wxMenuItem::GetLabel

wxString GetLabel() const

Returns the text associated with the menu item without any accelerator characaters it might contain.

See also

GetText, GetLabelFromText

### wxMenuItem::GetLabelFromText

static wxString GetLabelFromText(const wxString& text)

Strips all accelerator characeters and mnemonics from the given text. For example,

    wxMenuItem::GetLabelFromText("&Hello\tCtrl-H");

will return just `"Hello"`.

See also

GetText, GetLabel

### wxMenuItem::GetMarginWidth

int GetMarginWidth() const

Gets the width of the menu item checkmark bitmap (Windows only).

### wxMenuItem::GetName

wxString GetName() const

Returns the text associated with the menu item.

NB: this function is deprecated, please use GetText or GetLabel instead.

### wxMenuItem::GetText

wxString GetText() const

Returns the text associated with the menu item, such as it was passed to the wxMenuItem constructor, i.e. with any accelerator characters it may contain.

See also

GetLabel, GetLabelFromText

### wxMenuItem::GetSubMenu

wxMenu* GetSubMenu() const

Returns the submenu associated with the menu item, or NULL if there isn't one.

### wxMenuItem::GetTextColour

wxColour& GetTextColour() const

Returns the text colour associated with the menu item (Windows only).

### wxMenuItem::IsCheckable

bool IsCheckable() const

Returns TRUE if the item is checkable.

### wxMenuItem::IsChecked

bool IsChecked() const

Returns TRUE if the item is checked.

### wxMenuItem::IsEnabled

bool IsEnabled() const

Returns TRUE if the item is enabled.

### wxMenuItem::IsSeparator

bool IsSeparator() const

Returns TRUE if the item is a separator.

### wxMenuItem::SetBackgroundColour

void SetBackgroundColour(const wxColour& colour) const

Sets the background colour associated with the menu item (Windows only).

### wxMenuItem::SetBitmaps

void SetBitmaps(const wxBitmap& checked, const wxBitmap& unchecked = wxNullBitmap) const

Sets the checked/unchecked bitmaps for the menu item (Windows only). The first bitmap is also used as the single bitmap for uncheckable menu items.

### wxMenuItem::SetFont

void SetFont(const wxFont& font) const

Sets the font associated with the menu item (Windows only).

### wxMenuItem::SetHelp

void SetHelp(const wxString& helpString) const

Sets the help string.

### wxMenuItem::SetMarginWidth

void SetMarginWidth(int width) const

Sets the width of the menu item checkmark bitmap (Windows only).

### wxMenuItem::SetName

void SetName(const wxString& text) const

Sets the text associated with the menu item.

### wxMenuItem::SetTextColour

void SetTextColour(const wxColour& colour) const

Sets the text colour associated with the menu item (Windows only).