ToolStripItem Sınıf

Tanım

Veya'nın içerebileceği tüm öğeler ToolStripToolStripDropDown için olayları ve düzeni yöneten soyut temel sınıfı temsil eder.

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
Devralma
Devralma
Türetilmiş
Uygulamalar

Örnekler

Aşağıdaki kod örneğinde özel ToolStripItem denetimin nasıl uygulandığı gösterilmektedir.

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

Açıklamalar

Bir ToolStripItem , windows kısayol menüsüne benzeyen bir denetimde veya denetimde yer alan düğme ToolStrip , birleşik giriş kutusu, metin kutusu veya ToolStripDropDown etiket gibi bir öğedir. sınıfı ToolStrip , bu öğeler için sürükle ve bırak girişi de dahil olmak üzere boyama ve klavye ve fare girişini yönetir ve ToolStripItem sınıf da öğelerin içindeki olayları ve düzeni yönetir.

ToolStripItemsınıflar doğrudan öğesinden ToolStripItemdevralır veya veya ToolStripDropDownItemüzerinden dolaylı olarak ToolStripItem devralırToolStripControlHost.

ToolStripItem denetimlerinin bir ToolStrip, MenuStrip, StatusStripveya ContextMenuStrip içinde yer alması gerekir ve doğrudan forma eklenemez. Çeşitli kapsayıcı sınıfları, denetimlerin uygun bir alt kümesini ToolStripItem içerecek şekilde tasarlanmıştır.

Not Belirli ToolStripItem bir öğesinin birden fazla üst öğesi ToolStripolamaz. öğesini ToolStripItem kopyalayıp diğer ToolStrip denetimlere eklemeniz gerekir.

Aşağıdaki tabloda sınıfından türetilen ToolStripItem ve bu nedenle veya ToolStripDropDowniçinde ToolStrip barındırılabilen öğeler gösterilmektedir.

Öğe Açıklama
ToolStripButton Resimleri ve metni destekleyen bir araç çubuğu düğmesi.
ToolStripLabel Genellikle durum çubuğunda veya açıklama ya da ToolStrip başlık olarak kullanılan metin etiketi.
ToolStripSeparator Öğeleri görsel olarak gruplandıran dikey çubuklu seçilemez bir alan veya boşluk.
ToolStripControlHost , ToolStripItem , , ToolStripProgressBar, ToolStripTextBoxdiğer Windows Forms denetimlerini veya özel denetimleri barındıran ToolStripComboBoxbir.

A ToolStripComboBox , kullanıcının metin girebileceği bir metin kutusu ve kullanıcının metin kutusunu doldurmak için metin seçebileceği bir listedir.

A ToolStripTextBox , kullanıcının metin girmesini sağlar.

A ToolStripProgressBar , içinde bulunan StatusStripbir Windows ilerleme çubuğu denetimini temsil eder.
ToolStripDropDownItem , ToolStripItem ve ToolStripSplitButtonToolStripDropDownButtonbarındıran bir ToolStripMenuItem.

A ToolStripMenuItem , bir menüde veya bağlam menüsünde görüntülenen seçilebilir bir seçenektir.

A ToolStripSplitButton , normal bir düğmeyle açılan düğmenin birleşimidir.

A ToolStripDropDownButton , açılan menü işlevselliğini destekleyen bir düğmedir.
ToolStripStatusLabel Denetimdeki bir StatusStrip panel.

Oluşturucular

ToolStripItem()

ToolStripItem sınıfının yeni bir örneğini başlatır.

ToolStripItem(String, Image, EventHandler)

Belirtilen ad, görüntü ve olay işleyicisi ile sınıfının yeni bir örneğini ToolStripItem başlatır.

ToolStripItem(String, Image, EventHandler, String)

Belirtilen görüntüleme metni, görüntü, olay işleyicisi ve ad ile sınıfının yeni bir örneğini ToolStripItem başlatır.

Özellikler

AccessibilityObject

Denetime AccessibleObject atananı alır.

AccessibleDefaultActionDescription

Erişilebilirlik istemci uygulamaları tarafından kullanılmak üzere denetimin varsayılan eylem açıklamasını alır veya ayarlar.

AccessibleDescription

Erişilebilirlik istemci uygulamalarına bildirilecek açıklamayı alır veya ayarlar.

AccessibleName

Erişilebilirlik istemci uygulamaları tarafından kullanılacak denetimin adını alır veya ayarlar.

AccessibleRole

Denetimin kullanıcı arabirimi öğesinin türünü belirten erişilebilir rolünü alır veya ayarlar.

Alignment

Öğenin başlangıcına veya sonuna ToolStripdoğru hizalanıp hizalanmadığını belirten bir değer alır veya ayarlar.

AllowDrop

Sürükle ve bırak ve öğe yeniden sıralamanın uyguladığınız olaylar aracılığıyla işlenip işlenmeyeceğini belirten bir değer alır veya ayarlar.

Anchor

bağlı olduğu ToolStripItem kapsayıcının kenarlarını alır veya ayarlar ve öğesinin üst öğesiyle nasıl ToolStripItem yeniden boyutlandırıldığını belirler.

AutoSize

Öğenin otomatik olarak boyutlandırılıp boyutlandırılmadığını belirten bir değer alır veya ayarlar.

AutoToolTip

ToolTip için ToolStripItem özelliğinin mi yoksa özelliğinin TextToolTipText mi kullanılacağını belirten bir değer alır veya ayarlar.

Available

öğesinin üzerine yerleştirilip yerleştirilmeyeceğini ToolStripItem belirten bir ToolStripdeğer alır veya ayarlar.

BackColor

Öğenin arka plan rengini alır veya ayarlar.

BackgroundImage

Öğede görüntülenen arka plan görüntüsünü alır veya ayarlar.

BackgroundImageLayout

için ToolStripItemkullanılan arka plan görüntüsü düzenini alır veya ayarlar.

BindingContext

için IBindableComponentpara birimi yöneticileri koleksiyonunu alır veya ayarlar.

(Devralındığı yer: BindableComponent)
Bounds

Öğenin boyutunu ve konumunu alır.

CanRaiseEvents

Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır.

(Devralındığı yer: Component)
CanSelect

Öğenin seçilip seçilemeyeceğini belirten bir değer alır.

Command

ToolStripItem'ın Click olayı çağrıldığında yönteminin çağrılacağını alır veya ayarlar.ICommandExecute(Object)

CommandParameter

özelliğine atanan parametresine ICommand geçirilen parametreyi Command alır veya ayarlar.

Container

öğesini IContainer içeren öğesini Componentalır.

(Devralındığı yer: Component)
ContentRectangle

Metin ve simgeler gibi içeriğin arka plan kenarlıklarının üzerine yazmadan içine ToolStripItem yerleştirilebileceği alanı alır.

DataBindings

Bu IBindableComponentiçin veri bağlama nesnelerinin koleksiyonunu alır.

(Devralındığı yer: BindableComponent)
DefaultAutoToolTip

Varsayılan olarak tanımlanan öğesinin ToolTip görüntülenip görüntülenmeyeceğini belirten bir değer alır.

DefaultDisplayStyle

üzerinde ToolStripItemnelerin görüntülendiğini gösteren bir değer alır.

DefaultMargin

Öğenin varsayılan kenar boşluğunu alır.

DefaultPadding

Öğenin iç aralık özelliklerini alır.

DefaultSize

Öğenin varsayılan boyutunu alır.

DesignMode

öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır.

(Devralındığı yer: Component)
DismissWhenClicked

üzerindeki öğelerin tıklandıktan sonra gizlenip gizlenmediğini belirten bir ToolStripDropDown değer alır.

DisplayStyle

Metin ve resimlerin üzerinde ToolStripItemgörüntülenip görüntülenmeyeceğini alır veya ayarlar.

Dock

Hangi ToolStripItem kenarlıkların üst denetimine yerleştirileceğini alır veya ayarlar ve öğesinin ToolStripItem üst denetimiyle nasıl yeniden boyutlandırıldığını belirler.

DoubleClickEnabled

fareye çift tıklayarak öğesinin ToolStripItem etkinleştirilip etkinleştirilemeyeceğini belirten bir değer alır veya ayarlar.

Enabled

öğesinin üst denetiminin ToolStripItem etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.

Events

Bu Componentöğesine eklenen olay işleyicilerinin listesini alır.

(Devralındığı yer: Component)
Font

Öğe tarafından görüntülenen metnin yazı tipini alır veya ayarlar.

ForeColor

Öğenin ön plan rengini alır veya ayarlar.

Height

bir ToolStripItemöğesinin yüksekliğini piksel cinsinden alır veya ayarlar.

Image

üzerinde ToolStripItemgörüntülenen görüntüyü alır veya ayarlar.

ImageAlign

Üzerindeki görüntünün ToolStripItemhizalamasını alır veya ayarlar.

ImageIndex

Öğenin üzerinde görüntülenen görüntünün dizin değerini alır veya ayarlar.

ImageKey

üzerinde görüntülenen ToolStripItemgörüntü için anahtar erişimcisini ImageList alır veya ayarlar.

ImageScaling

üzerindeki bir görüntünün bir kapsayıcıya ToolStripItem sığacak şekilde otomatik olarak yeniden boyutlandırılıp boyutlandırılmadığını belirten bir değeri alır veya ayarlar.

ImageTransparentColor

Görüntüde ToolStripItem saydam olarak davranacak rengi alır veya ayarlar.

IsDisposed

Nesnenin atılıp atılmadığını belirten bir değer alır.

IsOnDropDown

Geçerli Control kapsayıcının bir olup olmadığını belirten bir ToolStripDropDowndeğer alır.

IsOnOverflow

özelliğinin olarak ayarlanıp ayarlanmadığını PlacementOverflowbelirten bir değer alır.

Margin

Öğeyle bitişik öğeler arasındaki boşluğu alır veya ayarlar.

MergeAction

Alt menülerin üst menülerle nasıl birleştirilmesini alır veya ayarlar.

MergeIndex

Birleştirilmiş öğenin geçerli ToolStripiçindeki konumunu alır veya ayarlar.

Name

Öğenin adını alır veya ayarlar.

Overflow

Öğenin veya öğesine eklenip ToolStrip eklenmeyeceğini ya da ToolStripOverflowButton ikisi arasında kayap kaydırılamayacağını alır veya ayarlar.

Owner

Bu öğenin sahibini alır veya ayarlar.

OwnerItem

Bu ToolStripItemöğesinin üst ToolStripItem öğesini alır.

Padding

Öğenin içeriğiyle kenarları arasındaki iç aralığı piksel cinsinden alır veya ayarlar.

Parent

öğesinin üst kapsayıcısını ToolStripItemalır veya ayarlar.

Placement

Öğenin geçerli düzenini alır.

Pressed

Öğenin durumuna basılıp basılmadığını belirten bir değer alır.

RightToLeft

Öğelerin sağdan sola yerleştirilip yerleştirilmeyeceğini ve metnin sağdan sola yazılıp yazılmayacağını belirten bir değer alır veya ayarlar.

RightToLeftAutoMirrorImage

Özelliği olarak ayarlandığında Yesgörüntüyü RightToLeft otomatik ToolStripItem olarak yansıtır.

Selected

Öğenin seçilip seçilmediğini belirten bir değer alır.

ShowKeyboardCues

Kısayol tuşlarının gösterilip gösterilmeyeceğini veya gizleneceğini belirten bir değer alır.

Site

öğesini alır veya ayarlar ISiteComponent.

(Devralındığı yer: Component)
Size

Öğenin boyutunu alır veya ayarlar.

Tag

Öğe hakkındaki verileri içeren nesneyi alır veya ayarlar.

Text

Öğede görüntülenecek metni alır veya ayarlar.

TextAlign

üzerindeki ToolStripLabelmetnin hizalamasını alır veya ayarlar.

TextDirection

üzerinde ToolStripItemkullanılan metnin yönlendirmesini alır.

TextImageRelation

Metin ve resmin birbirine göre konumunu ToolStripItem alır veya ayarlar.

ToolTipText

Denetim için olarak ToolTip görünen metni alır veya ayarlar.

Visible

Öğenin görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.

Width

piksel ToolStripItemcinsinden genişliğini alır veya ayarlar.

Yöntemler

CreateAccessibilityInstance()

için ToolStripItemyeni bir erişilebilirlik nesnesi oluşturur.

CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur.

(Devralındığı yer: MarshalByRefObject)
Dispose()

Component tarafından kullanılan tüm kaynakları serbest bırakır.

(Devralındığı yer: Component)
Dispose(Boolean)

ToolStripItem tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.

DoDragDrop(Object, DragDropEffects)

Sürükle ve bırak işlemini başlatır.

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

Sürükleme işlemini başlatır.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetCurrentParent()

ToolStrip Geçerli ToolStripItemkapsayıcısı olan öğesini alır.

GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetLifetimeService()
Geçersiz.

Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır.

(Devralındığı yer: MarshalByRefObject)
GetPreferredSize(Size)

Denetimin sığabileceği dikdörtgen bir alanın boyutunu alır.

GetService(Type)

veya tarafından ComponentContainersağlanan bir hizmeti temsil eden bir nesnesi döndürür.

(Devralındığı yer: Component)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
InitializeLifetimeService()
Geçersiz.

Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır.

(Devralındığı yer: MarshalByRefObject)
Invalidate()

tüm yüzeyini ToolStripItem geçersiz kılıp yeniden çizilmesine neden olur.

Invalidate(Rectangle)

Bir sonraki boyama işleminde yeniden boyanacak olan ve öğesine bir boya iletisi gönderilmesine ToolStripItemneden olan güncelleştirme bölgesine ToolStripItemekleyerek belirtilen bölgesini ToolStripItem geçersiz kılır.

IsInputChar(Char)

Bir karakterin, öğenin tanıdığı bir giriş karakteri olup olmadığını belirler.

IsInputKey(Keys)

Belirtilen anahtarın normal bir giriş anahtarı mı yoksa ön işleme gerektiren özel bir anahtar mı olduğunu belirler.

MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur.

(Devralındığı yer: MarshalByRefObject)
OnAvailableChanged(EventArgs)

AvailableChanged olayını tetikler.

OnBackColorChanged(EventArgs)

Olayı tetikler BackColorChanged .

OnBindingContextChanged(EventArgs)

Olayı tetikler BindingContextChanged .

(Devralındığı yer: BindableComponent)
OnBoundsChanged()

Özellik değiştiğinde Bounds gerçekleşir.

OnClick(EventArgs)

Olayı tetikler Click .

OnCommandCanExecuteChanged(EventArgs)

Olayı tetikler CommandCanExecuteChanged .

OnCommandChanged(EventArgs)

Olayı tetikler CommandChanged .

OnCommandParameterChanged(EventArgs)

Olayı tetikler CommandParameterChanged .

OnDisplayStyleChanged(EventArgs)

Olayı tetikler DisplayStyleChanged .

OnDoubleClick(EventArgs)

Olayı tetikler DoubleClick .

OnDragDrop(DragEventArgs)

Olayı tetikler DragDrop .

OnDragEnter(DragEventArgs)

Olayı tetikler DragEnter .

OnDragLeave(EventArgs)

Olayı tetikler DragLeave .

OnDragOver(DragEventArgs)

Olayı tetikler DragOver .

OnEnabledChanged(EventArgs)

Olayı tetikler EnabledChanged .

OnFontChanged(EventArgs)

Olayı tetikler FontChanged .

OnForeColorChanged(EventArgs)

Olayı tetikler ForeColorChanged .

OnGiveFeedback(GiveFeedbackEventArgs)

Olayı tetikler GiveFeedback .

OnLayout(LayoutEventArgs)

Olayı tetikler Layout .

OnLocationChanged(EventArgs)

Olayı tetikler LocationChanged .

OnMouseDown(MouseEventArgs)

Olayı tetikler MouseDown .

OnMouseEnter(EventArgs)

Olayı tetikler MouseEnter .

OnMouseHover(EventArgs)

Olayı tetikler MouseHover .

OnMouseLeave(EventArgs)

Olayı tetikler MouseLeave .

OnMouseMove(MouseEventArgs)

Olayı tetikler MouseMove .

OnMouseUp(MouseEventArgs)

Olayı tetikler MouseUp .

OnOwnerChanged(EventArgs)

Olayı tetikler OwnerChanged .

OnOwnerFontChanged(EventArgs)

özelliği öğesinin FontChanged üst öğesinde değiştiğinde olayı Font tetikler ToolStripItem.

OnPaint(PaintEventArgs)

Olayı tetikler Paint .

OnParentBackColorChanged(EventArgs)

Olayı tetikler BackColorChanged .

OnParentChanged(ToolStrip, ToolStrip)

Olayı tetikler ParentChanged .

OnParentEnabledChanged(EventArgs)

Öğenin kapsayıcısının EnabledChangedEnabled özellik değeri değiştiğinde olayı tetikler.

OnParentForeColorChanged(EventArgs)

Olayı tetikler ForeColorChanged .

OnParentRightToLeftChanged(EventArgs)

Olayı tetikler RightToLeftChanged .

OnQueryContinueDrag(QueryContinueDragEventArgs)

Olayı tetikler QueryContinueDrag .

OnRequestCommandExecute(EventArgs)

bağlamı OnClick(EventArgs) izin veriyorsa çağırmak Execute(Object) için bağlamında çağrılır.

OnRightToLeftChanged(EventArgs)

Olayı tetikler RightToLeftChanged .

OnSelectedChanged(EventArgs)

Veya'nın içerebileceği tüm öğeler ToolStripToolStripDropDown için olayları ve düzeni yöneten soyut temel sınıfı temsil eder.

OnTextChanged(EventArgs)

Olayı tetikler TextChanged .

OnVisibleChanged(EventArgs)

Olayı tetikler VisibleChanged .

PerformClick()

için ToolStripItembir Click olay oluşturur.

ProcessCmdKey(Message, Keys)

Bir komut anahtarını işler.

ProcessDialogKey(Keys)

bir iletişim kutusu anahtarını işler.

ProcessMnemonic(Char)

Bir anımsatıcı karakteri işler.

ResetBackColor()

Bu yöntem bu sınıfla ilgili değildir.

ResetDisplayStyle()

Bu yöntem bu sınıfla ilgili değildir.

ResetFont()

Bu yöntem bu sınıfla ilgili değildir.

ResetForeColor()

Bu yöntem bu sınıfla ilgili değildir.

ResetImage()

Bu yöntem bu sınıfla ilgili değildir.

ResetMargin()

Bu yöntem bu sınıfla ilgili değildir.

ResetPadding()

Bu yöntem bu sınıfla ilgili değildir.

ResetRightToLeft()

Bu yöntem bu sınıfla ilgili değildir.

ResetTextDirection()

Bu yöntem bu sınıfla ilgili değildir.

Select()

Öğeyi seçer.

SetBounds(Rectangle)

Öğenin boyutunu ve konumunu ayarlar.

SetVisibleCore(Boolean)

ToolStripItem öğesini belirtilen görünür duruma ayarlar.

ToString()

Varsa, adını Componentiçeren bir String döndürür. Bu yöntem geçersiz kılınmamalıdır.

Ekinlikler

AvailableChanged

Özelliğin değeri değiştiğinde Available gerçekleşir.

BackColorChanged

Özelliğin değeri değiştiğinde BackColor gerçekleşir.

BindingContextChanged

Bağlama bağlamı değiştiğinde gerçekleşir.

(Devralındığı yer: BindableComponent)
Click

öğesine tıklandığında ToolStripItem gerçekleşir.

CommandCanExecuteChanged

Özelliğine CanExecute(Object) atanan durumunun ICommand değişmesi Command durumunda gerçekleşir.

CommandChanged

özelliği atanan ICommand değiştiğinde Command gerçekleşir.

CommandParameterChanged

özelliğinin değeri değiştiğinde CommandParameter gerçekleşir.

DisplayStyleChanged

değiştiğinde DisplayStyle gerçekleşir.

Disposed

Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir.

(Devralındığı yer: Component)
DoubleClick

Öğeye fareyle çift tıklandığında gerçekleşir.

DragDrop

Kullanıcı bir öğeyi sürüklediğinde ve kullanıcı fare düğmesini serbest bıraktığında gerçekleşir ve bu da öğenin bu öğeye bırakılması gerektiğini belirtir.

DragEnter

Kullanıcı bir öğeyi bu öğenin istemci alanına sürüklediğinde gerçekleşir.

DragLeave

Kullanıcı bir öğeyi sürüklediğinde ve fare işaretçisi artık bu öğenin istemci alanının üzerinde olmadığında gerçekleşir.

DragOver

Kullanıcı bir öğeyi bu öğenin istemci alanının üzerine sürüklediğinde gerçekleşir.

EnabledChanged

Özellik değeri değiştiğinde Enabled gerçekleşir.

ForeColorChanged

Özellik değeri değiştiğinde ForeColor gerçekleşir.

GiveFeedback

Sürükleme işlemi sırasında oluşur.

LocationChanged

Konumu ToolStripItem güncelleştirildiğinde gerçekleşir.

MouseDown

Fare işaretçisi öğenin üzerine geldiğinde ve fare düğmesine basıldığında gerçekleşir.

MouseEnter

Fare işaretçisi öğeye girdiğinde gerçekleşir.

MouseHover

Fare işaretçisi öğenin üzerine geldiğinde gerçekleşir.

MouseLeave

Fare işaretçisi öğeden ayrıldığında gerçekleşir.

MouseMove

Fare işaretçisi öğenin üzerine taşındığında gerçekleşir.

MouseUp

Fare işaretçisi öğenin üzerine geldiğinde ve fare düğmesi serbest bırakıldığında gerçekleşir.

OwnerChanged

Özellik değiştiğinde Owner gerçekleşir.

Paint

Öğe yeniden çizildiğinde gerçekleşir.

QueryAccessibilityHelp

Erişilebilirlik istemci uygulaması için ToolStripItemyardım çağırdığında gerçekleşir.

QueryContinueDrag

Sürükle ve bırak işlemi sırasında gerçekleşir ve sürükleme kaynağının sürükleyip bırakma işleminin iptal edilip edilmeyeceğini belirlemesine olanak tanır.

RightToLeftChanged

Özellik değeri değiştiğinde RightToLeft gerçekleşir.

SelectedChanged

Veya'nın içerebileceği tüm öğeler ToolStripToolStripDropDown için olayları ve düzeni yöneten soyut temel sınıfı temsil eder.

TextChanged

Özelliğin değeri değiştiğinde Text gerçekleşir.

VisibleChanged

Özelliğin değeri değiştiğinde Visible gerçekleşir.

Belirtik Arabirim Kullanımları

IDropTarget.OnDragDrop(DragEventArgs)

Olayı tetikler DragDrop .

IDropTarget.OnDragEnter(DragEventArgs)

Olayı tetikler DragEnter .

IDropTarget.OnDragLeave(EventArgs)

Olayı tetikler DragLeave .

IDropTarget.OnDragOver(DragEventArgs)

Olayı tetikler DragOver .

Şunlara uygulanır

Ayrıca bkz.