ToolStripDropDownButton クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クリックされたときに、ユーザーが 1 つの項目を選択するための、関連付けられた ToolStripDropDown を表示するコントロールを表します。
public ref class ToolStripDropDownButton : System::Windows::Forms::ToolStripDropDownItem[System.Windows.Forms.Design.ToolStripItemDesignerAvailability(System.Windows.Forms.Design.ToolStripItemDesignerAvailability.StatusStrip | System.Windows.Forms.Design.ToolStripItemDesignerAvailability.ToolStrip)]
public class ToolStripDropDownButton : System.Windows.Forms.ToolStripDropDownItem[<System.Windows.Forms.Design.ToolStripItemDesignerAvailability(System.Windows.Forms.Design.ToolStripItemDesignerAvailability.StatusStrip | System.Windows.Forms.Design.ToolStripItemDesignerAvailability.ToolStrip)>]
type ToolStripDropDownButton = class
inherit ToolStripDropDownItemPublic Class ToolStripDropDownButton
Inherits ToolStripDropDownItem- 継承
- 継承
-
ToolStripDropDownButton
- 派生
- 属性
例
次のコード例では、 がクリックされたときに 3 つの ToolStripButton コントロールを ToolStripDropDownButton 表示します。 ボタンはフォームの前景色を変更します。
// Declare the drop-down button and the items it will contain.
ToolStripDropDownButton^ dropDownButton1;
ToolStripDropDown^ dropDown;
ToolStripButton^ buttonRed;
ToolStripButton^ buttonBlue;
ToolStripButton^ buttonYellow;
void InitializeDropDownButton()
{
dropDownButton1 = gcnew ToolStripDropDownButton;
dropDown = gcnew ToolStripDropDown;
dropDownButton1->Text = "A";
// Set the drop-down on the DropDownButton.
dropDownButton1->DropDown = dropDown;
// Declare three buttons, set their forecolor and text,
// and add the buttons to the drop-down.
buttonRed = gcnew ToolStripButton;
buttonRed->ForeColor = Color::Red;
buttonRed->Text = "A";
buttonBlue = gcnew ToolStripButton;
buttonBlue->ForeColor = Color::Blue;
buttonBlue->Text = "A";
buttonYellow = gcnew ToolStripButton;
buttonYellow->ForeColor = Color::Yellow;
buttonYellow->Text = "A";
buttonBlue->Click += gcnew EventHandler(this,
&Form1::colorButtonsClick);
buttonRed->Click += gcnew EventHandler(this,
&Form1::colorButtonsClick);
buttonYellow->Click += gcnew EventHandler(this,
&Form1::colorButtonsClick);
array<ToolStripItem^>^ ToolStrips =
{buttonRed,buttonBlue,buttonYellow};
dropDown->Items->AddRange(ToolStrips);
toolStrip1->Items->Add(dropDownButton1);
}
// Handle the buttons' click event by setting the forecolor
// of the form to the forecolor of the button that is clicked.
void colorButtonsClick(Object^ sender, EventArgs^ e)
{
ToolStripButton^ senderButton = (ToolStripButton^) sender;
this->ForeColor = senderButton->ForeColor;
}
// internal:
// Declare the drop-down button and the items it will contain.
internal ToolStripDropDownButton dropDownButton1;
internal ToolStripDropDown dropDown;
internal ToolStripButton buttonRed;
internal ToolStripButton buttonBlue;
internal ToolStripButton buttonYellow;
private void InitializeDropDownButton()
{
dropDownButton1 = new ToolStripDropDownButton();
dropDown = new ToolStripDropDown();
dropDownButton1.Text = "A";
// Set the drop-down on the ToolStripDropDownButton.
dropDownButton1.DropDown = dropDown;
// Set the drop-down direction.
dropDownButton1.DropDownDirection = ToolStripDropDownDirection.Left;
// Do not show a drop-down arrow.
dropDownButton1.ShowDropDownArrow = false;
// Declare three buttons, set their foreground color and text,
// and add the buttons to the drop-down.
buttonRed = new ToolStripButton();
buttonRed.ForeColor = Color.Red;
buttonRed.Text = "A";
buttonBlue = new ToolStripButton();
buttonBlue.ForeColor = Color.Blue;
buttonBlue.Text = "A";
buttonYellow = new ToolStripButton();
buttonYellow.ForeColor = Color.Yellow;
buttonYellow.Text = "A";
buttonBlue.Click += new EventHandler(colorButtonsClick);
buttonRed.Click += new EventHandler(colorButtonsClick);
buttonYellow.Click += new EventHandler(colorButtonsClick);
dropDown.Items.AddRange(new ToolStripItem[]
{ buttonRed, buttonBlue, buttonYellow });
toolStrip1.Items.Add(dropDownButton1);
}
// Handle the buttons' click event by setting the foreground color of the
// form to the foreground color of the button that is clicked.
private void colorButtonsClick(object sender, EventArgs e)
{
ToolStripButton senderButton = (ToolStripButton)sender;
this.ForeColor = senderButton.ForeColor;
}
' Declare the drop-down button and the items it will contain.
Friend WithEvents dropDownButton1 As ToolStripDropDownButton
Friend WithEvents dropDown As ToolStripDropDown
Friend WithEvents buttonRed As ToolStripButton
Friend WithEvents buttonBlue As ToolStripButton
Friend WithEvents buttonYellow As ToolStripButton
Private Sub InitializeDropDownButton()
dropDownButton1 = New ToolStripDropDownButton()
dropDown = New ToolStripDropDown()
dropDownButton1.Text = "A"
' Set the drop-down on the ToolStripDropDownButton.
dropDownButton1.DropDown = dropDown
' Set the drop-down direction.
dropDownButton1.DropDownDirection = ToolStripDropDownDirection.Left
' Do not show a drop-down arrow.
dropDownButton1.ShowDropDownArrow = False
' Declare three buttons, set their foreground color and text,
' and add the buttons to the drop-down.
buttonRed = New ToolStripButton()
buttonRed.ForeColor = Color.Red
buttonRed.Text = "A"
buttonBlue = New ToolStripButton()
buttonBlue.ForeColor = Color.Blue
buttonBlue.Text = "A"
buttonYellow = New ToolStripButton()
buttonYellow.ForeColor = Color.Yellow
buttonYellow.Text = "A"
dropDown.Items.AddRange(New ToolStripItem() {buttonRed, buttonBlue, buttonYellow})
toolStrip1.Items.Add(dropDownButton1)
End Sub
' Handle the buttons' click event by setting the foreground color of the
' form to the foreground color of the button that is clicked.
Public Sub colorButtonsClick(ByVal sender As [Object], ByVal e As EventArgs) _
Handles buttonRed.Click, buttonBlue.Click, buttonYellow.Click
Dim senderButton As ToolStripButton = CType(sender, ToolStripButton)
Me.ForeColor = senderButton.ForeColor
End Sub
注釈
ToolStripDropDownButton は ToolStripButton のように見えますが、ユーザーがクリックするとドロップダウン領域が表示されます。 ShowDropDownArrow プロパティを設定することにより、ドロップダウン矢印を表示または非表示にします。 ToolStripDropDownButton により、ToolStrip をオーバーフローした項目を表示する ToolStripOverflowButton がホストされます。
ToolStripDropDownButtonを使用して、カラー ピッカーなどの使い慣れたドロップダウン コントロールをアクティブにします。 プロパティを ShowDropDownArrow に true 設定して、ドロップダウン リストで追加のオプションが使用可能であることをユーザーにより明確に示します。
コンストラクター
| ToolStripDropDownButton() |
ToolStripDropDownButton クラスの新しいインスタンスを初期化します。 |
| ToolStripDropDownButton(Image) |
指定したイメージを表示する ToolStripDropDownButton クラスの新しいインスタンスを初期化します。 |
| ToolStripDropDownButton(String) |
指定したテキストを表示する ToolStripDropDownButton クラスの新しいインスタンスを初期化します。 |
| ToolStripDropDownButton(String, Image) |
指定したテキストとイメージを表示する ToolStripDropDownButton クラスの新しいインスタンスを初期化します。 |
| ToolStripDropDownButton(String, Image, EventHandler) |
指定したテキストとイメージを表示し、 |
| ToolStripDropDownButton(String, Image, EventHandler, String) |
指定したテキストとイメージを表示し、 |
| ToolStripDropDownButton(String, Image, ToolStripItem[]) |
ToolStripDropDownButton クラスの新しいインスタンスを初期化します。 |
プロパティ
| AccessibilityObject |
コントロールに割り当てられた AccessibleObject を取得します。 (継承元 ToolStripItem) |
| AccessibleDefaultActionDescription |
アクセシビリティ クライアント アプリケーションで使用されるコントロールの既定のアクションの説明を取得または設定します。 (継承元 ToolStripItem) |
| AccessibleDescription |
ユーザー補助クライアント アプリケーションに通知される説明を取得または設定します。 (継承元 ToolStripItem) |
| AccessibleName |
ユーザー補助クライアント アプリケーションによって使用されるコントロールの名前を取得または設定します。 (継承元 ToolStripItem) |
| AccessibleRole |
コントロールのユーザー インターフェイス要素の型を指定する、コントロールのユーザー補助役割を取得または設定します。 (継承元 ToolStripItem) |
| Alignment |
項目が ToolStrip の先頭または末尾のいずれに合わせて配置されるかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| AllowDrop |
実装するイベントによって、ドラッグ アンド ドロップおよび項目の順番変更が処理されるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| Anchor |
ToolStripItem のバインド先コンテナーの端を取得または設定し、親のサイズ変更時に ToolStripItem のサイズがどのように変化するかを決定します。 (継承元 ToolStripItem) |
| AutoSize |
項目のサイズが自動的に設定されるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| AutoToolTip |
ToolTipText のツールヒントに、 |
| Available |
ToolStripItem を ToolStrip 上に配置するかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| BackColor |
項目の背景色を取得または設定します。 (継承元 ToolStripItem) |
| BackgroundImage |
項目に表示される背景イメージを取得または設定します。 (継承元 ToolStripItem) |
| BackgroundImageLayout |
ToolStripItem に使用する背景イメージのレイアウトを取得または設定します。 (継承元 ToolStripItem) |
| BindingContext |
IBindableComponent の CurrencyManager のコレクションを取得または設定します。 (継承元 BindableComponent) |
| Bounds |
項目のサイズと位置を取得します。 (継承元 ToolStripItem) |
| CanRaiseEvents |
コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 (継承元 Component) |
| CanSelect |
項目を選択できるかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| Command |
ToolStripItem Click のICommandExecute(Object)イベントが呼び出されたときにメソッドを呼び出す を取得または設定します。 (継承元 ToolStripItem) |
| CommandParameter |
プロパティに割り当てられている Command にICommand渡されるパラメーターを取得または設定します。 (継承元 ToolStripItem) |
| Container |
IContainer を含む Component を取得します。 (継承元 Component) |
| ContentRectangle |
背景の境界線を上書きせずに、テキスト、アイコンなどのコンテンツを ToolStripItem 内に配置できる領域を取得します。 (継承元 ToolStripItem) |
| DataBindings |
このIBindableComponent のデータ バインディング オブジェクトのコレクションを取得します。 (継承元 BindableComponent) |
| DefaultAutoToolTip |
既定として定義されている ToolTip を表示するかどうかを示す値を取得します。 |
| DefaultDisplayStyle |
ToolStripItem に表示されている内容を示す値を取得します。 (継承元 ToolStripItem) |
| DefaultMargin |
項目の既定のマージンを取得します。 (継承元 ToolStripItem) |
| DefaultPadding |
項目の内部のスペーシング特性を取得します。 (継承元 ToolStripItem) |
| DefaultSize |
項目の既定のサイズを取得します。 (継承元 ToolStripItem) |
| DesignMode |
Component が現在デザイン モードかどうかを示す値を取得します。 (継承元 Component) |
| DismissWhenClicked |
ToolStripDropDown の項目がクリックされた後、非表示にするかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| DisplayStyle |
テキストおよびイメージが ToolStripItem に表示されるかどうかを取得または設定します。 (継承元 ToolStripItem) |
| Dock |
ToolStripItem の境界のうちのどれが、親コントロールにドッキングしているかを取得または設定し、親のサイズ変更時に ToolStripItem のサイズがどのように変化するかを決定します。 (継承元 ToolStripItem) |
| DoubleClickEnabled |
ToolStripItem がマウスのダブルクリックによってアクティブになるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| DropDown |
この ToolStripDropDown がクリックされたときに表示される ToolStripDropDownItem を取得または設定します。 (継承元 ToolStripDropDownItem) |
| DropDownDirection |
ToolStripDropDownItem が親コンテナーから表示される方向を示す値を取得または設定します。 (継承元 ToolStripDropDownItem) |
| DropDownItems |
この ToolStripDropDown に関連付けられた ToolStripDropDownItem の項目のコレクションを取得します。 (継承元 ToolStripDropDownItem) |
| DropDownLocation |
ToolStripDropDownItem の左上隅の画面座標をピクセル単位で取得します。 (継承元 ToolStripDropDownItem) |
| Enabled |
ToolStripItem の親コントロールが有効かどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| Events |
Component に結び付けられているイベント ハンドラーのリストを取得します。 (継承元 Component) |
| Font |
項目によって表示されるテキストのフォントを取得または設定します。 (継承元 ToolStripItem) |
| ForeColor |
項目の前景色を取得または設定します。 (継承元 ToolStripItem) |
| HasDropDown |
DropDown の ToolStripDropDownItem が作成されているかどうかを示す値を取得または設定します。 (継承元 ToolStripDropDownItem) |
| HasDropDownItems |
ToolStripDropDownItem に ToolStripDropDown コントロールが関連付けられているかどうかを示す値を取得します。 (継承元 ToolStripDropDownItem) |
| Height |
ToolStripItem の高さをピクセル単位で取得または設定します。 (継承元 ToolStripItem) |
| Image |
ToolStripItem に表示されるイメージを取得または設定します。 (継承元 ToolStripItem) |
| ImageAlign |
ToolStripItem 上のイメージの配置を取得または設定します。 (継承元 ToolStripItem) |
| ImageIndex |
項目に表示されるイメージのインデックス値を取得または設定します。 (継承元 ToolStripItem) |
| ImageKey |
ImageList に表示されている ToolStripItem で、イメージのキー アクセサーを取得または設定します。 (継承元 ToolStripItem) |
| ImageScaling |
ToolStripItem 上のイメージが、コンテナーに合わせて自動的にサイズ変更されるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| ImageTransparentColor |
ToolStripItem イメージ内で透明と見なされる色を取得または設定します。 (継承元 ToolStripItem) |
| IsDisposed |
オブジェクトが破棄されているかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| IsOnDropDown |
現在の Control のコンテナーが ToolStripDropDown かどうかを示す値を取得します。 (継承元 ToolStripItem) |
| IsOnOverflow |
Placement プロパティ が Overflow に設定されているかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| Margin |
項目と隣接する項目との間隔を取得または設定します。 (継承元 ToolStripItem) |
| MergeAction |
子メニューが親メニューにマージされる方法を取得または設定します。 (継承元 ToolStripItem) |
| MergeIndex |
現在の ToolStrip 内のマージされた項目の位置を取得または設定します。 (継承元 ToolStripItem) |
| Name |
項目の名前を取得または設定します。 (継承元 ToolStripItem) |
| Overflow |
項目が ToolStrip または ToolStripOverflowButton のいずれかに関連付けられているか、それとも 2 つの間で変動するかを取得または設定します。 (継承元 ToolStripItem) |
| Owner |
この項目の所有者を取得または設定します。 (継承元 ToolStripItem) |
| OwnerItem |
この ToolStripItem の親 ToolStripItem を取得します。 (継承元 ToolStripItem) |
| Padding |
項目のコンテンツと項目の端との間の内部スペーシングをピクセル単位で取得または設定します。 (継承元 ToolStripItem) |
| Parent |
ToolStripItem の親コンテナーを取得または設定します。 (継承元 ToolStripItem) |
| Placement |
項目の現在のレイアウトを取得します。 (継承元 ToolStripItem) |
| Pressed |
ToolStripDropDownItem が押された状態かどうかを示す値を取得します。 (継承元 ToolStripDropDownItem) |
| Renderer |
クリックされたときに、ユーザーが 1 つの項目を選択するための、関連付けられた ToolStripDropDown を表示するコントロールを表します。 (継承元 ToolStripItem) |
| RightToLeft |
項目が右から左へと並べられ、テキストが右から左へと表示されるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| RightToLeftAutoMirrorImage |
ToolStripItem プロパティが RightToLeft に設定されている場合、Yes イメージを自動的に反映します。 (継承元 ToolStripItem) |
| Selected |
項目が選択されているかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| ShowDropDownArrow |
ドロップダウン リストにさらにオプションがあることを示す矢印を、ToolStripDropDownButton 上に表示するかどうかを示す値を取得または設定します。 |
| ShowKeyboardCues |
ショートカット キーを表示、非表示のいずれにするかを示す値を取得します。 (継承元 ToolStripItem) |
| Site |
Component の ISite を取得または設定します。 (継承元 Component) |
| Size |
項目のサイズを取得または設定します。 (継承元 ToolStripItem) |
| Tag |
アイテムに関するデータを含むオブジェクトを取得または設定します。 (継承元 ToolStripItem) |
| Text |
項目に表示されるテキストを取得または設定します。 (継承元 ToolStripItem) |
| TextAlign |
ToolStripLabel 上のテキストの配置を取得または設定します。 (継承元 ToolStripItem) |
| TextDirection |
ToolStripItem で使用されるテキストの方向を取得します。 (継承元 ToolStripItem) |
| TextImageRelation |
ToolStripItem のテキストとイメージの互いに相対的な位置を取得または設定します。 (継承元 ToolStripItem) |
| ToolTipText |
コントロールの ToolTip として表示されるテキストを取得または設定します。 (継承元 ToolStripItem) |
| Visible |
項目が表示されるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| Width |
ToolStripItem の幅をピクセル単位で取得または設定します。 (継承元 ToolStripItem) |
メソッド
イベント
| AvailableChanged |
Available プロパティの値が変化したときに発生します。 (継承元 ToolStripItem) |
| BackColorChanged |
BackColor プロパティの値が変化したときに発生します。 (継承元 ToolStripItem) |
| BindingContextChanged |
バインド コンテキストが変更されたときに発生します。 (継承元 BindableComponent) |
| Click |
ToolStripItem がクリックされた時点で発生します。 (継承元 ToolStripItem) |
| CommandCanExecuteChanged |
プロパティにCanExecute(Object)割り当てられている Command のICommand状態が変更されたときに発生します。 (継承元 ToolStripItem) |
| CommandChanged |
プロパティの割り当て済み ICommand が Command 変更されたときに発生します。 (継承元 ToolStripItem) |
| CommandParameterChanged |
CommandParameter プロパティの値が変更されたときに発生します。 (継承元 ToolStripItem) |
| DisplayStyleChanged |
DisplayStyle が変更された場合に発生します。 (継承元 ToolStripItem) |
| Disposed |
Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。 (継承元 Component) |
| DoubleClick |
項目がマウスでダブルクリックされたときに発生します。 (継承元 ToolStripItem) |
| DragDrop |
ユーザーが項目をドラッグし、マウス ボタンを離したとき (つまり、項目がドロップされたとき) に発生します。 (継承元 ToolStripItem) |
| DragEnter |
この項目のクライアント領域に対し、ユーザーが項目をドラッグしたときに発生します。 (継承元 ToolStripItem) |
| DragLeave |
ユーザーが項目をドラッグし、マウス ポインターがこの項目のクライアント領域上から離れたときに発生します。 (継承元 ToolStripItem) |
| DragOver |
この項目のクライアント領域上に、ユーザーが項目をドラッグしたときに発生します。 (継承元 ToolStripItem) |
| DropDownClosed |
ToolStripDropDown が閉じた場合に発生します。 (継承元 ToolStripDropDownItem) |
| DropDownItemClicked |
ToolStripDropDown がクリックされた時点で発生します。 (継承元 ToolStripDropDownItem) |
| DropDownOpened |
ToolStripDropDown が開いた場合に発生します。 (継承元 ToolStripDropDownItem) |
| DropDownOpening |
ToolStripDropDown が開いている間に発生します。 (継承元 ToolStripDropDownItem) |
| EnabledChanged |
Enabled プロパティ値が変更されたときに発生します。 (継承元 ToolStripItem) |
| ForeColorChanged |
ForeColor プロパティの値が変化すると発生します。 (継承元 ToolStripItem) |
| GiveFeedback |
ドラッグ操作中に発生します。 (継承元 ToolStripItem) |
| LocationChanged |
ToolStripItem の位置が更新されたときに発生します。 (継承元 ToolStripItem) |
| MouseDown |
マウス ポインターが項目上にあり、マウス ボタンがクリックされると発生します。 (継承元 ToolStripItem) |
| MouseEnter |
マウス ポインターによって項目が入力されると発生します。 (継承元 ToolStripItem) |
| MouseHover |
マウス ポインターが項目上を移動すると発生します。 (継承元 ToolStripItem) |
| MouseLeave |
マウス ポインターが項目を離れると発生します。 (継承元 ToolStripItem) |
| MouseMove |
マウス ポインターが項目上を移動すると発生します。 (継承元 ToolStripItem) |
| MouseUp |
マウス ポインターが項目上にあり、マウス ボタンを離すと発生します。 (継承元 ToolStripItem) |
| OwnerChanged |
Owner プロパティが変更されたときに発生します。 (継承元 ToolStripItem) |
| Paint |
項目が再描画されると発生します。 (継承元 ToolStripItem) |
| QueryAccessibilityHelp |
ユーザー補助クライアント アプリケーションが ToolStripItem のヘルプを呼び出したときに発生します。 (継承元 ToolStripItem) |
| QueryContinueDrag |
ドラッグ アンド ドロップ操作中に発生し、ドラッグ ソースがドラッグ アンド ドロップ操作をキャンセルする必要があるかどうかを決定できるようにします。 (継承元 ToolStripItem) |
| RightToLeftChanged |
RightToLeft プロパティの値が変化すると発生します。 (継承元 ToolStripItem) |
| SelectedChanged |
クリックされたときに、ユーザーが 1 つの項目を選択するための、関連付けられた ToolStripDropDown を表示するコントロールを表します。 (継承元 ToolStripItem) |
| TextChanged |
Text プロパティの値が変化したときに発生します。 (継承元 ToolStripItem) |
| VisibleChanged |
Visible プロパティの値が変化したときに発生します。 (継承元 ToolStripItem) |
明示的なインターフェイスの実装
| IDropTarget.OnDragDrop(DragEventArgs) |
DragDrop イベントを発生させます。 (継承元 ToolStripItem) |
| IDropTarget.OnDragEnter(DragEventArgs) |
DragEnter イベントを発生させます。 (継承元 ToolStripItem) |
| IDropTarget.OnDragLeave(EventArgs) |
DragLeave イベントを発生させます。 (継承元 ToolStripItem) |
| IDropTarget.OnDragOver(DragEventArgs) |
|
適用対象
こちらもご覧ください
.NET