Contents Up Previous Next

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::GetMarginWidth
wxMenuItem::GetName
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

id

text

helpString

checkable

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::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.


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).