Shape.Enabled プロパティ

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

ラインコントロールまたはシェイプコントロールがユーザーとの対話に応答できるかどうかを示す値を取得または設定します。

名前空間 : Microsoft.VisualBasic.PowerPacks
アセンブリ : Microsoft.VisualBasic.PowerPacks.Vs (Microsoft.VisualBasic.PowerPacks.Vs.dll 内)

構文

'宣言
<BrowsableAttribute(True)> _
Public Property Enabled As Boolean
'使用
Dim instance As Shape
Dim value As Boolean

value = instance.Enabled

instance.Enabled = value

[BrowsableAttribute(true)]
public bool Enabled { get; set; }

[BrowsableAttribute(true)]
public:
property bool Enabled {
    bool get ();
    void set (bool value);
}

public function get Enabled () : boolean
public function set Enabled (value : boolean)

プロパティ値

型 : System.Boolean

コントロールがユーザーとの対話に応答できる場合は true。それ以外の場合は false。既定は、true です。

解説

Enabled プロパティを使用すると、実行時に線または図形が選択されないようにできます。また、アプリケーションの現在の状態に適用されないコントロールを無効にすることもできます。たとえば、図形を無効にし、特定の条件が満たされるまでクリックできないようにして、ボタンの動作をエミュレートできます。

例

RectangleShape コントロールを実行時に有効および無効にする方法を次の例に示します。このコードでは、RectangleShape コントロールおよび TextBox コントロールを持つ Form が存在している必要があります。

Private Sub TextBox1_TextChanged(ByVal sender As Object, _
 ByVal e As System.EventArgs) Handles TextBox1.TextChanged
    ' If the TextBox contains text, enable the RectangleShape.
    If TextBox1.Text <> "" Then
        ' Enable the RectangleShape.
        RectangleShape1.Enabled = True
        ' Change the BorderColor to the default.
        RectangleShape1.BorderColor = _
         Microsoft.VisualBasic.PowerPacks.Shape.DefaultBorderColor
    Else
        ' Disable the RectangleShape control.
        RectangleShape1.Enabled = False
        ' Change the BorderColor to show that the control is disabled
        RectangleShape1.BorderColor = _
            Color.FromKnownColor(KnownColor.InactiveBorder)
    End If
End Sub

private void textBox1_TextChanged(object sender, System.EventArgs e)
{
    // If the TextBox contains text, enable the RectangleShape.
    if (textBox1.Text != "")
    // Enable the RectangleShape.
    {
        rectangleShape1.Enabled = true;
        // Change the BorderColor to the default.
        rectangleShape1.BorderColor = Microsoft.VisualBasic.PowerPacks.Shape.DefaultBorderColor;
    }
    else
    {
        // Disable the RectangleShape control.
        rectangleShape1.Enabled = false;
        // Change the BorderColor to show that the control is disabled
        rectangleShape1.BorderColor = Color.FromKnownColor(KnownColor.InactiveBorder);
    }
}