ToolStripItem Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt die abstrakte Basisklasse dar, die Ereignisse und Layout für alle Elemente verwaltet, die ein ToolStrip oder ein ToolStripDropDown enthalten kann.
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
- Vererbung
- Vererbung
- Abgeleitet
- Implementiert
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie ein benutzerdefiniertes ToolStripItem Steuerelement implementiert wird.
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
Hinweise
A ToolStripItem ist ein Element wie eine Schaltfläche, ein Kombinationsfeld, ein Textfeld oder eine Bezeichnung, die in einem ToolStrip Steuerelement oder einem ToolStripDropDown Steuerelement enthalten sein kann, was einem Windows-Kontextmenü ähnelt. Die ToolStrip -Klasse verwaltet die Mal- und Tastatur- und Mauseingaben, einschließlich Drag-and-Drop-Eingaben, für diese Elemente, und die ToolStripItem Klasse verwaltet Ereignisse und das Layout innerhalb der Elemente selbst.
ToolStripItem-Klassen erben entweder direkt von ToolStripItem oder indirekt von ToolStripItem über ToolStripControlHost oder ToolStripDropDownItem.
ToolStripItem-Steuerelemente müssen in einem ToolStrip, MenuStrip, StatusStrip oder ContextMenuStrip enthalten sein und können nicht direkt zu einem Formular hinzugefügt werden. Die verschiedenen Containerklassen sind so konzipiert, dass sie eine entsprechende Teilmenge von ToolStripItem-Steuerelementen enthalten.
Hinweis Ein gegebener ToolStripItem darf nicht mehr als ein übergeordnetes Element ToolStripaufweisen. Sie müssen den ToolStripItem kopieren und anderen ToolStrip Steuerelementen hinzufügen.
Die folgende Tabelle zeigt die Von der ToolStripItem -Klasse abgeleiteten Elemente, die daher in einer ToolStrip oder ToolStripDropDowngehostet werden können.
Element | Beschreibung |
---|---|
ToolStripButton | Eine Symbolleistenschaltfläche, die Bilder und Text unterstützt. |
ToolStripLabel | Eine Textbezeichnung, die in der Regel in einer status leiste oder ToolStrip als Kommentar oder Titel verwendet wird. |
ToolStripSeparator | Ein nicht auswählbarer Raum mit einem vertikalen Balken, der Elemente visuell gruppiert. |
ToolStripControlHost | EineToolStripItem, die ein ToolStripComboBox, ToolStripTextBox, ToolStripProgressBar, andere Windows Forms-Steuerelemente oder benutzerdefinierte Steuerelemente hostet. A ToolStripComboBox ist ein Textfeld, in das der Benutzer Text eingeben kann, zusammen mit einer Liste, aus der der Benutzer Text auswählen kann, um das Textfeld zu füllen. Ein ToolStripTextBox ermöglicht dem Benutzer die Eingabe von Text. Ein ToolStripProgressBar stellt ein Windows-Statusleistensteuerelement dar, das in einem StatusStripenthalten ist. |
ToolStripDropDownItem | Eine ToolStripItem , die ein ToolStripMenuItem, ToolStripSplitButtonund ToolStripDropDownButtonhostet. A ToolStripMenuItem ist eine auswählbare Option, die in einem Menü oder Kontextmenü angezeigt wird. A ToolStripSplitButton ist eine Kombination aus einer regulären Schaltfläche und einer Dropdownschaltfläche. A ToolStripDropDownButton ist eine Schaltfläche, die Dropdownfunktionen unterstützt. |
ToolStripStatusLabel | Ein Bereich in einem StatusStrip Steuerelement. |
Konstruktoren
ToolStripItem() |
Initialisiert eine neue Instanz der ToolStripItem-Klasse. |
ToolStripItem(String, Image, EventHandler) |
Initialisiert eine neue Instanz der ToolStripItem-Klasse mit dem angegebenen Namen, Bild und Ereignishandler. |
ToolStripItem(String, Image, EventHandler, String) |
Initialisiert eine neue Instanz der ToolStripItem-Klasse mit dem angegebenen Anzeigetext, dem angegebenen Bild, dem angegebenen Ereignishandler und dem angegebenen Namen. |
Eigenschaften
AccessibilityObject |
Ruft das dem Steuerelement zugewiesene AccessibleObject ab. |
AccessibleDefaultActionDescription |
Ruft die Standardbeschreibung der Aktion des Steuerelements ab, das von Clientanwendungen für Barrierefreiheit verwendet wird, oder legt diese fest. |
AccessibleDescription |
Ruft die Beschreibung ab, die an Clientanwendungen für die Barrierefreiheit gesendet wird, oder legt diese fest. |
AccessibleName |
Ruft den Namen des Steuerelements für die Verwendung durch Clientanwendungen für die Barrierefreiheit ab oder legt diesen fest. |
AccessibleRole |
Ruft die barrierefreie Rolle des Steuerelements ab, die den Typ des Benutzeroberflächenelements des Steuerelements angibt, oder legt diese fest. |
Alignment |
Ruft einen Wert ab, der angibt, ob das Element am Anfang oder am Ende des ToolStrip ausgerichtet wird, oder legt diesen Wert fest. |
AllowDrop |
Ruft einen Wert ab, der angibt, ob Drag & Drop und die Neuordnung von Elementen über von Ihnen implementierte Ereignisse behandelt werden, oder legt diesen Wert fest. |
Anchor |
Ruft die Ränder des Containers ab, an die ein ToolStripItem-Objekt gebunden ist, oder legt diese fest und bestimmt, wie die Größe des ToolStripItem-Objekts mit dessen übergeordnetem Element geändert wird. |
AutoSize |
Ruft einen Wert ab, der angibt, ob die Größe des Elements automatisch festgelegt wird, oder legt diesen Wert fest. |
AutoToolTip |
Ruft einen Wert ab, der angibt, ob die Text-Eigenschaft oder die ToolTipText-Eigenschaft für die ToolStripItem-QuickInfo verwendet wird, oder legt diesen Wert fest. |
Available |
Ruft einen Wert ab, der angibt, ob das ToolStripItem auf einen ToolStrip platziert werden soll, oder legt diesen Wert fest. |
BackColor |
Ruft die Hintergrundfarbe für das Element ab oder legt diese fest. |
BackgroundImage |
Ruft das im Element angezeigte Hintergrundbild ab oder legt dieses fest. |
BackgroundImageLayout |
Ruft das Hintergrundbildlayout für das ToolStripItem ab oder legt dieses fest. |
BindingContext |
Ruft die Auflistung von CurrencyManager-Objekten für die IBindableComponent ab oder legt diese fest. (Geerbt von BindableComponent) |
Bounds |
Ruft die Größe und Position des Elements ab. |
CanRaiseEvents |
Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component) |
CanSelect |
Ruft einen Wert ab, der angibt, ob das Element ausgewählt werden kann. |
Command |
Ruft die ICommand ab, deren Execute(Object) Methode aufgerufen wird, wenn das ToolStripItem-Ereignis aufgerufen wird, oder legt diesen Click fest. |
CommandParameter |
Ruft den Parameter ab, der an den übergeben wird, der ICommand der Command -Eigenschaft zugewiesen ist, oder legt diesen fest. |
Container |
Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component) |
ContentRectangle |
Ruft den Bereich ab, in dem Inhalte, z. B. Text und Symbole, in einem ToolStripItem platziert werden können, ohne dass Hintergrundrahmen überschrieben werden. |
DataBindings |
Ruft die Auflistung der Datenbindungsobjekte für diese IBindableComponent ab. (Geerbt von BindableComponent) |
DefaultAutoToolTip |
Ruft einen Wert ab, der angibt, ob der als Standard definierte ToolTip angezeigt wird. |
DefaultDisplayStyle |
Ruft einen Wert ab, der angibt, was auf dem ToolStripItem angezeigt wird. |
DefaultMargin |
Ruft den Standardrand eines Elements ab. |
DefaultPadding |
Ruft die internen Abstandseigenschaften des Elements ab. |
DefaultSize |
Ruft die Standardgröße des Elements ab. |
DesignMode |
Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component) |
DismissWhenClicked |
Ruft einen Wert ab, der angibt, ob Elemente auf einem ToolStripDropDown ausgeblendet werden, nachdem auf sie geklickt wurde. |
DisplayStyle |
Ruft einen Wert ab, der angibt, ob Text und Bilder auf einem ToolStripItem angezeigt werden, oder legt diesen Wert fest. |
Dock |
Ruft ab oder legt fest, welche ToolStripItem-Rahmen am übergeordneten Steuerelement angedockt sind, und bestimmt, wie die Größe eines ToolStripItem mit dem übergeordneten Steuerelement geändert wird. |
DoubleClickEnabled |
Ruft einen Wert ab, der angibt, ob ToolStripItem durch einen doppelten Mausklick aktiviert werden kann, oder legt diesen Wert fest. |
Enabled |
Ruft einen Wert ab, der angibt, ob das übergeordnete Steuerelement des ToolStripItem aktiviert ist, oder legt diesen Wert fest. |
Events |
Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component) |
Font |
Ruft die Schriftart des angezeigten Elementtexts ab oder legt diese fest. |
ForeColor |
Ruft die Vordergrundfarbe des Elements ab oder legt diese fest. |
Height |
Ruft die Höhe eines ToolStripItem in Pixel ab oder legt diese fest. |
Image |
Ruft das in ToolStripItem dargestellte Bild ab oder legt dieses fest. |
ImageAlign |
Ruft die Ausrichtung des Bilds in einem ToolStripItem ab oder legt diese fest. |
ImageIndex |
Ruft den Indexwert des Bilds ab, das im Element angezeigt wird, oder legt diesen fest. |
ImageKey |
Ruft einen Schlüsselaccessor für das Bild in der ImageList ab, die in einem ToolStripItem angezeigt wird, oder legt diesen fest. |
ImageScaling |
Ruft einen Wert ab, der angibt, ob die Größe eines Bilds auf einem ToolStripItem automatisch geändert wird, damit es in einen Container passt, oder legt diesen Wert fest. |
ImageTransparentColor |
Ruft die in einem ToolStripItem-Bild als transparent zu behandelnde Farbe ab oder legt diese fest. |
IsDisposed |
Ruft einen Wert ab, der angibt, ob das Objekt freigegeben wurde. |
IsOnDropDown |
Ruft einen Wert ab, der angibt, ob der Container des aktuellen Control ein ToolStripDropDown ist. |
IsOnOverflow |
Ruft einen Wert ab, der angibt, ob die Placement-Eigenschaft auf Overflow festgelegt ist. |
Margin |
Ruft den Abstand zwischen dem Element und angrenzenden Elementen ab oder legt ihn fest. |
MergeAction |
Ruft ab oder legt fest, wie untergeordnete Menüs mit übergeordneten Menüs zusammengeführt werden. |
MergeIndex |
Ruft die Position eines zusammengeführten Elements im aktuellen ToolStrip ab oder legt sie fest. |
Name |
Ruft den Namen des Elements ab oder legt diesen fest. |
Overflow |
Ruft einen Wert ab, der angibt, ob das Element an den ToolStrip oder den ToolStripOverflowButton angefügt wird bzw. ob es sich dazwischen befinden kann, oder legt diesen Wert fest. |
Owner |
Ruft den Besitzer dieses Elements ab oder legt ihn fest. |
OwnerItem |
Ruft das übergeordnete ToolStripItem dieses ToolStripItem ab. |
Padding |
Ruft den internen Abstand zwischen dem Inhalt des Elements und seinen Rändern in Pixel ab oder legt den Abstand fest. |
Parent |
Ruft den übergeordneten Container des ToolStripItem ab oder legt diesen fest. |
Placement |
Ruft das aktuelle Layout des Elements ab. |
Pressed |
Ruft einen Wert ab, der angibt, ob sich das Element in einem gedrückten Zustand befindet. |
Renderer |
Stellt die abstrakte Basisklasse dar, die Ereignisse und Layout für alle Elemente verwaltet, die ein ToolStrip oder ein ToolStripDropDown enthalten kann. |
RightToLeft |
Ruft einen Wert ab, der angibt, ob Elemente von rechts nach links platziert und Texte von rechts nach links geschrieben werden sollen, oder legt diesen Wert fest. |
RightToLeftAutoMirrorImage |
Spiegelt das ToolStripItem-Bild automatisch, wenn die RightToLeft-Eigenschaft auf Yes festgelegt ist. |
Selected |
Ruft einen Wert ab, der angibt, ob das Element ausgewählt ist. |
ShowKeyboardCues |
Ruft einen Wert ab, der angibt, ob Tastenkombinationen angezeigt oder ausgeblendet werden. |
Site |
Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component) |
Size |
Ruft die Größe des Elements ab oder legt diese fest. |
Tag |
Ruft das Objekt ab, das Daten zum Element enthält, oder legt es fest. |
Text |
Ruft den Text ab, der auf dem Element angezeigt werden soll, oder legt ihn fest. |
TextAlign |
Ruft die Ausrichtung des Texts in einem ToolStripLabel ab oder legt diese fest. |
TextDirection |
Ruft die Ausrichtung des auf ein ToolStripItem angewendeten Texts ab. |
TextImageRelation |
Ruft die Position von Text und Bild eines ToolStripItem im Verhältnis zueinander ab oder legt diese fest. |
ToolTipText |
Ruft den Text ab, der als ToolTip für ein Steuerelement angezeigt wird, oder legt diesen fest. |
Visible |
Ruft einen Wert ab, der angibt, ob das Element angezeigt wird, oder legt diesen fest. |
Width |
Ruft die Breite eines ToolStripItem in Pixel ab oder legt diese fest. |
Methoden
CreateAccessibilityInstance() |
Erstellt ein neues Objekt für die Barrierefreiheit für den ToolStripItem. |
CreateObjRef(Type) |
Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject) |
Dispose() |
Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component) |
Dispose(Boolean) |
Gibt die von ToolStripItem verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. |
DoDragDrop(Object, DragDropEffects) |
Beginnt einen Drag & Drop-Vorgang. |
DoDragDrop(Object, DragDropEffects, Bitmap, Point, Boolean) |
Startet einen Ziehvorgang. |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetCurrentParent() |
Ruft den ToolStrip ab, der den Container des aktuellen ToolStripItem darstellt. |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
GetPreferredSize(Size) |
Ruft die Größe eines rechteckigen Bereichs ab, in den ein Steuerelement eingefügt werden kann. |
GetService(Type) |
Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject) |
Invalidate() |
Erklärt die ganze Oberfläche des ToolStripItem für ungültig und bewirkt, dass es neu gezeichnet wird. |
Invalidate(Rectangle) |
Erklärt den angegebenen Bereich des ToolStripItem für ungültig, indem es diesen dem Aktualisierungsbereich des ToolStripItem hinzufügt. Dies ist der Bereich, der beim nächsten Zeichnungsvorgang neu gezeichnet wird. Außerdem wird veranlasst, dass eine Zeichnungsmeldung an das ToolStripItem gesendet wird. |
IsInputChar(Char) |
Bestimmt, ob ein Zeichen ein vom Element erkanntes Eingabezeichen ist. |
IsInputKey(Keys) |
Bestimmt, ob es sich bei der angegebenen Taste um eine normale Eingabetaste handelt oder um eine Sondertaste, für die eine Vorverarbeitung erforderlich ist. |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject) |
OnAvailableChanged(EventArgs) |
Löst das AvailableChanged-Ereignis aus. |
OnBackColorChanged(EventArgs) |
Löst das BackColorChanged-Ereignis aus. |
OnBindingContextChanged(EventArgs) |
Löst das BindingContextChanged-Ereignis aus. (Geerbt von BindableComponent) |
OnBoundsChanged() |
Tritt ein, wenn sich die Bounds-Eigenschaft ändert. |
OnClick(EventArgs) |
Löst das Click-Ereignis aus. |
OnCommandCanExecuteChanged(EventArgs) |
Löst das CommandCanExecuteChanged-Ereignis aus. |
OnCommandChanged(EventArgs) |
Löst das CommandChanged-Ereignis aus. |
OnCommandParameterChanged(EventArgs) |
Löst das CommandParameterChanged-Ereignis aus. |
OnDisplayStyleChanged(EventArgs) |
Löst das DisplayStyleChanged-Ereignis aus. |
OnDoubleClick(EventArgs) |
Löst das DoubleClick-Ereignis aus. |
OnDragDrop(DragEventArgs) |
Löst das DragDrop-Ereignis aus. |
OnDragEnter(DragEventArgs) |
Löst das DragEnter-Ereignis aus. |
OnDragLeave(EventArgs) |
Löst das DragLeave-Ereignis aus. |
OnDragOver(DragEventArgs) |
Löst das DragOver-Ereignis aus. |
OnEnabledChanged(EventArgs) |
Löst das EnabledChanged-Ereignis aus. |
OnFontChanged(EventArgs) |
Löst das FontChanged-Ereignis aus. |
OnForeColorChanged(EventArgs) |
Löst das ForeColorChanged-Ereignis aus. |
OnGiveFeedback(GiveFeedbackEventArgs) |
Löst das GiveFeedback-Ereignis aus. |
OnLayout(LayoutEventArgs) |
Löst das Layout-Ereignis aus. |
OnLocationChanged(EventArgs) |
Löst das LocationChanged-Ereignis aus. |
OnMouseDown(MouseEventArgs) |
Löst das MouseDown-Ereignis aus. |
OnMouseEnter(EventArgs) |
Löst das MouseEnter-Ereignis aus. |
OnMouseHover(EventArgs) |
Löst das MouseHover-Ereignis aus. |
OnMouseLeave(EventArgs) |
Löst das MouseLeave-Ereignis aus. |
OnMouseMove(MouseEventArgs) |
Löst das MouseMove-Ereignis aus. |
OnMouseUp(MouseEventArgs) |
Löst das MouseUp-Ereignis aus. |
OnOwnerChanged(EventArgs) |
Löst das OwnerChanged-Ereignis aus. |
OnOwnerFontChanged(EventArgs) |
Löst das FontChanged-Ereignis aus, wenn sich die Font-Eigenschaft auf dem übergeordneten Element des ToolStripItem geändert hat. |
OnPaint(PaintEventArgs) |
Löst das Paint-Ereignis aus. |
OnParentBackColorChanged(EventArgs) |
Löst das BackColorChanged-Ereignis aus. |
OnParentChanged(ToolStrip, ToolStrip) |
Löst das ParentChanged-Ereignis aus. |
OnParentEnabledChanged(EventArgs) |
Löst das EnabledChanged-Ereignis aus, wenn sich der Enabled-Eigenschaftswert des Containers ändert, zu dem das Element gehört. |
OnParentForeColorChanged(EventArgs) |
Löst das ForeColorChanged-Ereignis aus. |
OnParentRightToLeftChanged(EventArgs) |
Löst das RightToLeftChanged-Ereignis aus. |
OnQueryContinueDrag(QueryContinueDragEventArgs) |
Löst das QueryContinueDrag-Ereignis aus. |
OnRequestCommandExecute(EventArgs) |
Wird im Kontext von OnClick(EventArgs) aufgerufen, um aufzurufen Execute(Object) , wenn der Kontext dies zulässt. |
OnRightToLeftChanged(EventArgs) |
Löst das RightToLeftChanged-Ereignis aus. |
OnSelectedChanged(EventArgs) |
Stellt die abstrakte Basisklasse dar, die Ereignisse und Layout für alle Elemente verwaltet, die ein ToolStrip oder ein ToolStripDropDown enthalten kann. |
OnTextChanged(EventArgs) |
Löst das TextChanged-Ereignis aus. |
OnVisibleChanged(EventArgs) |
Löst das VisibleChanged-Ereignis aus. |
PerformClick() |
Generiert ein |
ProcessCmdKey(Message, Keys) |
Verarbeitet eine Befehlstaste. |
ProcessDialogKey(Keys) |
Verarbeitet eine Tastatureingabe im Dialogfeld. |
ProcessMnemonic(Char) |
Verarbeitet ein mnemonisches Zeichen. |
ResetBackColor() |
Diese Methode ist für diese Klasse nicht relevant. |
ResetDisplayStyle() |
Diese Methode ist für diese Klasse nicht relevant. |
ResetFont() |
Diese Methode ist für diese Klasse nicht relevant. |
ResetForeColor() |
Diese Methode ist für diese Klasse nicht relevant. |
ResetImage() |
Diese Methode ist für diese Klasse nicht relevant. |
ResetMargin() |
Diese Methode ist für diese Klasse nicht relevant. |
ResetPadding() |
Diese Methode ist für diese Klasse nicht relevant. |
ResetRightToLeft() |
Diese Methode ist für diese Klasse nicht relevant. |
ResetTextDirection() |
Diese Methode ist für diese Klasse nicht relevant. |
Select() |
Wählt das Element aus. |
SetBounds(Rectangle) |
Legt die Größe und Position des Elements fest. |
SetVisibleCore(Boolean) |
Legt die ToolStripItem auf den angegebenen sichtbaren Zustand fest. |
ToString() |
Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden. |
Ereignisse
AvailableChanged |
Tritt auf, wenn sich der Wert der Available-Eigenschaft ändert. |
BackColorChanged |
Tritt auf, wenn sich der Wert der BackColor-Eigenschaft ändert. |
BindingContextChanged |
Tritt auf, wenn sich der Bindungskontext geändert hat. (Geerbt von BindableComponent) |
Click |
Tritt ein, wenn auf das ToolStripItem geklickt wird. |
CommandCanExecuteChanged |
Tritt auf, wenn sich die CanExecute(Object) status des ICommand geändert hat, das der Command -Eigenschaft zugewiesen ist. |
CommandChanged |
Tritt auf, wenn sich die zugewiesene ICommand der Command Eigenschaft geändert hat. |
CommandParameterChanged |
Tritt ein, wenn sich der Wert der CommandParameter-Eigenschaft geändert hat. |
DisplayStyleChanged |
Tritt ein, wenn der DisplayStyle geändert wurde. |
Disposed |
Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component) |
DoubleClick |
Tritt ein, wenn mit der Maus auf das Element doppelgeklickt wird. |
DragDrop |
Tritt ein, wenn der Benutzer ein Element mit dem Mauszeiger zieht und die Maustaste loslässt, womit angegeben wird, dass das eine Element auf einem anderen Element abgelegt werden soll. |
DragEnter |
Tritt ein, wenn der Benutzer ein Element in den Clientbereich dieses Elements zieht. |
DragLeave |
Tritt ein, wenn der Benutzer ein Element zieht und der Mauszeiger sich nicht mehr im Clientbereich dieses Elements befindet. |
DragOver |
Tritt ein, wenn der Benutzer ein Element über den Clientbereich dieses Elements zieht. |
EnabledChanged |
Tritt ein, wenn der Enabled-Eigenschaftswert geändert wurde. |
ForeColorChanged |
Tritt ein, wenn der ForeColor-Eigenschaftswert geändert wird. |
GiveFeedback |
Tritt während eines Ziehvorgangs ein. |
LocationChanged |
Tritt ein, wenn die Position eines ToolStripItem aktualisiert wird. |
MouseDown |
Tritt ein, wenn sich der Mauszeiger über dem Element befindet und eine Maustaste gedrückt wird. |
MouseEnter |
Tritt ein, wenn der Mauszeiger in den Bereich des Elements bewegt wird. |
MouseHover |
Tritt ein, wenn mit dem Mauszeiger auf das Element gezeigt wird. |
MouseLeave |
Tritt ein, wenn der Mauszeiger den Bereich des Elements verlässt. |
MouseMove |
Tritt ein, wenn der Mauszeiger über dem Element bewegt wird. |
MouseUp |
Tritt ein, wenn sich der Mauszeiger über dem Element befindet und eine Maustaste losgelassen wird. |
OwnerChanged |
Tritt ein, wenn sich die Owner-Eigenschaft ändert. |
Paint |
Tritt ein, wenn das Element neu gezeichnet wird. |
QueryAccessibilityHelp |
Tritt ein, wenn eine Clientanwendung für die Barrierefreiheit die Hilfe für das ToolStripItem aufruft. |
QueryContinueDrag |
Tritt während eines Drag & Drop-Vorgangs ein. Dadurch kann die Quelle des Ziehvorgangs bestimmen, ob der Drag & Drop-Vorgang abgebrochen werden soll. |
RightToLeftChanged |
Tritt ein, wenn der RightToLeft-Eigenschaftswert geändert wird. |
SelectedChanged |
Stellt die abstrakte Basisklasse dar, die Ereignisse und Layout für alle Elemente verwaltet, die ein ToolStrip oder ein ToolStripDropDown enthalten kann. |
TextChanged |
Tritt auf, wenn sich der Wert der Text-Eigenschaft ändert. |
VisibleChanged |
Tritt auf, wenn sich der Wert der Visible-Eigenschaft ändert. |
Explizite Schnittstellenimplementierungen
IDropTarget.OnDragDrop(DragEventArgs) |
Löst das DragDrop-Ereignis aus. |
IDropTarget.OnDragEnter(DragEventArgs) |
Löst das DragEnter-Ereignis aus. |
IDropTarget.OnDragLeave(EventArgs) |
Löst das DragLeave-Ereignis aus. |
IDropTarget.OnDragOver(DragEventArgs) |
Löst das |
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für