ToolStripDropDownMenu 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供 ContextMenuStrip 控制項的基本功能。
public ref class ToolStripDropDownMenu : System::Windows::Forms::ToolStripDropDown
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class ToolStripDropDownMenu : System.Windows.Forms.ToolStripDropDown
public class ToolStripDropDownMenu : System.Windows.Forms.ToolStripDropDown
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ToolStripDropDownMenu = class
inherit ToolStripDropDown
type ToolStripDropDownMenu = class
inherit ToolStripDropDown
Public Class ToolStripDropDownMenu
Inherits ToolStripDropDown
- 繼承
-
ToolStripDropDownMenu
- 衍生
- 屬性
範例
下列程式碼範例示範如何藉由設定檢查和影像邊界來建立和初始化 ContextMenuStrip 控制項。
重要
此程式碼不是完整的範例,因此不會編譯。 如需完整的程式代碼清單,請參閱 How to: Enable Check Margins and Image Margins in CoNtextMenuStrip Controls。
public Form5()
{
// Size the form to show three wide menu items.
this.Width = 500;
this.Text = "ToolStripContextMenuStrip: Image and Check Margins";
// Create a new MenuStrip control.
MenuStrip ms = new MenuStrip();
// Create the ToolStripMenuItems for the MenuStrip control.
ToolStripMenuItem bothMargins = new ToolStripMenuItem("BothMargins");
ToolStripMenuItem imageMarginOnly = new ToolStripMenuItem("ImageMargin");
ToolStripMenuItem checkMarginOnly = new ToolStripMenuItem("CheckMargin");
ToolStripMenuItem noMargins = new ToolStripMenuItem("NoMargins");
// Customize the DropDowns menus.
// This ToolStripMenuItem has an image margin
// and a check margin.
bothMargins.DropDown = CreateCheckImageContextMenuStrip();
((ContextMenuStrip)bothMargins.DropDown).ShowImageMargin = true;
((ContextMenuStrip)bothMargins.DropDown).ShowCheckMargin = true;
// This ToolStripMenuItem has only an image margin.
imageMarginOnly.DropDown = CreateCheckImageContextMenuStrip();
((ContextMenuStrip)imageMarginOnly.DropDown).ShowImageMargin = true;
((ContextMenuStrip)imageMarginOnly.DropDown).ShowCheckMargin = false;
// This ToolStripMenuItem has only a check margin.
checkMarginOnly.DropDown = CreateCheckImageContextMenuStrip();
((ContextMenuStrip)checkMarginOnly.DropDown).ShowImageMargin = false;
((ContextMenuStrip)checkMarginOnly.DropDown).ShowCheckMargin = true;
// This ToolStripMenuItem has no image and no check margin.
noMargins.DropDown = CreateCheckImageContextMenuStrip();
((ContextMenuStrip)noMargins.DropDown).ShowImageMargin = false;
((ContextMenuStrip)noMargins.DropDown).ShowCheckMargin = false;
// Populate the MenuStrip control with the ToolStripMenuItems.
ms.Items.Add(bothMargins);
ms.Items.Add(imageMarginOnly);
ms.Items.Add(checkMarginOnly);
ms.Items.Add(noMargins);
// Dock the MenuStrip control to the top of the form.
ms.Dock = DockStyle.Top;
// Add the MenuStrip control to the controls collection last.
// This is important for correct placement in the z-order.
this.Controls.Add(ms);
}
Public Sub New()
' Size the form to show three wide menu items.
Me.Width = 500
Me.Text = "ToolStripContextMenuStrip: Image and Check Margins"
' Create a new MenuStrip control.
Dim ms As New MenuStrip()
' Create the ToolStripMenuItems for the MenuStrip control.
Dim bothMargins As New ToolStripMenuItem("BothMargins")
Dim imageMarginOnly As New ToolStripMenuItem("ImageMargin")
Dim checkMarginOnly As New ToolStripMenuItem("CheckMargin")
Dim noMargins As New ToolStripMenuItem("NoMargins")
' Customize the DropDowns menus.
' This ToolStripMenuItem has an image margin
' and a check margin.
bothMargins.DropDown = CreateCheckImageContextMenuStrip()
CType(bothMargins.DropDown, ContextMenuStrip).ShowImageMargin = True
CType(bothMargins.DropDown, ContextMenuStrip).ShowCheckMargin = True
' This ToolStripMenuItem has only an image margin.
imageMarginOnly.DropDown = CreateCheckImageContextMenuStrip()
CType(imageMarginOnly.DropDown, ContextMenuStrip).ShowImageMargin = True
CType(imageMarginOnly.DropDown, ContextMenuStrip).ShowCheckMargin = False
' This ToolStripMenuItem has only a check margin.
checkMarginOnly.DropDown = CreateCheckImageContextMenuStrip()
CType(checkMarginOnly.DropDown, ContextMenuStrip).ShowImageMargin = False
CType(checkMarginOnly.DropDown, ContextMenuStrip).ShowCheckMargin = True
' This ToolStripMenuItem has no image and no check margin.
noMargins.DropDown = CreateCheckImageContextMenuStrip()
CType(noMargins.DropDown, ContextMenuStrip).ShowImageMargin = False
CType(noMargins.DropDown, ContextMenuStrip).ShowCheckMargin = False
' Populate the MenuStrip control with the ToolStripMenuItems.
ms.Items.Add(bothMargins)
ms.Items.Add(imageMarginOnly)
ms.Items.Add(checkMarginOnly)
ms.Items.Add(noMargins)
' Dock the MenuStrip control to the top of the form.
ms.Dock = DockStyle.Top
' Add the MenuStrip control to the controls collection last.
' This is important for correct placement in the z-order.
Me.Controls.Add(ms)
End Sub
備註
ToolStripDropDownMenu 是 的 ContextMenuStrip 基類,提供必要的繪製和版面配置屬性和方法。 您最可能直接使用的這個類別屬性是 ShowCheckMargin 和 ShowImageMargin 屬性,可決定快捷方式功能表是否能夠顯示核取記號、影像或兩者。
ToolStripDropDownMenu 和 取代 ToolStripDropDown 並擴充 .NET Core 3.1 中移除的 Menu 控制項。
建構函式
ToolStripDropDownMenu() |
初始化 ToolStripDropDownMenu 類別的新執行個體。 |
欄位
ScrollStateAutoScrolling |
判斷 AutoScroll 屬性值。 (繼承來源 ScrollableControl) |
ScrollStateFullDrag |
判斷使用者是否已啟用完整的視窗拖曳。 (繼承來源 ScrollableControl) |
ScrollStateHScrollVisible |
判斷 HScroll 屬性值是否設定為 |
ScrollStateUserHasScrolled |
判斷使用者是否已捲動 ScrollableControl 控制項。 (繼承來源 ScrollableControl) |
ScrollStateVScrollVisible |
判斷 VScroll 屬性值是否設定為 |
屬性
AccessibilityObject |
取得指定給控制項的 AccessibleObject。 (繼承來源 Control) |
AccessibleDefaultActionDescription |
取得或設定協助用戶端應用程式所使用的控制項的預設動作描述。 (繼承來源 Control) |
AccessibleDescription |
取得或設定協助工具用戶端應用程式使用之控制項的描述。 (繼承來源 Control) |
AccessibleName |
取得或設定協助工具用戶端應用程式使用的控制項名稱。 (繼承來源 Control) |
AccessibleRole |
取得或設定控制項的可存取角色。 (繼承來源 Control) |
AllowClickThrough |
提供 ContextMenuStrip 控制項的基本功能。 (繼承來源 ToolStrip) |
AllowDrop |
取得或設定值,指出拖放和項目的重新排列是否透過您實作的事件來加以處理。 (繼承來源 ToolStrip) |
AllowItemReorder |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
AllowMerge |
取得或設定值,表示是否可以結合多個 MenuStrip、ToolStripDropDownMenu、ToolStripMenuItem 和其他類型。 (繼承來源 ToolStrip) |
AllowTransparency |
取得或設定值,指出是否可調整表單的 Opacity。 (繼承來源 ToolStripDropDown) |
Anchor |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
AutoClose |
取得或設定值,指出當 ToolStripDropDown 控制項不再啟動時,是否應該自動關閉。 (繼承來源 ToolStripDropDown) |
AutoScroll |
這個屬性與這個類別無關。 (繼承來源 ToolStrip) |
AutoScrollMargin |
這個屬性與這個類別無關。 (繼承來源 ToolStrip) |
AutoScrollMinSize |
這個屬性與這個類別無關。 (繼承來源 ToolStrip) |
AutoScrollOffset |
取得或設定此控制項在 ScrollControlIntoView(Control) 中要捲動到哪一個位置。 (繼承來源 Control) |
AutoScrollPosition |
這個屬性與這個類別無關。 (繼承來源 ToolStrip) |
AutoSize |
取得或設定值,指出當調整表單的大小時,ToolStripDropDown 是否會自動調整其大小。 (繼承來源 ToolStripDropDown) |
BackColor |
取得或設定 ToolStrip 的背景色彩。 (繼承來源 ToolStrip) |
BackgroundImage |
取得或設定在控制項中顯示的背景影像。 (繼承來源 Control) |
BackgroundImageLayout |
取得或設定在 ImageLayout 列舉類型中所定義的背景影像配置。 (繼承來源 Control) |
BindingContext |
取得或設定 ToolStrip 的繫結內容。 (繼承來源 ToolStrip) |
Bottom |
取得控制項下邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
Bounds |
取得或設定控制項 (包括其非工作區項目) 相對於父控制項之大小和位置 (單位為像素)。 (繼承來源 Control) |
CanEnableIme |
取得值,這個值表示 ImeMode 屬性是否可以設定為使用中的值,以啟用 IME 支援。 (繼承來源 Control) |
CanFocus |
取得指示控制項是否能取得焦點的值。 (繼承來源 Control) |
CanOverflow |
取得或設定值,指出是否可以將 ToolStripDropDown 中的項目傳送到溢位功能表。 (繼承來源 ToolStripDropDown) |
CanRaiseEvents |
判斷是否可以在控制項上引發事件。 (繼承來源 Control) |
CanSelect |
取得指示能否選取控制項的值。 (繼承來源 Control) |
Capture |
取得或設定值,指出控制項是否捕捉住滑鼠。 (繼承來源 Control) |
CausesValidation |
取得或設定值,表示當 ToolStrip 收到焦點時,是否會在任何需要驗證的控制項上執行驗證。 (繼承來源 ToolStrip) |
ClientRectangle |
取得表示控制項工作區的矩形。 (繼承來源 Control) |
ClientSize |
取得或設定控制項工作區的高度和寬度。 (繼承來源 Control) |
CompanyName |
取得包含控制項之應用程式的公司名稱或建立者。 (繼承來源 Control) |
Container |
取得包含 IContainer 的 Component。 (繼承來源 Component) |
ContainsFocus |
取得指示控制項 (或其子控制項之一) 目前是否擁有輸入焦點的值。 (繼承來源 Control) |
ContextMenu |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
ContextMenuStrip |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
Controls |
這個屬性與這個類別無關。 (繼承來源 ToolStrip) |
Created |
取得值,指出是否已經建立控制項。 (繼承來源 Control) |
CreateParams |
取得新視窗的參數。 (繼承來源 ToolStripDropDown) |
Cursor |
取得或設定將滑鼠指標移至 ToolStrip 上方時所顯示的游標。 (繼承來源 ToolStrip) |
DataBindings |
取得控制項的資料繫結 (Data Binding)。 (繼承來源 Control) |
DataContext |
取得或設定資料系結用途的資料內容。 這是環境屬性。 (繼承來源 Control) |
DefaultCursor |
取得或設定控制項的預設游標。 (繼承來源 Control) |
DefaultDock |
取得 ToolStrip 的停駐位置,表示哪些框線要停駐到容器上。 (繼承來源 ToolStripDropDown) |
DefaultDropDownDirection |
取得或設定 ToolStripDropDown 顯示的方向 (相對於 ToolStrip)。 (繼承來源 ToolStripDropDown) |
DefaultGripMargin |
取得在 ToolStrip 的調整大小底框和邊緣之間的預設間距 (以像素為單位)。 (繼承來源 ToolStrip) |
DefaultImeMode |
取得控制項支援的預設輸入法 (IME) 模式。 (繼承來源 Control) |
DefaultMargin |
取得 ToolStrip 和 ToolStripContainer 之間的間距 (以像素為單位)。 (繼承來源 ToolStrip) |
DefaultMaximumSize |
取得指定為控制項的預設大小之最大值的長度和高度 (單位為像素)。 (繼承來源 Control) |
DefaultMinimumSize |
取得指定為控制項的預設大小之最小值的長度和高度 (單位為像素)。 (繼承來源 Control) |
DefaultPadding |
取得控制項的內部間距 (單位為像素)。 |
DefaultShowItemToolTips |
取得值,表示預設是否顯示 ToolStripDropDown 的工具提示。 (繼承來源 ToolStripDropDown) |
DefaultSize |
取得 ToolStrip 的預設大小。 (繼承來源 ToolStrip) |
DesignMode |
取得值,指出 Component 目前是否處於設計模式。 (繼承來源 Component) |
DeviceDpi |
取得目前顯示控制項的顯示裝置的 DPI 值。 (繼承來源 Control) |
DisplayedItems |
取得目前顯示在 ToolStrip 上的項目子集,包括自動加入 ToolStrip 中的項目。 (繼承來源 ToolStrip) |
DisplayRectangle |
取得表示 ToolStripDropDownMenu 顯示區域的矩形。 |
Disposing |
取得值,指出基底 Control 類別是否正在處置的過程中。 (繼承來源 Control) |
Dock |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
DockPadding |
取得控制項所有邊的停駐填補設定。 (繼承來源 ScrollableControl) |
DoubleBuffered |
取得或設定值,指出這個控制項是否應使用次要緩衝區重繪其介面,以減少或防止重繪閃動 (Flicker)。 (繼承來源 Control) |
DropShadowEnabled |
取得或設定值,指出當顯示 ToolStripDropDown 時,是否會出現 3D 陰影效果。 (繼承來源 ToolStripDropDown) |
Enabled |
取得或設定值,指出控制項是否可回應使用者互動。 (繼承來源 Control) |
Events |
取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component) |
Focused |
取得指示控制項是否擁有輸入焦點的值。 (繼承來源 Control) |
Font |
取得或設定 ToolStripDropDown 上顯示之文字的字型。 (繼承來源 ToolStripDropDown) |
FontHeight |
取得或設定控制項字型的高度。 (繼承來源 Control) |
ForeColor |
取得或設定 ToolStrip 的前景色彩。 (繼承來源 ToolStrip) |
GripDisplayStyle |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
GripMargin |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
GripRectangle |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
GripStyle |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
Handle |
取得控制項要繫結的目標視窗控制代碼。 (繼承來源 Control) |
HasChildren |
這個屬性與這個類別無關。 (繼承來源 ToolStrip) |
Height |
取得或設定控制項的高度。 (繼承來源 Control) |
HorizontalScroll |
這個屬性與這個類別無關。 (繼承來源 ToolStrip) |
HScroll |
取得或設定值,指出水平捲軸是否為可見的。 (繼承來源 ScrollableControl) |
ImageList |
取得或設定影像清單,其中包含顯示在 ToolStrip 項目上的影像。 (繼承來源 ToolStrip) |
ImageScalingSize |
取得或設定用於 ToolStrip 上的影像大小 (以像素為單位)。 (繼承來源 ToolStrip) |
ImeMode |
取得或設定控制項的輸入法 (IME) 模式。 (繼承來源 Control) |
ImeModeBase |
取得或設定控制項的 IME 模式。 (繼承來源 Control) |
InvokeRequired |
取得一個值。這個值會指示是否由於呼叫端是在建立控制項之執行緒以外的執行緒,因此在進行控制項的方法呼叫時,應呼叫叫用 (Invoke) 方法。 (繼承來源 Control) |
IsAccessible |
取得或設定值,指出可及性應用程式是否見得到控制項。 (繼承來源 Control) |
IsAncestorSiteInDesignMode |
指出這個控制項的其中一個上階是否已月臺,以及該月臺在 DesignMode 中。 這個屬性是唯讀的。 (繼承來源 Control) |
IsAutoGenerated |
取得值,指出是否已自動產生這個 ToolStripDropDown。 (繼承來源 ToolStripDropDown) |
IsCurrentlyDragging |
取得值,表示使用者目前是否正在將 ToolStrip 從某個 ToolStripContainer 移到另一個。 (繼承來源 ToolStrip) |
IsDisposed |
取得指示控制項是否已經處置的值。 (繼承來源 Control) |
IsDropDown |
取得值,表示 ToolStrip 是否為 ToolStripDropDown 控制項。 (繼承來源 ToolStrip) |
IsHandleCreated |
取得指示控制項是否有相關控制代碼的值。 (繼承來源 Control) |
IsMirrored |
取得值,指出是否左右反轉控制項。 (繼承來源 Control) |
Items |
取得屬於 ToolStrip 的所有項目。 (繼承來源 ToolStrip) |
LayoutEngine |
傳遞配置引擎介面所傳回之快取 LayoutEngine 的參考。 |
LayoutSettings |
取得或設定配置方式的特性。 (繼承來源 ToolStrip) |
LayoutStyle |
取得或設定值,表示 ContextMenuStrip 的項目會如何顯示。 |
Left |
取得或設定控制項左邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
Location |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
Margin |
取得或設定控制項之間的空格。 (繼承來源 Control) |
MaximumSize |
取得或設定 GetPreferredSize(Size) 可以指定的上限大小。 (繼承來源 Control) |
MaxItemSize |
取得 ContextMenuStrip 的最大高度和寬度 (以像素為單位)。 |
MinimumSize |
取得或設定 GetPreferredSize(Size) 可以指定的下限大小。 (繼承來源 Control) |
Name |
取得或設定控制項的名稱。 (繼承來源 Control) |
Opacity |
決定表單的不透明度。 (繼承來源 ToolStripDropDown) |
Orientation |
取得 ToolStripPanel 的方向。 (繼承來源 ToolStrip) |
OverflowButton |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
OwnerItem |
取得或設定此 ToolStripItem 的擁有人之 ToolStripDropDown。 (繼承來源 ToolStripDropDown) |
Padding |
取得或設定控制項內的邊框間距。 (繼承來源 Control) |
Parent |
取得或設定控制項的父容器。 (繼承來源 Control) |
PreferredSize |
取得能夠容納控制項的矩形區域的大小。 (繼承來源 Control) |
ProductName |
取得包含控制項的組件的產品名稱。 (繼承來源 Control) |
ProductVersion |
取得包含控制項的組件的版本。 (繼承來源 Control) |
RecreatingHandle |
取得指示控制項目前是否正重新建立其控制代碼的值。 (繼承來源 Control) |
Region |
取得或設定與 ToolStripDropDown 關聯的視窗區域。 (繼承來源 ToolStripDropDown) |
Renderer |
取得或設定 ToolStripRenderer,用來自訂 ToolStrip 的外觀和風格。 (繼承來源 ToolStrip) |
RenderMode |
取得或設定值,表示要將哪些視覺化樣式套用至 ToolStrip。 (繼承來源 ToolStrip) |
RenderRightToLeft |
已淘汰.
已淘汰.
此屬性現在已過時。 (繼承來源 Control) |
ResizeRedraw |
取得或設定值,指出控制項重設大小時,是否會重繪本身。 (繼承來源 Control) |
Right |
取得控制項右邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
RightToLeft |
取得或設定值,指出控制項的項目是否對齊,以支援使用由右至左字型的地區設定。 (繼承來源 ToolStripDropDown) |
ScaleChildren |
取得值,以判斷子控制項的縮放。 (繼承來源 Control) |
ShowCheckMargin |
取得或設定值,指出是否會在 ToolStripMenuItem 的左邊緣顯示核取記號的空間。 |
ShowFocusCues |
取得指示控制項是否應顯示焦點矩形 (Focus Rectangle) 的值。 (繼承來源 Control) |
ShowImageMargin |
取得或設定值,指出是否會在 ToolStripMenuItem 的左邊緣顯示影像的空間。 |
ShowItemToolTips |
取得或設定值,表示是否要在 ToolStrip 項目上顯示工具提示。 (繼承來源 ToolStrip) |
ShowKeyboardCues |
取得值,指出使用者介面是否處於可顯示或隱藏鍵盤快速鍵的適當狀態下。 (繼承來源 Control) |
Site |
取得或設定控制項的站台。 (繼承來源 Control) |
Size |
取得或設定控制項的高度和寬度。 (繼承來源 Control) |
Stretch |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
TabIndex |
這個屬性與這個類別無關。 (繼承來源 ToolStripDropDown) |
TabStop |
取得或設定值,表示使用者是否可以使用 TAB 鍵將焦點提供給 ToolStrip 中的項目。 (繼承來源 ToolStrip) |
Tag |
取得或設定物件,其包含控制項相關資料。 (繼承來源 Control) |
Text |
取得或設定這個控制項的相關文字。 (繼承來源 Control) |
TextDirection |
指定在項目上描繪文字的方向。 (繼承來源 ToolStripDropDown) |
Top |
取得或設定控制項上邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
TopLevel |
取得或設定值,指出 ToolStripDropDown 是否為最上層的控制項。 (繼承來源 ToolStripDropDown) |
TopLevelControl |
取得沒有其他 Windows Form 父控制項的父控制項。 通常,這會是內含控制項最外層的 Form。 (繼承來源 Control) |
TopMost |
取得或設定值,該值代表是否要將此表單顯示成最上層的表單。 (繼承來源 ToolStripDropDown) |
UseWaitCursor |
取得或設定值,指出是否將等待游標用於目前控制項和所有子控制項。 (繼承來源 Control) |
VerticalScroll |
這個屬性與這個類別無關。 (繼承來源 ToolStrip) |
Visible |
取得或設定值,指出 ToolStripDropDown 可看見或是已隱藏。 (繼承來源 ToolStripDropDown) |
VScroll |
取得或設定值,指出垂直捲軸是否為可見的。 (繼承來源 ScrollableControl) |
Width |
取得或設定控制項的寬度。 (繼承來源 Control) |
WindowTarget |
這個屬性與這個類別無關。 (繼承來源 Control) |
方法
事件
明確介面實作
IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |