ToolStripItem Třída

Definice

Představuje abstraktní základní třídu, která spravuje události a rozložení pro všechny prvky, které ToolStrip mohou obsahovat nebo ToolStripDropDown 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

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

ToolStripItem třídy buď dědí přímo z ToolStripItem, nebo zdědí nepřímo prostřednictvím ToolStripItemToolStripControlHost nebo ToolStripDropDownItem.

ToolStripItem ovládací prvky musí být obsaženy v objektu ToolStrip, MenuStrip, StatusStripnebo ContextMenuStrip nelze přidat přímo do formuláře. Různé třídy kontejneru jsou navrženy tak, aby obsahovaly příslušnou podmnožinu ovládacích ToolStripItem prvků.

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

Následující tabulka ukazuje prvky, které jsou odvozeny z ToolStripItem třídy, a proto mohou být hostovány v objektu nebo ToolStripToolStripDropDown.

prvek Description
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 název.
ToolStripSeparator Nevybírejný prostor nebo mezera se svislým pruhem, který vizuálně seskupuje prvky.
ToolStripControlHost ToolStripItem, který je hostitelem ToolStripComboBox, ToolStripTextBox, ToolStripProgressBar, jiných ovládacích prvků model Windows Forms nebo vlastních ovládacích prvků.

A ToolStripComboBox je textové pole, do kterého může uživatel zadat text spolu se seznamem, ze kterého může uživatel vybrat text k vyplnění textového pole.

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

ToolStripProgressBar představuje ovládací prvek indikátoru průběhu Windows obsažený v ovládacím prvku StatusStrip.
ToolStripDropDownItem A ToolStripItem , který je hostitelem 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 rozevírací funkce.
ToolStripStatusLabel Panel v ovládacím StatusStrip prvku

Konstruktory

Name Description
ToolStripItem()

Inicializuje novou instanci ToolStripItem třídy.

ToolStripItem(String, Image, EventHandler, String)

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

ToolStripItem(String, Image, EventHandler)

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

Vlastnosti

Name Description
AccessibilityObject

AccessibleObject Získá přiřazený ovládací prvek.

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ý se bude hlásit klientským aplikacím pro usnadnění přístupu.

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 prvku uživatelského rozhraní ovládacího prvku.

Alignment

Získá nebo nastaví hodnotu určující, zda se položka zarovná směrem k začátku nebo konci ToolStrip.

AllowDrop

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

Anchor

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

AutoSize

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

AutoToolTip

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

Available

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

BackColor

Získá nebo nastaví barvu pozadí položky.

BackgroundImage

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

BackgroundImageLayout

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

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 určující, zda komponenta může vyvolat událost.

(Zděděno od Component)
CanSelect

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

Command

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

CommandParameter

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

Container

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

(Zděděno od Component)
ContentRectangle

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

DataBindings

Získá kolekci objektů vazby dat pro toto IBindableComponent.

(Zděděno od BindableComponent)
DefaultAutoToolTip

Získá hodnotu určující, zda se má zobrazit ToolTip , který je definován 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 Component je aktuálně v režimu návrhu.

(Zděděno od Component)
DismissWhenClicked

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

DisplayStyle

Získá nebo nastaví, zda text a obrázky jsou zobrazeny na .ToolStripItem

Dock

Získá nebo nastaví, která ToolStripItem ohraničení jsou ukotvena k nadřazeného ovládacího prvku a určuje, jak ToolStripItem se velikost změní 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ý ovládací prvek ToolStripItem 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 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í přístupový objekt klíče pro obrázek, ImageList který je zobrazen na objektu ToolStripItem.

ImageScaling

Získá nebo nastaví hodnotu urč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 tak, aby se v obrázku chýlila jako průhledná ToolStripItem .

IsDisposed

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

IsOnDropDown

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

IsOnOverflow

Získá hodnotu urč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 aktuálním 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řazený ToolStripItem objekt tohoto ToolStripItem.

Padding

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

Parent

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

Placement

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

Pressed

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

Renderer

Vrátí vykreslovací modul nadřazeného objektu ToolStrip.

RightToLeft

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

RightToLeftAutoMirrorImage

Zrcadlí automaticky ToolStripItem obrázek, pokud RightToLeft je vlastnost nastavena na Yes.

Selected

Získá hodnotu určující, zda je položka vybrána.

ShowKeyboardCues

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

Site

Získá nebo nastaví ISite objektu 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 v 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ě.

ToolTipText

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

Visible

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

Width

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

Metody

Name Description
CreateAccessibilityInstance()

Vytvoří nový objekt přístupnosti pro objekt ToolStripItem.

CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužící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 a volitelně uvolní spravované prostředky.

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

Zahájí operaci přetažení.

DoDragDrop(Object, DragDropEffects)

Zahájí operaci přetažení.

Equals(Object)

Určuje, zda je zadaný objekt roven aktuálnímu objektu.

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

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

GetHashCode()

Slouží jako výchozí funkce hash.

(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 dá ovládací prvek přizpůsobit.

GetService(Type)

Vrátí objekt, který představuje službu poskytovanou objektem Component nebo jeho Container.

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

Získá Type aktuální instance.

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

Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci.

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

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

Invalidate(Rectangle)

Zneplatní zadanou oblast ToolStripItem přidáním do oblasti ToolStripItemaktualizace , což je oblast, která bude znovu nakreslit při další operaci malování, a způsobí odeslání zprávy o malování do ToolStripItem.

IsInputChar(Char)

Určuje, zda je znak vstupním znakem, 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 Object.

(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, když se Bounds vlastnost změní.

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)

FontChanged Vyvolá událost při Font změně vlastnosti u nadřazeného objektu ToolStripItem.

OnPaint(PaintEventArgs)

Paint Vyvolá událost.

OnParentBackColorChanged(EventArgs)

BackColorChanged Vyvolá událost.

OnParentChanged(ToolStrip, ToolStrip)

ParentChanged Vyvolá událost.

OnParentEnabledChanged(EventArgs)

EnabledChanged Vyvolá událost, když Enabled se změní hodnota 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ání v kontextu OnClick(EventArgs) vyvolání Execute(Object) , pokud kontext umožňuje.

OnRightToLeftChanged(EventArgs)

RightToLeftChanged Vyvolá událost.

OnSelectedChanged(EventArgs)

SelectedChanged Vyvolá událost.

OnTextChanged(EventArgs)

TextChanged Vyvolá událost.

OnVisibleChanged(EventArgs)

VisibleChanged Vyvolá událost.

PerformClick()

Vygeneruje Click událost pro .ToolStripItem

ProcessCmdKey(Message, Keys)

Zpracovává příkazový klíč.

ProcessDialogKey(Keys)

Zpracovává klíč dialogového okna.

ProcessMnemonic(Char)

Zpracovává mnemónní 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í 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

Name Description
AvailableChanged

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

BackColorChanged

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

BindingContextChanged

Nastane, když se kontext vazby změnil.

(Zděděno od BindableComponent)
Click

Nastane po kliknutí na ToolStripItem tlačítko.

CommandCanExecuteChanged

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

CommandChanged

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

CommandParameterChanged

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

DisplayStyleChanged

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

Disposed

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

(Zděděno od Component)
DoubleClick

Nastane, když je položka poklikáním 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 vyřazena 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í přes klientskou oblast této položky.

DragOver

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

EnabledChanged

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

ForeColorChanged

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

GiveFeedback

Nastane během operace 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 zadá položku.

MouseHover

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

MouseLeave

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

MouseMove

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

MouseUp

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

OwnerChanged

Nastane, když se Owner vlastnost změní.

Paint

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

QueryAccessibilityHelp

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

QueryContinueDrag

Nastane 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, když se RightToLeft změní hodnota vlastnosti.

SelectedChanged

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

TextChanged

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

VisibleChanged

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

Explicitní implementace rozhraní

Name Description
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é