Control.Focus メソッド

.NET Framework クラス ライブラリ リファレンス

Control.Focus メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub Focus

Visual Basic (使用法)

Dim instance As Control

instance.Focus

C#

public virtual void Focus ()

C++

public:
virtual void Focus ()

J#

public void Focus ()

JScript

public function Focus ()

解説

Focus メソッドを使用して、コントロールに Web ページの初期フォーカスを設定します。コントロールが選択された状態で、ブラウザでページが開かれます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Control クラス
Control メンバ
System.Web.UI 名前空間

Control.Focus メソッド

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Function Focus As
 Boolean

Visual Basic (使用法)

Dim instance As Control
Dim returnValue As Boolean

returnValue = instance.Focus

C#

public bool Focus ()

C++

public:
bool Focus ()

J#

public boolean Focus ()

JScript

public function Focus () : boolean

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

解説

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

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

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

• Panel

• GroupBox

• PictureBox

• ProgressBar

• Splitter

• Label

• LinkLabel (コントロール内にリンクが存在しない場合)

メモ
Focus は、主にカスタム コントロールの作成者が使用するための低水準メソッドです。代わりに、アプリケーション プログラマは、子コントロールには Select メソッドまたは ActiveControl プロパティ、フォームには Activate メソッドを使用する必要があります。

使用例

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

Visual Basic

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();
      }
   }

J#

public void ControlSetFocus(Control control)
{
    // Set focus to the control, if it can receive focus.
    if (control.get_CanFocus()) {
        control.Focus();
    }
} //ControlSetFocus

.NET Framework のセキュリティ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
CanFocus
ContainsFocus
Focused
CanSelect
Select
ContainerControl.ActiveControl プロパティ
Form.Activate