ContextMenuStrip.SourceControl プロパティ

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

ContextMenuStrip.SourceControl プロパティ

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

この ContextMenuStrip を表示した最後のコントロールを取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 SourceControl As Control

Visual Basic (使用法)

Dim instance As ContextMenuStrip
Dim value As Control

value = instance.SourceControl

C#

public Control SourceControl { get; }

C++

public:
property Control^ SourceControl {
    Control^ get ();
}

J#

/** @property */
public Control get_SourceControl ()

JScript

public function get SourceControl
 () : Control

プロパティ値
この ContextMenuStrip を表示したコントロール。

解説

SourceControl プロパティの一般的な用途は、次のとおりです。

• Opening イベントの発生時に、メニュー項目を追加、削除、有効化、または無効化します。

• ContextMenuStrip を最後に表示したコントロールに基づいて、選択されたコマンドの変更を決定します。

使用例

どのコントロールでメニューが表示されたかを SourceControl を使用して動的に判断する方法と、Opening イベントの処理方法を次のコード例に示します。このコード例は、ContextMenuStrip クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' This event handler is invoked when the ContextMenuStrip
' control's Opening event is raised. It demonstrates
' dynamic item addition and dynamic SourceControl 
' determination with reuse.
 Sub cms_Opening(ByVal sender As
 Object, ByVal e As System.ComponentModel.CancelEventArgs)

     ' Acquire references to the owning control and item.
     Dim c As Control = fruitContextMenuStrip.SourceControl
     Dim tsi As ToolStripDropDownItem = fruitContextMenuStrip.OwnerItem
 

     ' Clear the ContextMenuStrip control's 
     ' Items collection.
     fruitContextMenuStrip.Items.Clear()

     ' Check the source control first.
     If Not (c Is Nothing)
 Then
         ' Add custom item (Form)
         fruitContextMenuStrip.Items.Add(("Source: "
 + c.GetType().ToString()))
     ElseIf Not (tsi Is
 Nothing) Then
         ' Add custom item (ToolStripDropDownButton or ToolStripMenuItem)
         fruitContextMenuStrip.Items.Add(("Source: "
 + tsi.GetType().ToString()))
     End If

     ' Populate the ContextMenuStrip control with its default items.
     fruitContextMenuStrip.Items.Add("-")
     fruitContextMenuStrip.Items.Add("Apples")
     fruitContextMenuStrip.Items.Add("Oranges")
     fruitContextMenuStrip.Items.Add("Pears")

     ' Set Cancel to false. 
     ' It is optimized to true based on empty entry.
     e.Cancel = False
 End Sub

C#

// This event handler is invoked when the ContextMenuStrip
// control's Opening event is raised. It demonstrates
// dynamic item addition and dynamic SourceControl 
// determination with reuse.
void cms_Opening(object sender, System.ComponentModel.CancelEventArgs
 e)
{
    // Acquire references to the owning control and item.
    Control c = fruitContextMenuStrip.SourceControl as Control;
    ToolStripDropDownItem tsi = fruitContextMenuStrip.OwnerItem as ToolStripDropDownItem;

    // Clear the ContextMenuStrip control's Items collection.
    fruitContextMenuStrip.Items.Clear();

    // Check the source control first.
    if (c != null)
    {
        // Add custom item (Form)
        fruitContextMenuStrip.Items.Add("Source: " + c.GetType().ToString());
    }
    else if (tsi != null)
    {
        // Add custom item (ToolStripDropDownButton or ToolStripMenuItem)
        fruitContextMenuStrip.Items.Add("Source: " + tsi.GetType().ToString());
    }

    // Populate the ContextMenuStrip control with its default items.
    fruitContextMenuStrip.Items.Add("-");
    fruitContextMenuStrip.Items.Add("Apples");
    fruitContextMenuStrip.Items.Add("Oranges");
    fruitContextMenuStrip.Items.Add("Pears");

    // Set Cancel to false. 
    // It is optimized to true based on empty entry.
    e.Cancel = false;
}

.NET Framework のセキュリティ

• UIPermission  (すべてのウィンドウでこのプロパティ値を設定するために必要なアクセス許可)。UIPermissionWindow.AllWindows (関連する列挙体)

プラットフォーム

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

参照

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