Shape.Tag プロパティ
行またはシェイプ コントロールに関するデータを含むオブジェクトを取得または設定します。
名前空間: Microsoft.VisualBasic.PowerPacks
アセンブリ: Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)
構文
'宣言
<BrowsableAttribute(True)> _
Public Property Tag As Object
[BrowsableAttribute(true)]
public Object Tag { get; set; }
[BrowsableAttribute(true)]
public:
property Object^ Tag {
Object^ get ();
void set (Object^ value);
}
[<BrowsableAttribute(true)>]
member Tag : Object with get, set
function get Tag () : Object
function set Tag (value : Object)
プロパティ値
型 : System.Object
Object コントロールに関連付けられたデータを格納する。既定値は null 参照 (Visual Basic の場合は Nothing) です。
解説
Object クラスから派生した任意の型をこのプロパティに割り当てることができます。Tag のプロパティを使用して、Windows フォーム デザイナーを使用して設定した場合、テキストのみを割り当てることができます。
Tag プロパティは、一般的に、コントロールに密接に関連付けられたデータを格納するために使用します。たとえば、ネットワークの地形のオブジェクトを表すシェイプ コントロールがある場合は、Tag のプロパティでそのオブジェクトに関する情報を含む従ってデータがすぐにアクセスできる DataSet を格納する可能性があります。
例
次の例では、新しいフォームに NodeInfo クラスのインスタンスを渡すために Tag のプロパティを使用する方法を示します。この例では、2 番目の形式で指定された networkForm があり、プロジェクトの NodeInfo のクラスを定義すること RectangleShape1 フォームの RectangleShape という名前のコントロールが必要です。
Private Sub Form1_Load() Handles MyBase.Load
' Declare an instance of a NodeInfo class.
Dim MyNode As New NodeInfo
' Assign the instance to the Tag property.
RectangleShape1.Tag = MyNode
End Sub
Private Sub RectangleShape1_Click() Handles RectangleShape1.Click
' Declare an instance of a networkForm form.
Dim networkForm As New Form()
' Assign the Tag property of the RectangleShape to the new form.
' This passes the MyNode instance of the NodeInfo class to the
' form.
networkForm.Tag = RectangleShape1.Tag
' Show the new form.
networkForm.Show()
End Sub
private void Form1_Load(System.Object sender, System.EventArgs e)
{
// Declare an instance of a NodeInfo class.
NodeInfo MyNode = new NodeInfo();
// Assign the instance to the Tag property.
rectangleShape1.Tag = MyNode;
}
private void rectangleShape1_Click(System.Object sender, System.EventArgs e)
{
// Declare an instance of a networkForm form.
Form networkForm = new Form();
// Assign the Tag property of the RectangleShape to the new form.
// This passes the MyNode instance of the NodeInfo class to the
// form.
networkForm.Tag = rectangleShape1.Tag;
// Show the new form.
networkForm.Show();
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。
参照
関連項目
Microsoft.VisualBasic.PowerPacks 名前空間
その他の技術情報
方法 : LineShape コントロールを使用して線を描画する (Visual Studio)
方法 : OvalShape コントロールおよび RectangleShape コントロールを使用して図形を描画する (Visual Studio)