Shape.Focus メソッド

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

更新 : 2007 年 11 月

ラインコントロールまたはシェイプコントロールに入力フォーカスを設定します。

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

構文

'宣言
Public Function Focus As Boolean
'使用
Dim instance As Shape
Dim returnValue As Boolean

returnValue = instance.Focus()

public bool Focus()

public:
bool Focus()

public function Focus() : boolean

戻り値

型 : System.Boolean

入力フォーカス要求が成功した場合は true。それ以外の場合は false。

解説

コントロールが入力フォーカスを正常に受け取った場合、Focus メソッドは true を返します。コントロールは、一定の条件がすべて true の場合に、選択可能であり、入力フォーカスを受け取ることができます。一定の条件とは、コントロールが表示されていて有効になっていること、コントロールが別のコントロールに格納されていること、およびすべての親コントロールが表示されていて有効になっていることです。

メモ :
Focus は、主にカスタムコントロールの作成者が使用するための下位メソッドです。開発者は、子コントロールには Select メソッドまたは ActiveControl プロパティを使用する必要があります。

例

指定した Shape がフォーカスを受け取ることができる場合に、そのコントロールにフォーカスを設定する例を次に示します。

Public Sub ShapeSetFocus(ByVal shape As Microsoft.VisualBasic.PowerPacks.Shape)
    ' Set focus to the control, if it can receive focus.
    If shape.CanFocus Then
        shape.Focus()
    End If
End Sub

public void ShapeSetFocus(Microsoft.VisualBasic.PowerPacks.Shape shape)
{
    // Set focus to the control, if it can receive focus.
    if (shape.CanFocus)
    {
        shape.Focus();
    }
}