Control.Focus メソッド

コントロールに入力フォーカスを設定します。

Public Function Focus() As Boolean
[C#]
public bool Focus();
[C++]
public: bool Focus();
[JScript]
public function Focus() : Boolean;

戻り値

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

解説

コントロールが入力フォーカスを正常に受け取った場合、 Focus メソッドは true を返します。コントロールは、フォーカスのあるビジュアル キューを表示していないときに、入力フォーカスを得ることができます。この動作は、主に、次に一覧表示する選択できないコントロール、またはそれらのコントロールから派生したコントロールで行われます。

コントロールは、ある条件がすべて true の場合に、選択可能であり、入力フォーカスを受け取ることができます。この条件とは、コントロールの ControlStyles.Selectable スタイル ビットが true に設定されていること、コントロールが別のコントロールに格納されていること、およびすべての親コントロールが表示されており、有効であることです。

選択できない Windows フォーム コントロールの一覧を次に示します。これらのコントロールから派生したコントロールも、選択できません。

• Panel
• GroupBox
• PictureBox
• ProgressBar
• Splitter
• Label
• LinkLabel (コントロール内にリンクが存在しない場合)

使用例

[Visual Basic, C#, C++] 指定した Control がフォーカスを受け取ることができる場合に、そのコントロールのフォーカスを設定する例を次に示します。

 
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

[C#] 
public void ControlSetFocus(Control control)
{
   // Set focus to the control, if it can receive focus.
   if(control.CanFocus)
   {
      control.Focus();
   }
}

[C++] 
public:
   void ControlSetFocus(Control* control) {
      // Set focus to the control, if it can receive focus.
      if (control->CanFocus) {
         control->Focus();
      }
   }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

.NET Framework セキュリティ:

• UIPermission (すべてのウィンドウでこのメソッドを呼び出すために必要なアクセス許可) UIPermissionWindow.AllWindows (関連する列挙体)

参照

Control クラス | Control メンバ | System.Windows.Forms 名前空間 | CanFocus | ContainsFocus | Focused | CanSelect