Sdílet prostřednictvím


ToolStripItem Třída

Definice

Představuje abstraktní základní třídu, která spravuje události a rozložení pro všechny prvky, které ToolStripToolStripDropDown nebo mohou obsahovat.

public ref class ToolStripItem abstract : System::ComponentModel::Component, IDisposable, System::Windows::Forms::IDropTarget
public ref class ToolStripItem abstract : System::Windows::Forms::BindableComponent, IDisposable, System::Windows::Forms::IDropTarget
public abstract class ToolStripItem : System.ComponentModel.Component, IDisposable, System.Windows.Forms.IDropTarget
public abstract class ToolStripItem : System.Windows.Forms.BindableComponent, IDisposable, System.Windows.Forms.IDropTarget
type ToolStripItem = class
    inherit Component
    interface IDropTarget
    interface IComponent
    interface IDisposable
type ToolStripItem = class
    inherit BindableComponent
    interface IDropTarget
    interface IComponent
    interface IDisposable
Public MustInherit Class ToolStripItem
Inherits Component
Implements IDisposable, IDropTarget
Public MustInherit Class ToolStripItem
Inherits BindableComponent
Implements IDisposable, IDropTarget
Dědičnost
Dědičnost
Odvozené
Implementuje

Příklady

Následující příklad kódu ukazuje, jak implementovat vlastní ToolStripItem ovládací prvek.

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Drawing.Drawing2D;
using System.Windows.Forms;

namespace RolloverItemDemoLib
{
    // This class implements a ToolStripItem that highlights
    // its border and text when the mouse enters its
    // client rectangle. It has a clickable state which is
    // exposed through the Clicked property and displayed
    // by highlighting or graying out the item's image. 
    public class RolloverItem : ToolStripItem
    {
        private bool clickedValue = false;
        private bool rolloverValue = false;

        private Rectangle imageRect;
        private Rectangle textRect;

        // For brevity, this implementation limits the possible 
        // TextDirection values to ToolStripTextDirection.Horizontal. 
        public override ToolStripTextDirection TextDirection
        {
            get
            {
                return base.TextDirection;
            }
            set
            {
                if (value == ToolStripTextDirection.Horizontal)
                {
                    base.TextDirection = value;
                }
                else
                {
                    throw new ArgumentException(
                        "RolloverItem supports only horizontal text.");
                }
            }
        }

        // For brevity, this implementation limits the possible 
        // TextImageRelation values to ImageBeforeText and TextBeforeImage. 
        public new TextImageRelation TextImageRelation
        {
            get
            {
                return base.TextImageRelation;
            }

            set
            {
                if (value == TextImageRelation.ImageBeforeText || 
                    value == TextImageRelation.TextBeforeImage)
                {
                    base.TextImageRelation = value;
                }
                else
                {
                    throw new ArgumentException(
                        "Unsupported TextImageRelation value.");
                }
            }
        }
        
        // This property returns true if the mouse is 
        // inside the client rectangle.
        public bool Rollover
        {
            get
            {
                return this.rolloverValue;
            }   
        }

        // This property returns true if the item 
        // has been toggled into the clicked state.
        // Clicking again toggles it to the 
        // unclicked state.
        public bool Clicked
        {
            get
            {
                return this.clickedValue;
            }
        }

        // The method defines the behavior of the Click event.
        // It simply toggles the state of the clickedValue field.
        protected override void OnClick(EventArgs e)
        {
            base.OnClick(e);

            this.clickedValue ^= true;
        }

        // The method defines the behavior of the DoubleClick 
        // event. It shows a MessageBox with the item's text.
        protected override void OnDoubleClick(EventArgs e)
        {
            base.OnDoubleClick(e);

            string msg = String.Format("Item: {0}", this.Text);

            MessageBox.Show(msg);
        }

        // This method defines the behavior of the MouseEnter event.
        // It sets the state of the rolloverValue field to true and
        // tells the control to repaint.
        protected override void OnMouseEnter(EventArgs e)
        {
            base.OnMouseEnter(e);

            this.rolloverValue = true;

            this.Invalidate();
        }

        // This method defines the behavior of the MouseLeave event.
        // It sets the state of the rolloverValue field to false and
        // tells the control to repaint.
        protected override void OnMouseLeave(EventArgs e)
        {
            base.OnMouseLeave(e);

            this.rolloverValue = false;

            this.Invalidate();
        }

        // This method defines the painting behavior of the control.
        // It performs the following operations:
        //
        // Computes the layout of the item's image and text.
        // Draws the item's background image.
        // Draws the item's image.
        // Draws the item's text.
        //
        // Drawing operations are implemented in the 
        // RolloverItemRenderer class.
        protected override void OnPaint(PaintEventArgs e)
        {
            base.OnPaint(e);

            if (this.Owner != null)
            {
                // Find the dimensions of the image and the text 
                // areas of the item. 
                this.ComputeImageAndTextLayout();

                // Draw the background. This includes drawing a highlighted 
                // border when the mouse is in the client area.
                ToolStripItemRenderEventArgs ea = new ToolStripItemRenderEventArgs(
                     e.Graphics,
                     this);
                this.Owner.Renderer.DrawItemBackground(ea);

                // Draw the item's image. 
                ToolStripItemImageRenderEventArgs irea =
                    new ToolStripItemImageRenderEventArgs(
                    e.Graphics,
                    this,
                    imageRect );
                this.Owner.Renderer.DrawItemImage(irea);

                // If the item is on a drop-down, give its
                // text a different highlighted color.
                Color highlightColor = 
                    this.IsOnDropDown ?
                    Color.Salmon : SystemColors.ControlLightLight;

                // Draw the text, and highlight it if the 
                // the rollover state is true.
                ToolStripItemTextRenderEventArgs rea =
                    new ToolStripItemTextRenderEventArgs(
                    e.Graphics,
                    this,
                    base.Text,
                    textRect,
                    this.rolloverValue ? highlightColor : base.ForeColor,
                    base.Font,
                    base.TextAlign);
                this.Owner.Renderer.DrawItemText(rea);
            }
        }

        // This utility method computes the layout of the 
        // RolloverItem control's image area and the text area.
        // For brevity, only the following settings are 
        // supported:
        //
        // ToolStripTextDirection.Horizontal
        // TextImageRelation.ImageBeforeText 
        // TextImageRelation.ImageBeforeText
        // 
        // It would not be difficult to support vertical text
        // directions and other image/text relationships.
        private void ComputeImageAndTextLayout()
        {
            Rectangle cr = base.ContentRectangle;
            Image img = base.Owner.ImageList.Images[base.ImageKey];

            // Compute the center of the item's ContentRectangle.
            int centerY = (cr.Height - img.Height) / 2;

            // Find the dimensions of the image and the text 
            // areas of the item. The text occupies the space 
            // not filled by the image. 
            if (base.TextImageRelation == TextImageRelation.ImageBeforeText &&
                base.TextDirection == ToolStripTextDirection.Horizontal)
            {
                imageRect = new Rectangle(
                    base.ContentRectangle.Left,
                    centerY,
                    base.Image.Width,
                    base.Image.Height);

                textRect = new Rectangle(
                    imageRect.Width,
                    base.ContentRectangle.Top,
                    base.ContentRectangle.Width - imageRect.Width,
                    base.ContentRectangle.Height);
            }
            else if (base.TextImageRelation == TextImageRelation.TextBeforeImage &&
                     base.TextDirection == ToolStripTextDirection.Horizontal)
            {
                imageRect = new Rectangle(
                    base.ContentRectangle.Right - base.Image.Width,
                    centerY,
                    base.Image.Width,
                    base.Image.Height);

                textRect = new Rectangle(
                    base.ContentRectangle.Left,
                    base.ContentRectangle.Top,
                    imageRect.X,
                    base.ContentRectangle.Bottom);
            }
        }
    }

    #region RolloverItemRenderer

    // This is the custom renderer for the RolloverItem control.
    // It draws a border around the item when the mouse is
    // in the item's client area. It also draws the item's image
    // in an inactive state (grayed out) until the user clicks
    // the item to toggle its "clicked" state.
    internal class RolloverItemRenderer : ToolStripSystemRenderer
    {
        protected override void OnRenderItemImage(
            ToolStripItemImageRenderEventArgs e)
        {
            base.OnRenderItemImage(e);

            RolloverItem item = e.Item as RolloverItem;

            // If the ToolSTripItem is of type RolloverItem, 
            // perform custom rendering for the image.
            if (item != null)
            {
                if (item.Clicked)
                {
                    // The item is in the clicked state, so 
                    // draw the image as usual.
                    e.Graphics.DrawImage(
                        e.Image,
                        e.ImageRectangle.X,
                        e.ImageRectangle.Y);
                }
                else
                {
                    // In the unclicked state, gray out the image.
                    ControlPaint.DrawImageDisabled(
                        e.Graphics,
                        e.Image,
                        e.ImageRectangle.X,
                        e.ImageRectangle.Y,
                        item.BackColor);
                }
            }
        }

        // This method defines the behavior for rendering the
        // background of a ToolStripItem. If the item is a
        // RolloverItem, it paints the item's BackgroundImage 
        // centered in the client area. If the mouse is in the 
        // item's client area, a border is drawn around it.
        // If the item is on a drop-down or if it is on the
        // overflow, a gradient is painted in the background.
        protected override void OnRenderItemBackground(
            ToolStripItemRenderEventArgs e)
        {
            base.OnRenderItemBackground(e);

            RolloverItem item = e.Item as RolloverItem;

            // If the ToolSTripItem is of type RolloverItem, 
            // perform custom rendering for the background.
            if (item != null)
            {
                if (item.Placement == ToolStripItemPlacement.Overflow ||
                    item.IsOnDropDown)
                {
                    using (LinearGradientBrush b = new LinearGradientBrush(
                        item.ContentRectangle,
                        Color.Salmon,
                        Color.DarkRed,
                        0f,
                        false))
                    {
                        e.Graphics.FillRectangle(b, item.ContentRectangle);
                    }
                }

                // The RolloverItem control only supports 
                // the ImageLayout.Center setting for the
                // BackgroundImage property.
                if (item.BackgroundImageLayout == ImageLayout.Center)
                {
                    // Get references to the item's ContentRectangle
                    // and BackgroundImage, for convenience.
                    Rectangle cr = item.ContentRectangle;
                    Image bgi = item.BackgroundImage;

                    // Compute the center of the item's ContentRectangle.
                    int centerX = (cr.Width - bgi.Width) / 2;
                    int centerY = (cr.Height - bgi.Height) / 2;

                    // If the item is selected, draw the background
                    // image as usual. Otherwise, draw it as disabled.
                    if (item.Selected)
                    {
                        e.Graphics.DrawImage(bgi, centerX, centerY);
                    }
                    else
                    {
                        ControlPaint.DrawImageDisabled(
                                e.Graphics,
                                bgi,
                                centerX,
                                centerY,
                                item.BackColor);
                    }
                }

                // If the item is in the rollover state, 
                // draw a border around it.
                if (item.Rollover)
                {
                    ControlPaint.DrawFocusRectangle(
                        e.Graphics,
                        item.ContentRectangle);
                }
            }
        }

    #endregion

    }

    // This form tests various features of the RolloverItem
    // control. RolloverItem conrols are created and added
    // to the form's ToolStrip. They are also created and 
    // added to a button's ContextMenuStrip. The behavior
    // of the RolloverItem control differs depending on 
    // the type of parent control.
    public class RolloverItemTestForm : Form
    {
        private System.Windows.Forms.ToolStrip toolStrip1;
        private System.Windows.Forms.Button button1;

        private string infoIconKey = "Information icon";
        private string handIconKey = "Hand icon";
        private string exclIconKey = "Exclamation icon";
        private string questionIconKey = "Question icon";
        private string warningIconKey = "Warning icon ";

        private System.ComponentModel.IContainer components = null;

        public RolloverItemTestForm()
        {
            InitializeComponent();

            // Set up the form's ToolStrip control.
            InitializeToolStrip();

            // Set up the ContextMenuStrip for the button.
            InitializeContextMenu();
        }

        // This utility method initializes the ToolStrip control's 
        // image list. For convenience, icons from the SystemIcons 
        // class are used for this demonstration, but any images
        // could be used.
        private void InitializeImageList(ToolStrip ts)
        {
            if (ts.ImageList == null)
            {
                ts.ImageList = new ImageList();
                ts.ImageList.ImageSize = SystemIcons.Exclamation.Size;

                ts.ImageList.Images.Add(
                    this.infoIconKey,
                    SystemIcons.Information);

                ts.ImageList.Images.Add(
                    this.handIconKey,
                    SystemIcons.Hand);

                ts.ImageList.Images.Add(
                    this.exclIconKey,
                    SystemIcons.Exclamation);

                ts.ImageList.Images.Add(
                    this.questionIconKey,
                    SystemIcons.Question);

                ts.ImageList.Images.Add(
                    this.warningIconKey,
                    SystemIcons.Warning);
            }
        }

        private void InitializeToolStrip()
        {
            this.InitializeImageList(this.toolStrip1);

            this.toolStrip1.Renderer = new RolloverItemRenderer();

            RolloverItem item = this.CreateRolloverItem(
                this.toolStrip1,
                "RolloverItem on ToolStrip",
                this.Font,
                infoIconKey,
                TextImageRelation.ImageBeforeText,
                exclIconKey);

            this.toolStrip1.Items.Add(item);

            item = this.CreateRolloverItem(
                this.toolStrip1,
                "RolloverItem on ToolStrip",
                this.Font,
                infoIconKey,
                TextImageRelation.ImageBeforeText,
                exclIconKey);

            this.toolStrip1.Items.Add(item);
        }

        private void InitializeContextMenu()
        {
            Font f = new System.Drawing.Font(
                "Arial",
                18f,
                FontStyle.Bold);

            ContextMenuStrip cms = new ContextMenuStrip();
            this.InitializeImageList(cms);

            cms.Renderer = new RolloverItemRenderer();
            cms.AutoSize = true;
            cms.ShowCheckMargin = false;
            cms.ShowImageMargin = false;

            RolloverItem item = this.CreateRolloverItem(
                cms,
                "RolloverItem on ContextMenuStrip",
                f,
                handIconKey,
                TextImageRelation.ImageBeforeText,
                exclIconKey);

            cms.Items.Add(item);

            item = this.CreateRolloverItem(
                cms,
                "Another RolloverItem on ContextMenuStrip",
                f,
                questionIconKey,
                TextImageRelation.ImageBeforeText,
                exclIconKey);

            cms.Items.Add(item);

            item = this.CreateRolloverItem(
                cms,
                "And another RolloverItem on ContextMenuStrip",
                f,
                warningIconKey,
                TextImageRelation.ImageBeforeText,
                exclIconKey);

            cms.Items.Add(item);

            cms.Closing += new ToolStripDropDownClosingEventHandler(cms_Closing);

            this.button1.ContextMenuStrip = cms;
        }

        // This method handles the ContextMenuStrip 
        // control's Closing event. It prevents the 
        // RolloverItem from closing the drop-down  
        // when the item is clicked.
        void cms_Closing(object sender, ToolStripDropDownClosingEventArgs e)
        {
            if (e.CloseReason == ToolStripDropDownCloseReason.ItemClicked)
            {
                e.Cancel = true;
            }
        }

        // This method handles the Click event for the button.
        // it selects the first item in the ToolStrip control
        // by using the ToolStripITem.Select method.
        private void button1_Click(object sender, EventArgs e)
        {
            RolloverItem item = this.toolStrip1.Items[0] as RolloverItem;

            if (item != null)
            {
                item.Select();

                this.Invalidate();
            }
        }

        // This utility method creates a RolloverItem 
        // and adds it to a ToolStrip control.
        private RolloverItem CreateRolloverItem(
            ToolStrip owningToolStrip,
            string txt,
            Font f,
            string imgKey,
            TextImageRelation tir,
            string backImgKey)
        {
            RolloverItem item = new RolloverItem();

            item.Alignment = ToolStripItemAlignment.Left;
            item.AllowDrop = false;
            item.AutoSize = true;

            item.BackgroundImage = owningToolStrip.ImageList.Images[backImgKey];
            item.BackgroundImageLayout = ImageLayout.Center;
            item.DisplayStyle = ToolStripItemDisplayStyle.ImageAndText;
            item.DoubleClickEnabled = true;
            item.Enabled = true;
            item.Font = f;

            // These assignments are equivalent. Each assigns an
            // image from the owning toolstrip's image list.
            item.ImageKey = imgKey;
            //item.Image = owningToolStrip.ImageList.Images[infoIconKey];
            //item.ImageIndex = owningToolStrip.ImageList.Images.IndexOfKey(infoIconKey);
            item.ImageScaling = ToolStripItemImageScaling.None;

            item.Owner = owningToolStrip;
            item.Padding = new Padding(2);
            item.Text = txt;
            item.TextAlign = ContentAlignment.MiddleLeft;
            item.TextDirection = ToolStripTextDirection.Horizontal;
            item.TextImageRelation = tir;

            return item;
        }

        protected override void Dispose(bool disposing)
        {
            if (disposing && (components != null))
            {
                components.Dispose();
            }
            base.Dispose(disposing);
        }

        #region Windows Form Designer generated code

        private void InitializeComponent()
        {
            this.toolStrip1 = new System.Windows.Forms.ToolStrip();
            this.button1 = new System.Windows.Forms.Button();
            this.SuspendLayout();
            // 
            // toolStrip1
            // 
            this.toolStrip1.AllowItemReorder = true;
            this.toolStrip1.Location = new System.Drawing.Point(0, 0);
            this.toolStrip1.Name = "toolStrip1";
            this.toolStrip1.Size = new System.Drawing.Size(845, 25);
            this.toolStrip1.TabIndex = 0;
            this.toolStrip1.Text = "toolStrip1";
            // 
            // button1
            // 
            this.button1.Location = new System.Drawing.Point(12, 100);
            this.button1.Name = "button1";
            this.button1.Size = new System.Drawing.Size(86, 23);
            this.button1.TabIndex = 1;
            this.button1.Text = "Click to select";
            this.button1.UseVisualStyleBackColor = true;
            this.button1.Click += new System.EventHandler(this.button1_Click);
            // 
            // RolloverItemTestForm
            // 
            this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 14F);
            this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
            this.AutoSize = true;
            this.ClientSize = new System.Drawing.Size(845, 282);
            this.Controls.Add(this.button1);
            this.Controls.Add(this.toolStrip1);
            this.Font = new System.Drawing.Font("Arial", 8.25F, System.Drawing.FontStyle.Regular, System.Drawing.GraphicsUnit.Point, ((byte)(0)));
            this.Name = "RolloverItemTestForm";
            this.Text = "Form1";
            this.ResumeLayout(false);
            this.PerformLayout();
        }

        #endregion
    }

    static class Program
    {   
        [STAThread]
        static void Main()
        {
            Application.EnableVisualStyles();
            Application.SetCompatibleTextRenderingDefault(false);
            Application.Run(new RolloverItemTestForm());
        }
    }
}
Option Strict On
Option Explicit On

Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Drawing
Imports System.Drawing.Drawing2D
Imports System.Windows.Forms

' This class implements a ToolStripItem that highlights
' its border and text when the mouse enters its
' client rectangle. It has a clickable state which is
' exposed through the Clicked property and displayed
' by highlighting or graying out the item's image. 
Public Class RolloverItem
    Inherits ToolStripItem

   Private clickedValue As Boolean = False
   Private rolloverValue As Boolean = False
   
   Private imageRect As Rectangle
   Private textRect As Rectangle
   
   ' For brevity, this implementation limits the possible 
   ' TextDirection values to ToolStripTextDirection.Horizontal. 
   Public Overrides Property TextDirection() As ToolStripTextDirection
      Get
         Return MyBase.TextDirection
      End Get
      Set
         If value = ToolStripTextDirection.Horizontal Then
            MyBase.TextDirection = value
         Else
                Throw New ArgumentException( _
                "RolloverItem supports only horizontal text.")
         End If
      End Set
   End Property
   
   ' For brevity, this implementation limits the possible 
   ' TextImageRelation values to ImageBeforeText and TextBeforeImage. 
   Public Shadows Property TextImageRelation() As TextImageRelation
      Get
         Return MyBase.TextImageRelation
      End Get
      
      Set
            If Value = TextImageRelation.ImageBeforeText OrElse _
               Value = TextImageRelation.TextBeforeImage Then
                MyBase.TextImageRelation = Value
            Else
                Throw New ArgumentException("Unsupported TextImageRelation value.")
            End If
      End Set
   End Property
   
   ' This property returns true if the mouse is 
   ' inside the client rectangle.
   Public ReadOnly Property Rollover() As Boolean
      Get
         Return Me.rolloverValue
      End Get
    End Property

   ' This property returns true if the item 
   ' has been toggled into the clicked state.
   ' Clicking again toggles it to the 
   ' unclicked state.
   Public ReadOnly Property Clicked() As Boolean
      Get
         Return Me.clickedValue
      End Get
   End Property
   
   ' The method defines the behavior of the Click event.
   ' It simply toggles the state of the clickedValue field.
   Protected Overrides Sub OnClick(e As EventArgs)
      MyBase.OnClick(e)
      
        Me.clickedValue = Me.clickedValue Xor True
    End Sub

   ' The method defines the behavior of the DoubleClick 
   ' event. It shows a MessageBox with the item's text.
   Protected Overrides Sub OnDoubleClick(e As EventArgs)
      MyBase.OnDoubleClick(e)
      
      Dim msg As String = String.Format("Item: {0}", Me.Text)
      
      MessageBox.Show(msg)
    End Sub

   ' This method defines the behavior of the MouseEnter event.
   ' It sets the state of the rolloverValue field to true and
   ' tells the control to repaint.
   Protected Overrides Sub OnMouseEnter(e As EventArgs)
      MyBase.OnMouseEnter(e)
      
      Me.rolloverValue = True
      
      Me.Invalidate()
    End Sub
   
   ' This method defines the behavior of the MouseLeave event.
   ' It sets the state of the rolloverValue field to false and
   ' tells the control to repaint.
   Protected Overrides Sub OnMouseLeave(e As EventArgs)
      MyBase.OnMouseLeave(e)
      
      Me.rolloverValue = False
      
      Me.Invalidate()
    End Sub
   
   ' This method defines the painting behavior of the control.
   ' It performs the following operations:
   '
   ' Computes the layout of the item's image and text.
   ' Draws the item's background image.
   ' Draws the item's image.
   ' Draws the item's text.
   '
   ' Drawing operations are implemented in the 
   ' RolloverItemRenderer class.
   Protected Overrides Sub OnPaint(e As PaintEventArgs)
      MyBase.OnPaint(e)
      
      If (Me.Owner IsNot Nothing) Then
         ' Find the dimensions of the image and the text 
         ' areas of the item. 
         Me.ComputeImageAndTextLayout()
         
         ' Draw the background. This includes drawing a highlighted 
         ' border when the mouse is in the client area.
         Dim ea As New ToolStripItemRenderEventArgs(e.Graphics, Me)
         Me.Owner.Renderer.DrawItemBackground(ea)
         
         ' Draw the item's image. 
         Dim irea As New ToolStripItemImageRenderEventArgs(e.Graphics, Me, imageRect)
         Me.Owner.Renderer.DrawItemImage(irea)
         
         ' If the item is on a drop-down, give its
         ' text a different highlighted color.
            Dim highlightColor As Color = CType(IIf(Me.IsOnDropDown, Color.Salmon, SystemColors.ControlLightLight), Color)
         
         ' Draw the text, and highlight it if the 
         ' the rollover state is true.
            Dim rea As New ToolStripItemTextRenderEventArgs( _
               e.Graphics, _
               Me, _
               MyBase.Text, _
               textRect, _
               CType(IIf(Me.rolloverValue, highlightColor, MyBase.ForeColor), Color), _
               MyBase.Font, _
               MyBase.TextAlign)
         Me.Owner.Renderer.DrawItemText(rea)
      End If
    End Sub

   ' This utility method computes the layout of the 
   ' RolloverItem control's image area and the text area.
   ' For brevity, only the following settings are 
   ' supported:
   '
   ' ToolStripTextDirection.Horizontal
   ' TextImageRelation.ImageBeforeText 
   ' TextImageRelation.ImageBeforeText
   ' 
   ' It would not be difficult to support vertical text
   ' directions and other image/text relationships.
   Private Sub ComputeImageAndTextLayout()
      Dim cr As Rectangle = MyBase.ContentRectangle
      Dim img As Image = MyBase.Owner.ImageList.Images(MyBase.ImageKey)
      
      ' Compute the center of the item's ContentRectangle.
        Dim centerY As Integer = CInt((cr.Height - img.Height) / 2)
      
      ' Find the dimensions of the image and the text 
      ' areas of the item. The text occupies the space 
      ' not filled by the image. 
        If MyBase.TextImageRelation = _
        TextImageRelation.ImageBeforeText AndAlso _
        MyBase.TextDirection = ToolStripTextDirection.Horizontal Then

            imageRect = New Rectangle( _
            MyBase.ContentRectangle.Left, _
            centerY, _
            MyBase.Image.Width, _
            MyBase.Image.Height)

            textRect = New Rectangle( _
            imageRect.Width, _
            MyBase.ContentRectangle.Top, _
            MyBase.ContentRectangle.Width - imageRect.Width, _
            MyBase.ContentRectangle.Height)

        ElseIf MyBase.TextImageRelation = _
        TextImageRelation.TextBeforeImage AndAlso _
        MyBase.TextDirection = ToolStripTextDirection.Horizontal Then

            imageRect = New Rectangle( _
            MyBase.ContentRectangle.Right - MyBase.Image.Width, _
            centerY, _
            MyBase.Image.Width, _
            MyBase.Image.Height)

            textRect = New Rectangle( _
            MyBase.ContentRectangle.Left, _
            MyBase.ContentRectangle.Top, _
            imageRect.X, _
            MyBase.ContentRectangle.Bottom)

        End If
    End Sub
End Class

' This is the custom renderer for the RolloverItem control.
' It draws a border around the item when the mouse is
' in the item's client area. It also draws the item's image
' in an inactive state (grayed out) until the user clicks
' the item to toggle its "clicked" state.
Friend Class RolloverItemRenderer
    Inherits ToolStripSystemRenderer

    Protected Overrides Sub OnRenderItemImage(ByVal e As ToolStripItemImageRenderEventArgs)
        MyBase.OnRenderItemImage(e)

        Dim item As RolloverItem = CType(e.Item, RolloverItem)

        ' If the ToolSTripItem is of type RolloverItem, 
        ' perform custom rendering for the image.
        If (item IsNot Nothing) Then
            If item.Clicked Then
                ' The item is in the clicked state, so 
                ' draw the image as usual.
                e.Graphics.DrawImage(e.Image, e.ImageRectangle.X, e.ImageRectangle.Y)
            Else
                ' In the unclicked state, gray out the image.
                ControlPaint.DrawImageDisabled(e.Graphics, e.Image, e.ImageRectangle.X, e.ImageRectangle.Y, item.BackColor)
            End If
        End If
    End Sub

    ' This method defines the behavior for rendering the
    ' background of a ToolStripItem. If the item is a
    ' RolloverItem, it paints the item's BackgroundImage 
    ' centered in the client area. If the mouse is in the 
    ' item's client area, a border is drawn around it.
    ' If the item is on a drop-down or if it is on the
    ' overflow, a gradient is painted in the background.
    Protected Overrides Sub OnRenderItemBackground(ByVal e As ToolStripItemRenderEventArgs)
        MyBase.OnRenderItemBackground(e)

        Dim item As RolloverItem = CType(e.Item, RolloverItem)

        ' If the ToolSTripItem is of type RolloverItem, 
        ' perform custom rendering for the background.
        If (item IsNot Nothing) Then
            If item.Placement = ToolStripItemPlacement.Overflow OrElse item.IsOnDropDown Then
                Dim b As New LinearGradientBrush(item.ContentRectangle, Color.Salmon, Color.DarkRed, 0.0F, False)
                Try
                    e.Graphics.FillRectangle(b, item.ContentRectangle)
                Finally
                    b.Dispose()
                End Try
            End If

            ' The RolloverItem control only supports 
            ' the ImageLayout.Center setting for the
            ' BackgroundImage property.
            If item.BackgroundImageLayout = ImageLayout.Center Then
                ' Get references to the item's ContentRectangle
                ' and BackgroundImage, for convenience.
                Dim cr As Rectangle = item.ContentRectangle
                Dim bgi As Image = item.BackgroundImage

                ' Compute the center of the item's ContentRectangle.
                Dim centerX As Integer = CInt((cr.Width - bgi.Width) / 2)
                Dim centerY As Integer = CInt((cr.Height - bgi.Height) / 2)

                ' If the item is selected, draw the background
                ' image as usual. Otherwise, draw it as disabled.
                If item.Selected Then
                    e.Graphics.DrawImage(bgi, centerX, centerY)
                Else
                    ControlPaint.DrawImageDisabled(e.Graphics, bgi, centerX, centerY, item.BackColor)
                End If
            End If

            ' If the item is in the rollover state, 
            ' draw a border around it.
            If item.Rollover Then
                ControlPaint.DrawFocusRectangle(e.Graphics, item.ContentRectangle)
            End If
        End If
    End Sub

End Class

' This form tests various features of the RolloverItem
' control. RolloverItem conrols are created and added
' to the form's ToolStrip. They are also created and 
' added to a button's ContextMenuStrip. The behavior
' of the RolloverItem control differs depending on 
' the type of parent control.

Public Class RolloverItemTestForm
   Inherits Form
   Private toolStrip1 As System.Windows.Forms.ToolStrip
   Private WithEvents button1 As System.Windows.Forms.Button
   
   Private infoIconKey As String = "Information icon"
   Private handIconKey As String = "Hand icon"
   Private exclIconKey As String = "Exclamation icon"
   Private questionIconKey As String = "Question icon"
   Private warningIconKey As String = "Warning icon "
   
   Private components As System.ComponentModel.IContainer = Nothing
   
   
   Public Sub New()
      InitializeComponent()
      
      ' Set up the form's ToolStrip control.
      InitializeToolStrip()
      
      ' Set up the ContextMenuStrip for the button.
      InitializeContextMenu()
    End Sub
   
   
   ' This utility method initializes the ToolStrip control's 
   ' image list. For convenience, icons from the SystemIcons 
   ' class are used for this demonstration, but any images
   ' could be used.
   Private Sub InitializeImageList(ts As ToolStrip)
      If ts.ImageList Is Nothing Then
         ts.ImageList = New ImageList()
         ts.ImageList.ImageSize = SystemIcons.Exclamation.Size
         
         ts.ImageList.Images.Add(Me.infoIconKey, SystemIcons.Information)
         
         ts.ImageList.Images.Add(Me.handIconKey, SystemIcons.Hand)
         
         ts.ImageList.Images.Add(Me.exclIconKey, SystemIcons.Exclamation)
         
         ts.ImageList.Images.Add(Me.questionIconKey, SystemIcons.Question)
         
         ts.ImageList.Images.Add(Me.warningIconKey, SystemIcons.Warning)
      End If
    End Sub
   
   
   Private Sub InitializeToolStrip()
      Me.InitializeImageList(Me.toolStrip1)
      
      Me.toolStrip1.Renderer = New RolloverItemRenderer()
      
      Dim item As RolloverItem = Me.CreateRolloverItem(Me.toolStrip1, "RolloverItem on ToolStrip", Me.Font, infoIconKey, TextImageRelation.ImageBeforeText, exclIconKey)
      
      Me.toolStrip1.Items.Add(item)
      
      item = Me.CreateRolloverItem(Me.toolStrip1, "RolloverItem on ToolStrip", Me.Font, infoIconKey, TextImageRelation.ImageBeforeText, exclIconKey)
      
      Me.toolStrip1.Items.Add(item)
    End Sub
   
   
   Private Sub InitializeContextMenu()
        Dim f As New System.Drawing.Font("Arial", 18.0F, FontStyle.Bold)
      
      Dim cms As New ContextMenuStrip()
      Me.InitializeImageList(cms)
      
      cms.Renderer = New RolloverItemRenderer()
      cms.AutoSize = True
      cms.ShowCheckMargin = False
      cms.ShowImageMargin = False
      
        Dim item As RolloverItem = Me.CreateRolloverItem( _
        cms, _
        "RolloverItem on ContextMenuStrip", _
        f, _
        handIconKey, _
        TextImageRelation.ImageBeforeText, _
        exclIconKey)
      
      cms.Items.Add(item)
      
        item = Me.CreateRolloverItem( _
        cms, _
        "Another RolloverItem on ContextMenuStrip", _
        f, _
        questionIconKey, _
        TextImageRelation.ImageBeforeText, _
        exclIconKey)
      
      cms.Items.Add(item)
      
        item = Me.CreateRolloverItem( _
        cms, _
        "And another RolloverItem on ContextMenuStrip", _
        CType(f, Drawing.Font), _
        warningIconKey, _
        TextImageRelation.ImageBeforeText, _
        exclIconKey)
      
      cms.Items.Add(item)
      
      AddHandler cms.Closing, AddressOf cms_Closing
      
      Me.button1.ContextMenuStrip = cms
    End Sub
   
   
   ' This method handles the ContextMenuStrip 
   ' control's Closing event. It prevents the 
   ' RolloverItem from closing the drop-down  
   ' when the item is clicked.
   Private Sub cms_Closing(sender As Object, e As ToolStripDropDownClosingEventArgs)
      If e.CloseReason = ToolStripDropDownCloseReason.ItemClicked Then
         e.Cancel = True
      End If
    End Sub
   
   
   ' This method handles the Click event for the button.
   ' it selects the first item in the ToolStrip control
   ' by using the ToolStripITem.Select method.
   Private Sub button1_Click(sender As Object, e As EventArgs) Handles button1.Click
        Dim item As RolloverItem = CType(Me.toolStrip1.Items(0), RolloverItem)
      
      If (item IsNot Nothing) Then
         item.Select()
         
         Me.Invalidate()
      End If
    End Sub

   ' This utility method creates a RolloverItem 
   ' and adds it to a ToolStrip control.
    Private Function CreateRolloverItem( _
    ByVal owningToolStrip As ToolStrip, _
    ByVal txt As String, _
    ByVal f As Font, _
    ByVal imgKey As String, _
    ByVal tir As TextImageRelation, _
    ByVal backImgKey As String) As RolloverItem

        Dim item As New RolloverItem()

        item.Alignment = ToolStripItemAlignment.Left
        item.AllowDrop = False
        item.AutoSize = True

        item.BackgroundImage = owningToolStrip.ImageList.Images(backImgKey)
        item.BackgroundImageLayout = ImageLayout.Center
        item.DisplayStyle = ToolStripItemDisplayStyle.ImageAndText
        item.DoubleClickEnabled = True
        item.Enabled = True
        item.Font = f

        ' These assignments are equivalent. Each assigns an
        ' image from the owning toolstrip's image list.
        item.ImageKey = imgKey
        'item.Image = owningToolStrip.ImageList.Images[infoIconKey];
        'item.ImageIndex = owningToolStrip.ImageList.Images.IndexOfKey(infoIconKey);
        item.ImageScaling = ToolStripItemImageScaling.None

        item.Owner = owningToolStrip
        item.Padding = New Padding(2)
        item.Text = txt
        item.TextAlign = ContentAlignment.MiddleLeft
        item.TextDirection = ToolStripTextDirection.Horizontal
        item.TextImageRelation = tir

        Return item
    End Function

   Protected Overrides Sub Dispose(disposing As Boolean)
      If disposing AndAlso (components IsNot Nothing) Then
         components.Dispose()
      End If
      MyBase.Dispose(disposing)
    End Sub
   
   #Region "Windows Form Designer generated code"
   
   Private Sub InitializeComponent()
      Me.toolStrip1 = New System.Windows.Forms.ToolStrip()
      Me.button1 = New System.Windows.Forms.Button()
      Me.SuspendLayout()
      ' 
      ' toolStrip1
      ' 
      Me.toolStrip1.AllowItemReorder = True
      Me.toolStrip1.Location = New System.Drawing.Point(0, 0)
      Me.toolStrip1.Name = "toolStrip1"
      Me.toolStrip1.Size = New System.Drawing.Size(845, 25)
      Me.toolStrip1.TabIndex = 0
      Me.toolStrip1.Text = "toolStrip1"
      ' 
      ' button1
      ' 
      Me.button1.Location = New System.Drawing.Point(12, 100)
      Me.button1.Name = "button1"
      Me.button1.Size = New System.Drawing.Size(86, 23)
      Me.button1.TabIndex = 1
      Me.button1.Text = "Click to select"
      Me.button1.UseVisualStyleBackColor = True
      ' 
      ' RolloverItemTestForm
      ' 
      Me.AutoScaleDimensions = New System.Drawing.SizeF(6F, 14F)
      Me.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font
      Me.AutoSize = True
      Me.ClientSize = New System.Drawing.Size(845, 282)
      Me.Controls.Add(button1)
      Me.Controls.Add(toolStrip1)
        Me.Font = New System.Drawing.Font("Arial", 8.25F, System.Drawing.FontStyle.Regular, System.Drawing.GraphicsUnit.Point, 0)
      Me.Name = "RolloverItemTestForm"
      Me.Text = "Form1"
      Me.ResumeLayout(False)
      Me.PerformLayout()
    End Sub
   
#End Region

End Class


Public Class Program

    <STAThread()> _
    Shared Sub Main()
        Application.EnableVisualStyles()
        Application.SetCompatibleTextRenderingDefault(False)
        Application.Run(New RolloverItemTestForm())
    End Sub
End Class

Poznámky

A ToolStripItem je prvek, jako je tlačítko, pole se seznamem, textové pole nebo popisek, který může být obsažen v ovládacím ToolStrip prvku nebo ovládacím ToolStripDropDown prvku, který je podobný místní nabídce Windows. Třída ToolStrip pro tyto prvky spravuje obraz a vstup pomocí klávesnice a myši, včetně vstupu přetažením, a ToolStripItem třída spravuje události a rozložení v samotných prvcích.

ToolStripItem Třídy dědí buď přímo z ToolStripItem, nebo nepřímo dědí z ToolStripItem prostřednictvím ToolStripControlHost nebo ToolStripDropDownItem.

ToolStripItem ovládací prvky musí být obsaženy v objektech ToolStrip, MenuStrip, StatusStripnebo ContextMenuStrip a nelze je přidat přímo do formuláře. Různé třídy kontejnerů jsou navrženy tak, aby obsahovaly odpovídající podmnožinu ovládacích ToolStripItem prvků.

Poznámka Daný objekt ToolStripItem nemůže mít více než jeden nadřazený ToolStripobjekt . Musíte zkopírovat a přidat ho ToolStripItem do jiných ToolStrip ovládacích prvků.

V následující tabulce jsou uvedeny prvky, které jsou odvozeny z ToolStripItem třídy a které lze proto hostovat v objektu ToolStrip nebo ToolStripDropDown.

Element Popis
ToolStripButton Tlačítko panelu nástrojů, které podporuje obrázky a text.
ToolStripLabel Textový popisek se obvykle používá na stavovém řádku nebo ToolStrip jako komentář nebo nadpis.
ToolStripSeparator Nevybírejný prostor nebo mezera se svislým pruhem, který vizuálně seskupuje prvky.
ToolStripControlHost AToolStripItem, které hostuje ToolStripComboBox, ToolStripTextBox, ToolStripProgressBar, další model Windows Forms ovládací prvky nebo vlastní ovládací prvky.

A ToolStripComboBox je textové pole, do kterého může uživatel zadat text, spolu se seznamem, ze kterého může vybrat text a vyplnit textové pole.

A ToolStripTextBox umožňuje uživateli zadat text.

A ToolStripProgressBar představuje ovládací prvek Indikátor průběhu systému Windows obsažený v objektu StatusStrip.
ToolStripDropDownItem A ToolStripItem , které hostuje ToolStripMenuItem, ToolStripSplitButtona ToolStripDropDownButton.

A ToolStripMenuItem je možnost výběru zobrazená v nabídce nebo místní nabídce.

A ToolStripSplitButton je kombinace běžného tlačítka a rozevíracího tlačítka.

A ToolStripDropDownButton je tlačítko, které podporuje funkci rozevíracího seznamu.
ToolStripStatusLabel Panel v ovládacím StatusStrip prvku

Konstruktory

ToolStripItem()

Inicializuje novou instanci ToolStripItem třídy.

ToolStripItem(String, Image, EventHandler)

Inicializuje novou instanci ToolStripItem třídy se zadaným názvem, image a obslužnou rutinou události.

ToolStripItem(String, Image, EventHandler, String)

Inicializuje novou instanci ToolStripItem třídy se zadaným zobrazeným textem, obrázkem, obslužnou rutinou události a názvem.

Vlastnosti

AccessibilityObject

Získá přiřazené AccessibleObject ovládacímu prvku.

AccessibleDefaultActionDescription

Získá nebo nastaví výchozí popis akce ovládacího prvku pro použití klientskými aplikacemi přístupnosti.

AccessibleDescription

Získá nebo nastaví popis, který bude hlášen klientským aplikacím přístupnosti.

AccessibleName

Získá nebo nastaví název ovládacího prvku pro použití klientskými aplikacemi přístupnosti.

AccessibleRole

Získá nebo nastaví přístupnou roli ovládacího prvku, který určuje typ uživatelského rozhraní elementu ovládacího prvku.

Alignment

Získá nebo nastaví hodnotu označující, zda se položka zarovná k začátku nebo konci objektu ToolStrip.

AllowDrop

Získá nebo nastaví hodnotu označující, zda přetahování a změna pořadí položek jsou zpracovány prostřednictvím událostí, které implementujete.

Anchor

Získá nebo nastaví okraje kontejneru, na který ToolStripItem je vázán a určuje, jak ToolStripItem je změněna velikost s jeho nadřazenou.

AutoSize

Získá nebo nastaví hodnotu určující, zda má položka automaticky velikost.

AutoToolTip

Získá nebo nastaví hodnotu označující, zda použít Text vlastnost nebo ToolTipText vlastnost pro ToolStripItem popis.

Available

Získá nebo nastaví hodnotu označující, zda ToolStripItem má být umístěn na ToolStrip.

BackColor

Získá nebo nastaví barvu pozadí pro položku.

BackgroundImage

Získá nebo nastaví obrázek pozadí zobrazený v položce.

BackgroundImageLayout

Získá nebo nastaví rozložení obrázku pozadí použitého ToolStripItempro .

BindingContext

Získá nebo nastaví kolekci správců měn pro IBindableComponent.

(Zděděno od BindableComponent)
Bounds

Získá velikost a umístění položky.

CanRaiseEvents

Získá hodnotu označující, zda komponenta může vyvolat událost.

(Zděděno od Component)
CanSelect

Získá hodnotu označující, zda lze vybrat položku.

Command

Získá nebo nastaví ICommand čí Execute(Object) metoda bude volána při ToolStripItem událost Click je vyvolána.

CommandParameter

Získá nebo nastaví parametr, který je předán ICommand do přiřazené Command vlastnosti.

Container

Získá objekt IContainer , který obsahuje Component.

(Zděděno od Component)
ContentRectangle

Získá oblast, ve které lze obsah, například text a ikony, umístit do objektu ToolStripItem bez přepsání ohraničení pozadí.

DataBindings

Získá kolekci objektů datové vazby pro tento IBindableComponentobjekt .

(Zděděno od BindableComponent)
DefaultAutoToolTip

Získá hodnotu určující, zda se má zobrazit ToolTip , která je definována jako výchozí.

DefaultDisplayStyle

Získá hodnotu označující, co je zobrazeno na ToolStripItem.

DefaultMargin

Získá výchozí okraj položky.

DefaultPadding

Získá vnitřní mezery vlastnosti položky.

DefaultSize

Získá výchozí velikost položky.

DesignMode

Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component .

(Zděděno od Component)
DismissWhenClicked

Získá hodnotu označující, zda jsou položky na po ToolStripDropDown kliknutí skryté.

DisplayStyle

Získá nebo nastaví, zda se text a obrázky zobrazí na ToolStripItem.

Dock

Získá nebo nastaví, které ToolStripItem ohraničení jsou ukotveny do nadřazeného ovládacího prvku a určuje, jak se změní velikost objektu ToolStripItem s nadřazeným objektem.

DoubleClickEnabled

Získá nebo nastaví hodnotu označující, zda ToolStripItem lze aktivovat poklikáním myši.

Enabled

Získá nebo nastaví hodnotu určující, zda nadřazený ToolStripItem ovládací prvek je povolen.

Events

Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component.

(Zděděno od Component)
Font

Získá nebo nastaví písmo textu zobrazeného položkou.

ForeColor

Získá nebo nastaví barvu popředí položky.

Height

Získá nebo nastaví výšku v pixelech objektu ToolStripItem.

Image

Získá nebo nastaví obrázek, který je zobrazen na ToolStripItem.

ImageAlign

Získá nebo nastaví zarovnání obrázku na ToolStripItem.

ImageIndex

Získá nebo nastaví hodnotu indexu obrázku, který je zobrazen na položce.

ImageKey

Získá nebo nastaví klíč příslušenství pro obrázek, ImageList který je zobrazen na ToolStripItem.

ImageScaling

Získá nebo nastaví hodnotu označující, zda je obrázek na obrázku ToolStripItem automaticky změněn tak, aby se vešel do kontejneru.

ImageTransparentColor

Získá nebo nastaví barvu, která bude v obrázku považována za průhlednou ToolStripItem .

IsDisposed

Získá hodnotu označující, zda objekt byl odstraněn.

IsOnDropDown

Získá hodnotu označující, zda kontejner aktuální Control je .ToolStripDropDown

IsOnOverflow

Získá hodnotu označující, zda Placement je vlastnost nastavena na Overflow.

Margin

Získá nebo nastaví mezeru mezi položkou a sousedními položkami.

MergeAction

Získá nebo nastaví způsob sloučení podřízených nabídek s nadřazenými nabídkami.

MergeIndex

Získá nebo nastaví pozici sloučené položky v rámci aktuální ToolStrip.

Name

Získá nebo nastaví název položky.

Overflow

Získá nebo nastaví, zda je položka připojena k ToolStrip nebo ToolStripOverflowButton nebo může plovoucí mezi dvěma.

Owner

Získá nebo nastaví vlastníka této položky.

OwnerItem

Získá nadřazenou ToolStripItem hodnotu tohoto ToolStripItemobjektu .

Padding

Získá nebo nastaví vnitřní mezery v pixelech mezi obsahem položky a jejími okraji.

Parent

Získá nebo nastaví nadřazený kontejner objektu ToolStripItem.

Placement

Získá aktuální rozložení položky.

Pressed

Získá hodnotu označující, zda je stisknut stav položky.

Renderer

Představuje abstraktní základní třídu, která spravuje události a rozložení pro všechny prvky, které ToolStripToolStripDropDown nebo mohou obsahovat.

RightToLeft

Získá nebo nastaví hodnotu určující, zda mají být položky umístěny zprava doleva a text má být zapsán zprava doleva.

RightToLeftAutoMirrorImage

Automaticky zrcadlí ToolStripItem obrázek, když RightToLeft je vlastnost nastavená na Yes.

Selected

Získá hodnotu označující, zda je vybraná položka.

ShowKeyboardCues

Získá hodnotu označující, zda chcete zobrazit nebo skrýt klávesové zkratky.

Site

Získá nebo nastaví ISite hodnotu Component.

(Zděděno od Component)
Size

Získá nebo nastaví velikost položky.

Tag

Získá nebo nastaví objekt, který obsahuje data o položce.

Text

Získá nebo nastaví text, který má být zobrazen na položce.

TextAlign

Získá nebo nastaví zarovnání textu na ToolStripLabel.

TextDirection

Získá orientaci textu použitého na ToolStripItem.

TextImageRelation

Získá nebo nastaví pozici ToolStripItem textu a obrázku vzhledem k sobě navzájem.

ToolTipText

Získá nebo nastaví text, který se zobrazí jako ToolTip ovládací prvek.

Visible

Získá nebo nastaví hodnotu označující, zda je položka zobrazena.

Width

Získá nebo nastaví šířku v pixelech objektu ToolStripItem.

Metody

CreateAccessibilityInstance()

Vytvoří nový objekt přístupnosti ToolStripItempro .

CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem.

(Zděděno od MarshalByRefObject)
Dispose()

Uvolní všechny prostředky používané nástrojem Component.

(Zděděno od Component)
Dispose(Boolean)

Uvolní nespravované prostředky používané ToolStripItem nástrojem a volitelně uvolní spravované prostředky.

DoDragDrop(Object, DragDropEffects)

Spustí operaci přetažení.

DoDragDrop(Object, DragDropEffects, Bitmap, Point, Boolean)

Spustí operaci přetažení.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetCurrentParent()

Načte ToolStrip kontejner aktuálního ToolStripItem.

GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetLifetimeService()
Zastaralé.

Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
GetPreferredSize(Size)

Načte velikost obdélníkové oblasti, do které se ovládací prvek vejde.

GetService(Type)

Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jejím Containerobjektem .

(Zděděno od Component)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
InitializeLifetimeService()
Zastaralé.

Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
Invalidate()

Zneplatní celý povrch objektu ToolStripItem a způsobí jeho překreslení.

Invalidate(Rectangle)

Zneplatní zadanou oblast objektu ToolStripItem přidáním do oblasti aktualizace objektu ToolStripItem, což je oblast, která se překreslí při další operaci malování, a způsobí odeslání zprávy malování do objektu ToolStripItem.

IsInputChar(Char)

Určuje, zda je znak vstupní znak, který položka rozpozná.

IsInputKey(Keys)

Určuje, zda je zadaný klíč běžným vstupním klíčem nebo speciálním klíčem, který vyžaduje předběžné zpracování.

MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
MemberwiseClone(Boolean)

Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu.

(Zděděno od MarshalByRefObject)
OnAvailableChanged(EventArgs)

Vyvolá událost AvailableChanged.

OnBackColorChanged(EventArgs)

BackColorChanged Vyvolá událost.

OnBindingContextChanged(EventArgs)

BindingContextChanged Vyvolá událost.

(Zděděno od BindableComponent)
OnBoundsChanged()

Nastane při Bounds změně vlastnosti.

OnClick(EventArgs)

Click Vyvolá událost.

OnCommandCanExecuteChanged(EventArgs)

CommandCanExecuteChanged Vyvolá událost.

OnCommandChanged(EventArgs)

CommandChanged Vyvolá událost.

OnCommandParameterChanged(EventArgs)

CommandParameterChanged Vyvolá událost.

OnDisplayStyleChanged(EventArgs)

DisplayStyleChanged Vyvolá událost.

OnDoubleClick(EventArgs)

DoubleClick Vyvolá událost.

OnDragDrop(DragEventArgs)

DragDrop Vyvolá událost.

OnDragEnter(DragEventArgs)

DragEnter Vyvolá událost.

OnDragLeave(EventArgs)

DragLeave Vyvolá událost.

OnDragOver(DragEventArgs)

DragOver Vyvolá událost.

OnEnabledChanged(EventArgs)

EnabledChanged Vyvolá událost.

OnFontChanged(EventArgs)

FontChanged Vyvolá událost.

OnForeColorChanged(EventArgs)

ForeColorChanged Vyvolá událost.

OnGiveFeedback(GiveFeedbackEventArgs)

GiveFeedback Vyvolá událost.

OnLayout(LayoutEventArgs)

Layout Vyvolá událost.

OnLocationChanged(EventArgs)

LocationChanged Vyvolá událost.

OnMouseDown(MouseEventArgs)

MouseDown Vyvolá událost.

OnMouseEnter(EventArgs)

MouseEnter Vyvolá událost.

OnMouseHover(EventArgs)

MouseHover Vyvolá událost.

OnMouseLeave(EventArgs)

MouseLeave Vyvolá událost.

OnMouseMove(MouseEventArgs)

MouseMove Vyvolá událost.

OnMouseUp(MouseEventArgs)

MouseUp Vyvolá událost.

OnOwnerChanged(EventArgs)

OwnerChanged Vyvolá událost.

OnOwnerFontChanged(EventArgs)

Vyvolá událost, FontChanged když se Font vlastnost změnila v nadřazené objektu ToolStripItem.

OnPaint(PaintEventArgs)

Paint Vyvolá událost.

OnParentBackColorChanged(EventArgs)

BackColorChanged Vyvolá událost.

OnParentChanged(ToolStrip, ToolStrip)

ParentChanged Vyvolá událost.

OnParentEnabledChanged(EventArgs)

Vyvolá událost při EnabledChangedEnabled změně hodnoty vlastnosti kontejneru položky.

OnParentForeColorChanged(EventArgs)

ForeColorChanged Vyvolá událost.

OnParentRightToLeftChanged(EventArgs)

RightToLeftChanged Vyvolá událost.

OnQueryContinueDrag(QueryContinueDragEventArgs)

QueryContinueDrag Vyvolá událost.

OnRequestCommandExecute(EventArgs)

Volá se v kontextu pro OnClick(EventArgs) vyvolání Execute(Object) , pokud to kontext umožňuje.

OnRightToLeftChanged(EventArgs)

RightToLeftChanged Vyvolá událost.

OnSelectedChanged(EventArgs)

Představuje abstraktní základní třídu, která spravuje události a rozložení pro všechny prvky, které ToolStripToolStripDropDown nebo mohou obsahovat.

OnTextChanged(EventArgs)

TextChanged Vyvolá událost.

OnVisibleChanged(EventArgs)

VisibleChanged Vyvolá událost.

PerformClick()

Vygeneruje Click událost pro ToolStripItem.

ProcessCmdKey(Message, Keys)

Zpracuje příkazový klíč.

ProcessDialogKey(Keys)

Zpracuje klávesu dialogového okna.

ProcessMnemonic(Char)

Zpracovává mnemotechnický znak.

ResetBackColor()

Tato metoda není pro tuto třídu relevantní.

ResetDisplayStyle()

Tato metoda není pro tuto třídu relevantní.

ResetFont()

Tato metoda není pro tuto třídu relevantní.

ResetForeColor()

Tato metoda není pro tuto třídu relevantní.

ResetImage()

Tato metoda není pro tuto třídu relevantní.

ResetMargin()

Tato metoda není pro tuto třídu relevantní.

ResetPadding()

Tato metoda není pro tuto třídu relevantní.

ResetRightToLeft()

Tato metoda není pro tuto třídu relevantní.

ResetTextDirection()

Tato metoda není pro tuto třídu relevantní.

Select()

Vybere položku.

SetBounds(Rectangle)

Nastaví velikost a umístění položky.

SetVisibleCore(Boolean)

ToolStripItem Nastaví hodnotu na zadaný viditelný stav.

ToString()

String Vrátí hodnotu obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána.

Událost

AvailableChanged

Nastane, když se změní hodnota Available vlastnosti.

BackColorChanged

Nastane, když se změní hodnota BackColor vlastnosti.

BindingContextChanged

Nastane při změně kontextu vazby.

(Zděděno od BindableComponent)
Click

Zobrazí se ToolStripItem při kliknutí na tlačítko.

CommandCanExecuteChanged

Nastane, když se CanExecute(Object) změní stav ICommand přiřazené Command vlastnosti.

CommandChanged

Nastane, když se přiřazení ICommandCommand vlastnosti změnilo.

CommandParameterChanged

Nastane, když se hodnota CommandParameter vlastnosti změnila.

DisplayStyleChanged

Nastane, když došlo ke DisplayStyle změně.

Disposed

Nastane, když je komponenta odstraněna voláním Dispose() metody.

(Zděděno od Component)
DoubleClick

Nastane, když na položku pokliknete myší.

DragDrop

Nastane, když uživatel přetáhne položku a uživatel uvolní tlačítko myši, což znamená, že položka by měla být přehozena do této položky.

DragEnter

Nastane, když uživatel přetáhne položku do klientské oblasti této položky.

DragLeave

Nastane, když uživatel přetáhne položku a ukazatel myši již není nad klientskou oblastí této položky.

DragOver

Nastane, když uživatel přetáhne položku přes klientskou oblast této položky.

EnabledChanged

Nastane, když se Enabled hodnota vlastnosti změnila.

ForeColorChanged

Nastane při ForeColor změně hodnoty vlastnosti.

GiveFeedback

Vyvolá se při operaci přetažení.

LocationChanged

Nastane při aktualizaci umístění.ToolStripItem

MouseDown

Nastane, když je ukazatel myši nad položkou a je stisknuto tlačítko myši.

MouseEnter

Nastane, když ukazatel myši vstoupí do položky.

MouseHover

Nastane, když ukazatel myši najede na položku.

MouseLeave

Nastane, když ukazatel myši opustí položku.

MouseMove

Nastane, když se ukazatel myši přesune na položku.

MouseUp

Nastane, když je ukazatel myši nad položkou a uvolní se tlačítko myši.

OwnerChanged

Nastane při Owner změně vlastnosti.

Paint

Nastane při překreslení položky.

QueryAccessibilityHelp

Nastane, když klientská aplikace pro usnadnění přístupu vyvolá nápovědu ToolStripItempro .

QueryContinueDrag

Probíhá během operace přetažení a umožňuje zdroji přetažení určit, zda má být operace přetažení zrušena.

RightToLeftChanged

Nastane při RightToLeft změně hodnoty vlastnosti.

SelectedChanged

Představuje abstraktní základní třídu, která spravuje události a rozložení pro všechny prvky, které ToolStripToolStripDropDown nebo mohou obsahovat.

TextChanged

Nastane, když se změní hodnota Text vlastnosti.

VisibleChanged

Nastane, když se změní hodnota Visible vlastnosti.

Explicitní implementace rozhraní

IDropTarget.OnDragDrop(DragEventArgs)

DragDrop Vyvolá událost.

IDropTarget.OnDragEnter(DragEventArgs)

DragEnter Vyvolá událost.

IDropTarget.OnDragLeave(EventArgs)

DragLeave Vyvolá událost.

IDropTarget.OnDragOver(DragEventArgs)

DragOver Vyvolá událost.

Platí pro

Viz také