ToolStripItem Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 |
| 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) |
|