Control.Focus-Methode

Artikel
08/20/2007

Setzt den Eingabefokus auf das Steuerelement.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Function Focus As Boolean
'Usage
Dim instance As Control
Dim returnValue As Boolean

returnValue = instance.Focus

public bool Focus ()

public:
bool Focus ()

public boolean Focus ()

public function Focus () : boolean

Rückgabewert

true, wenn die Anforderung des Eingabefokus erfolgreich war, andernfalls false.

Hinweise

Die Focus-Methode gibt true zurück, wenn das Steuerelement erfolgreich den Eingabefokus erhalten hat. Das Steuerelement kann den Eingabefokus haben, auch wenn darauf nicht visuell hingewiesen wird. Dieses Verhalten weisen hauptsächlich die unten aufgeführten, nicht auswählbaren Steuerelemente auf oder alle von ihnen abgeleiteten Steuerelemente.

Ein Steuerelement kann ausgewählt werden und den Eingabefokus erhalten, wenn sämtliche folgenden Bedingungen wahr sind: der Selectable-Wert von ControlStyles ist auf true festgelegt, das Steuerelement ist in einem anderen Steuerelement enthalten, und alle übergeordneten Steuerelemente sind sowohl sichtbar als auch aktiviert.

Die in der folgenden Liste aufgeführten Windows Forms-Steuerelemente können nicht ausgewählt werden. Von diesen Steuerelementen abgeleitete Steuerelemente können ebenfalls nicht ausgewählt werden.

Panel
GroupBox
PictureBox
ProgressBar
Splitter
Label
LinkLabel (wenn im Steuerelement kein Hyperlink vorhanden ist).

Hinweis

Focus ist eine Methode auf niedriger Ebene, die hauptsächlich für Autoren benutzerdefinierter Steuerelemente bestimmt ist. Anwendungsprogrammierer sollten hingegen die Select-Methode oder die ActiveControl-Eigenschaft für untergeordnete Steuerelemente bzw. die Activate-Methode für Formulare verwenden.

Beispiel

Im folgenden Codebeispiel wird der Fokus auf das angegebene Control festgelegt, sofern es den Fokus erhalten kann.

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

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 void ControlSetFocus(Control control)
{
    // Set focus to the control, if it can receive focus.
    if (control.get_CanFocus()) {
        control.Focus();
    }
} //ControlSetFocus

.NET Framework-Sicherheit

UIPermission für alle Fenster zum Aufrufen dieser Methode. Zugeordnete Enumeration: AllWindows-Wert von UIPermissionWindow.

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
CanFocus
ContainsFocus
Focused
CanSelect
Select
ContainerControl.ActiveControl-Eigenschaft
Form.Activate

Freigeben über