OwnerDrawMenuItem Class

In This Topic

Represents a class that inherits from the System.Windows.Forms.MenuItem class and provides custom drawing, which is dependent on the current OS appearance settings.

Object Model

Syntax

Visual Basic
C#

'Declaration
 
<ToolboxItemAttribute(False)>
<DesignTimeVisibleAttribute(False)>
<DefaultEventAttribute("Click")>
<DefaultPropertyAttribute("Text")>
<ToolboxItemFilterAttribute("System.Windows.Forms")>
<ListBindableAttribute(False)>
<DesignerCategoryAttribute("Component")>
Public Class OwnerDrawMenuItem 
   Inherits System.Windows.Forms.MenuItem

'Usage
 
Dim instance As OwnerDrawMenuItem

[ToolboxItem(false)]
[DesignTimeVisible(false)]
[DefaultEvent("Click")]
[DefaultProperty("Text")]
[ToolboxItemFilter("System.Windows.Forms")]
[ListBindable(false)]
[DesignerCategory("Component")]
public class OwnerDrawMenuItem : System.Windows.Forms.MenuItem

Remarks

The class adds support for menu item icons. You can also associate a Command object to instances of this class.

Example

This example shows how to create a menu item:

Visual Basic

Dim item As OwnerDrawMenuItem =  New OwnerDrawMenuItem("New Item") 
' set an image
item.Image = imageList1.Images(0)
' add it to a MainMenu object
Me.Menu.MenuItems(0).MenuItems.Add(item)

OwnerDrawMenuItem item = new OwnerDrawMenuItem("New Item");
// set an image
item.Image = imageList1.Images[0];
// add it to a MainMenu object
this.Menu.MenuItems[0].MenuItems.Add(item);

Inheritance Hierarchy

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Windows.Forms.Menu
            System.Windows.Forms.MenuItem
               Xceed.Chart.UIControls.OwnerDrawMenuItem

Public Constructors

	Name	Description
	OwnerDrawMenuItem Constructor	Overloaded.

Top

Protected Fields

	Name	Description
	m_bDrawImage	This member is reserved for internal use and is not intended to be used directly from your code.
	m_bXPAppearance	This member is reserved for internal use and is not intended to be used directly from your code.
	m_Param	This member is reserved for internal use and is not intended to be used directly from your code.

Top

Public Properties

	Name	Description
	BarBreak	(Inherited from System.Windows.Forms.MenuItem)
	Break	(Inherited from System.Windows.Forms.MenuItem)
	Checked	(Inherited from System.Windows.Forms.MenuItem)
	Command	Gets or sets the command associated with the menu item
	Container	(Inherited from System.ComponentModel.Component)
	DefaultItem	(Inherited from System.Windows.Forms.MenuItem)
	Description	Gets or sets the description text, which must appear on the specified status bar (if any).
	Enabled	(Inherited from System.Windows.Forms.MenuItem)
	Handle	(Inherited from System.Windows.Forms.Menu)
	Image	Gets or sets the Image to display next to the menu item
	Index	(Inherited from System.Windows.Forms.MenuItem)
	IsParent	(Inherited from System.Windows.Forms.MenuItem)
	MdiList	(Inherited from System.Windows.Forms.MenuItem)
	MdiListItem	(Inherited from System.Windows.Forms.Menu)
	MenuItems	(Inherited from System.Windows.Forms.Menu)
	MergeOrder	(Inherited from System.Windows.Forms.MenuItem)
	MergeType	(Inherited from System.Windows.Forms.MenuItem)
	Mnemonic	(Inherited from System.Windows.Forms.MenuItem)
	Name	(Inherited from System.Windows.Forms.Menu)
	OwnerDraw	(Inherited from System.Windows.Forms.MenuItem)
	Param	Gets or sets additional data associated with the menu item.
	Parent	(Inherited from System.Windows.Forms.MenuItem)
	RadioCheck	(Inherited from System.Windows.Forms.MenuItem)
	Shortcut	(Inherited from System.Windows.Forms.MenuItem)
	ShouldDrawImage	Gets or sets a value whether to draw an image(if any)
	ShowShortcut	(Inherited from System.Windows.Forms.MenuItem)
	Site	(Inherited from System.ComponentModel.Component)
	StatusBar	Gets or sets a StatusBar object on which the menu item should display its description
	Tag	(Inherited from System.Windows.Forms.Menu)
	Text	(Inherited from System.Windows.Forms.MenuItem)
	Visible	(Inherited from System.Windows.Forms.MenuItem)

Top

Protected Properties

	Name	Description
	CanRaiseEvents	(Inherited from System.ComponentModel.Component)
	DesignMode	(Inherited from System.ComponentModel.Component)
	Events	(Inherited from System.ComponentModel.Component)
	MenuID	(Inherited from System.Windows.Forms.MenuItem)

Top

Public Methods

	Name	Description
	CloneMenu	Overloaded. (Inherited from System.Windows.Forms.MenuItem)
	CreateObjRef	(Inherited from System.MarshalByRefObject)
	Dispose	Overloaded. Overridden. This member is reserved for internal use and is not intended to be used directly from your code.
	FindMenuItem	(Inherited from System.Windows.Forms.Menu)
	GetContextMenu	(Inherited from System.Windows.Forms.Menu)
	GetLifetimeService	(Inherited from System.MarshalByRefObject)
	GetMainMenu	(Inherited from System.Windows.Forms.Menu)
	InitializeLifetimeService	(Inherited from System.MarshalByRefObject)
	IsTopMenuItem	Determines whether this is a top menu item
	MergeMenu	Overloaded. (Inherited from System.Windows.Forms.MenuItem)
	PerformClick	(Inherited from System.Windows.Forms.MenuItem)
	PerformSelect	(Inherited from System.Windows.Forms.MenuItem)
	ToString	(Inherited from System.Windows.Forms.MenuItem)

Top

Protected Methods

	Name	Description
	CreateMenuHandle	(Inherited from System.Windows.Forms.Menu)
	DrawCheckMark	This member is reserved for internal use and is not intended to be used directly from your code.
	DrawImage	This member is reserved for internal use and is not intended to be used directly from your code.
	DrawImageSelection	This member is reserved for internal use and is not intended to be used directly from your code.
	DrawItemNormal	This member is reserved for internal use and is not intended to be used directly from your code.
	DrawItemSelected	This member is reserved for internal use and is not intended to be used directly from your code.
	DrawSeparator	This member is reserved for internal use and is not intended to be used directly from your code.
	DrawShortcut	This member is reserved for internal use and is not intended to be used directly from your code.
	DrawText	This member is reserved for internal use and is not intended to be used directly from your code.
	Finalize	(Inherited from System.ComponentModel.Component)
	FindMergePosition	(Inherited from System.Windows.Forms.Menu)
	GetService	(Inherited from System.ComponentModel.Component)
	MemberwiseClone	Overloaded. (Inherited from System.MarshalByRefObject)
	OnClick	Overridden. This member is reserved for internal use and is not intended to be used directly from your code.
	OnDrawItem	Overridden. This member is reserved for internal use and is not intended to be used directly from your code.
	OnInitMenuPopup	(Inherited from System.Windows.Forms.MenuItem)
	OnMeasureItem	Overridden. This member is reserved for internal use and is not intended to be used directly from your code.
	OnPopup	Overridden. This member is reserved for internal use and is not intended to be used directly from your code.
	OnSelect	Overridden. This member is reserved for internal use and is not intended to be used directly from your code.
	ProcessCmdKey	(Inherited from System.Windows.Forms.Menu)

Top

Public Events

	Name	Description
	Click	(Inherited from System.Windows.Forms.MenuItem)
	Disposed	(Inherited from System.ComponentModel.Component)
	DrawItem	(Inherited from System.Windows.Forms.MenuItem)
	MeasureItem	(Inherited from System.Windows.Forms.MenuItem)
	Popup	(Inherited from System.Windows.Forms.MenuItem)
	Select	(Inherited from System.Windows.Forms.MenuItem)

Top

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

OwnerDrawMenuItem Members
Xceed.Chart.UIControls Namespace

Send Feedback

Business Suite

Ultimate Suite

Reference