Control.Focus Methode

Definition

Setzt den Eingabefokus auf das Steuerelement.Sets input focus to the control.

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

Gibt zurück

true, wenn die Anforderung des Eingabefokus erfolgreich war, andernfalls false.true if the input focus request was successful; otherwise, false.

Beispiele

Im folgenden Codebeispiel wird der Fokus auf das angegebene Control festgelegt, wenn es den Fokus erhalten kann.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

Hinweise

Die Focus-Methode gibt true zurück, wenn das Steuerelement den Eingabefokus erfolgreich empfangen hat.The Focus method returns true if the control successfully received input focus. Das Steuerelement kann über den Eingabefokus verfügen, während keine visuellen Hinweise angezeigt werden, die den Fokus haben.The control can have the input focus while not displaying any visual cues of having the focus. Dieses Verhalten wird in erster Linie durch die unten aufgeführten nicht auswählbaren Steuerelemente oder von Ihnen abgeleitete Steuerelemente beobachtet.This behavior is primarily observed by the nonselectable controls listed below, or any controls derived from them.

Ein Steuerelement kann ausgewählt werden und den Eingabefokus erhalten, wenn Folgendes zutrifft: der Selectable-Wert von ControlStyles ist auf true festgelegt, er ist in einem anderen Steuerelement enthalten, und alle übergeordneten Steuerelemente sind sichtbar und aktiviert.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.

Die Windows Forms-Steuerelemente in der folgenden Liste können nicht ausgewählt werden.The Windows Forms controls in the following list are not selectable. Von diesen Steuerelementen abgeleitete Steuerelemente sind ebenfalls nicht auswählbar.Controls derived from these controls are also not selectable.

Hinweis

Focus ist eine Methode auf niedriger Ebene, die in erster Linie für benutzerdefinierter Steuerelemente bestimmt ist.Focus is a low-level method intended primarily for custom control authors. Stattdessen sollten Anwendungsprogrammierer die Select-Methode oder die ActiveControl-Eigenschaft für untergeordnete Steuerelemente oder die Activate-Methode für Formulare verwenden.Instead, application programmers should use the Select method or the ActiveControl property for child controls, or the Activate method for forms.

Sicherheit

UIPermission
für alle Fenster, die diese Methode aufruft.for all windows to call this method. Zugeordnete Enumeration: AllWindows-Wert UIPermissionWindow.Associated enumeration: AllWindows value of UIPermissionWindow.

Gilt für:

Siehe auch