Control.Focus メソッド


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

 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.

   void ControlSetFocus( Control^ control )
      // Set focus to the control, if it can receive focus.
      if ( control->CanFocus )
public void ControlSetFocus(Control control)
   // Set focus to the control, if it can receive focus.
Public Sub ControlSetFocus(control As Control)
   ' Set focus to the control, if it can receive focus.
   If control.CanFocus Then
   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.

次のすべてが当てはまる場合は、コントロールを選択し、入力フォーカスを受け取ることができます。 Selectable の値がに設定されていて、 ControlStyles 別の 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.