MenuItem.MeasureItem Event
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Occurs when the menu needs to know the size of a menu item before drawing it.
public:
event System::Windows::Forms::MeasureItemEventHandler ^ MeasureItem;
public event System.Windows.Forms.MeasureItemEventHandler MeasureItem;
member this.MeasureItem : System.Windows.Forms.MeasureItemEventHandler
Public Custom Event MeasureItem As MeasureItemEventHandler
Event Type
Examples
The following code example demonstrates the use of this member. In the example, an event handler reports on the occurrence of the MeasureItem event. This report helps you to learn when the event occurs and can assist you in debugging.
To run the example code, paste it into a project that contains an instance of type MenuItem named MenuItem1
. Then ensure that the event handler is associated with the MeasureItem event.
private void MenuItem1_MeasureItem(Object sender, MeasureItemEventArgs e) {
System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Graphics", e.Graphics );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Index", e.Index );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ItemHeight", e.ItemHeight );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "ItemWidth", e.ItemWidth );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "MeasureItem Event" );
}
Private Sub MenuItem1_MeasureItem(sender as Object, e as MeasureItemEventArgs) _
Handles MenuItem1.MeasureItem
Dim messageBoxVB as New System.Text.StringBuilder()
messageBoxVB.AppendFormat("{0} = {1}", "Graphics", e.Graphics)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "Index", e.Index)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "ItemHeight", e.ItemHeight)
messageBoxVB.AppendLine()
messageBoxVB.AppendFormat("{0} = {1}", "ItemWidth", e.ItemWidth)
messageBoxVB.AppendLine()
MessageBox.Show(messageBoxVB.ToString(),"MeasureItem Event")
End Sub
Remarks
In order for this event to be raised, you must have the OwnerDraw property of the menu item set to true
. This event is raised before owner drawn menus are drawn to allow for the size of the menu item to be drawn to be specified. For more information about handling events, see Handling and Raising Events.