Control.Focus メソッド

定義

コントロールに入力フォーカスを設定します。Sets input focus to the control.

public:
 bool Focus();
public bool Focus ();
member this.Focus : unit -> bool
Public Function Focus () As Boolean

戻り値

入力フォーカス要求が成功した場合は true。それ以外の場合は falsetrue if the input focus request was successful; otherwise, false.

次のコード例では、フォーカスを受け取ることができる場合に、指定した Control にフォーカスを設定します。The following code example sets focus to the specified Control, if it can receive focus.

public:
   void ControlSetFocus( Control^ control )
   {
      
      // Set focus to the control, if it can receive focus.
      if ( control->CanFocus )
      {
         control->Focus();
      }
   }
public void ControlSetFocus(Control control)
{
   // Set focus to the control, if it can receive focus.
   if(control.CanFocus)
   {
      control.Focus();
   }
}
Public Sub ControlSetFocus(control As Control)
   ' Set focus to the control, if it can receive focus.
   If control.CanFocus Then
      control.Focus()
   End If
End Sub

注釈

Focus メソッドは、コントロールが入力フォーカスを正常に受信した場合に true を返します。The Focus method returns true if the control successfully received input focus. コントロールは、フォーカスを持つ視覚的な合図を表示せずに、入力フォーカスを持つことができます。The control can have the input focus while not displaying any visual cues of having the focus. この動作は、主に次に示す選択不可能なコントロール、またはそれらから派生したコントロールによって監視されます。This behavior is primarily observed by the nonselectable controls listed below, or any controls derived from them.

次のすべてが当てはまる場合は、コントロールを選択し、入力フォーカスを受け取ることができます。 ControlStylesSelectable 値は trueに設定され、別のコントロールに含まれ、すべての親コントロールが表示され、有効になります。A control can be selected and receive input focus if all the following are true: the Selectable value of ControlStyles is set to true, it is contained in another control, and all its parent controls are both visible and enabled.

次の一覧の Windows フォームコントロールは選択できません。The Windows Forms controls in the following list are not selectable. これらのコントロールから派生したコントロールも選択できません。Controls derived from these controls are also not selectable.

注意

Focus は、主にカスタムコントロールの作成者を対象とした低レベルのメソッドです。Focus is a low-level method intended primarily for custom control authors. 代わりに、アプリケーションプログラマは、Select メソッドまたは子コントロールの ActiveControl プロパティ、またはフォームの Activate メソッドを使用する必要があります。Instead, application programmers should use the Select method or the ActiveControl property for child controls, or the Activate method for forms.

セキュリティ

UIPermission
すべてのウィンドウでこのメソッドを呼び出します。for all windows to call this method. 列挙型に関連付けられている: AllWindows UIPermissionWindowします。Associated enumeration: AllWindows value of UIPermissionWindow.

適用対象

こちらもご覧ください