ToolStripDropDownItem.DropDown プロパティ

.NET Framework クラス ライブラリ リファレンス

ToolStripDropDownItem.DropDown プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

この ToolStripDropDownItem がクリックされたときに表示される ToolStripDropDown を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property DropDown As
 ToolStripDropDown

Visual Basic (使用法)

Dim instance As ToolStripDropDownItem
Dim value As ToolStripDropDown

value = instance.DropDown

instance.DropDown = value

C#

public ToolStripDropDown DropDown { get; set;
 }

C++

public:
property ToolStripDropDown^ DropDown {
    ToolStripDropDown^ get ();
    void set (ToolStripDropDown^ value);
}

J#

/** @property */
public ToolStripDropDown get_DropDown ()

/** @property */
public void set_DropDown (ToolStripDropDown
 value)

JScript

public function get DropDown
 () : ToolStripDropDown

public function set DropDown
 (value : ToolStripDropDown)

プロパティ値
ToolStripDropDownItem に関連付けられた ToolStripDropDown。

解説

ToolStripDropDown が ToolStripDropDownItem に関連付けられていない場合、CreateDefaultDropDown への呼び出しにより汎用的なドロップダウン コントロールが作成されます。

メモ
ドロップダウン コントロールが自動的に生成された後、つまり、項目がコレクションに追加されているときに、DropDown プロパティに対して、明示的にドロップダウン コントロールを設定した場合、データが失われる可能性があります。

使用例

ToolStripDropDownItem コントロールの DropDown プロパティに ContextMenuStrip コントロールを割り当てる方法を次のコード例に示します。このコード例は、ToolStripDropDownItem クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' This utility method creates and initializes three 
' ToolStripDropDownItem controls and adds them 
' to the form's ToolStrip control.
Private Sub InitializeToolStripDropDownItems()
   Dim b As New ToolStripDropDownButton("DropDownButton")
   b.DropDown = Me.contextMenuStrip1
   AddHandler b.DropDownClosed, AddressOf toolStripDropDownItem_DropDownClosed
   AddHandler b.DropDownItemClicked, AddressOf
 toolStripDropDownItem_DropDownItemClicked
   AddHandler b.DropDownOpened, AddressOf toolStripDropDownItem_DropDownOpened
   
   Dim m As New ToolStripMenuItem("MenuItem")
   m.DropDown = Me.contextMenuStrip1
   AddHandler m.DropDownClosed, AddressOf toolStripDropDownItem_DropDownClosed
   AddHandler m.DropDownItemClicked, AddressOf
 toolStripDropDownItem_DropDownItemClicked
   AddHandler m.DropDownOpened, AddressOf toolStripDropDownItem_DropDownOpened
   
   Dim sb As New ToolStripSplitButton("SplitButton")
   sb.DropDown = Me.contextMenuStrip1
   AddHandler sb.DropDownClosed, AddressOf
 toolStripDropDownItem_DropDownClosed
   AddHandler sb.DropDownItemClicked, AddressOf
 toolStripDropDownItem_DropDownItemClicked
   AddHandler sb.DropDownOpened, AddressOf
 toolStripDropDownItem_DropDownOpened
   
   Me.toolStrip1.Items.AddRange(New ToolStripItem()
 {b, m, sb})
End Sub 

C#

// This utility method creates and initializes three 
// ToolStripDropDownItem controls and adds them 
// to the form's ToolStrip control.
private void InitializeToolStripDropDownItems()
{
    ToolStripDropDownButton b = new ToolStripDropDownButton("DropDownButton");
    b.DropDown = this.contextMenuStrip1;
    b.DropDownClosed += new EventHandler(toolStripDropDownItem_DropDownClosed);
    b.DropDownItemClicked += new ToolStripItemClickedEventHandler(toolStripDropDownItem_DropDownItemClicked);
    b.DropDownOpened += new EventHandler(toolStripDropDownItem_DropDownOpened);

    ToolStripMenuItem m = new ToolStripMenuItem("MenuItem");
    m.DropDown = this.contextMenuStrip1;
    m.DropDownClosed += new EventHandler(toolStripDropDownItem_DropDownClosed);
    m.DropDownItemClicked += new ToolStripItemClickedEventHandler(toolStripDropDownItem_DropDownItemClicked);
    m.DropDownOpened += new EventHandler(toolStripDropDownItem_DropDownOpened);

    ToolStripSplitButton sb = new ToolStripSplitButton("SplitButton");
    sb.DropDown = this.contextMenuStrip1;
    sb.DropDownClosed += new EventHandler(toolStripDropDownItem_DropDownClosed);
    sb.DropDownItemClicked += new ToolStripItemClickedEventHandler(toolStripDropDownItem_DropDownItemClicked);
    sb.DropDownOpened += new EventHandler(toolStripDropDownItem_DropDownOpened);

    this.toolStrip1.Items.AddRange(new ToolStripItem[]
 { b, m, sb });
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ToolStripDropDownItem クラス
ToolStripDropDownItem メンバ
System.Windows.Forms 名前空間