TextBox.GotFocus-Ereignis (Access)

Das GotFocus-Ereignis tritt auf, wenn das angegebene Objekt den Fokus erhält.

Syntax

Ausdruck. Gotfocus

Ausdruck Eine Variable, die ein TextBox-Objekt darstellt.

HinwBemerkungeneise

Um ein Makro oder eine Ereignisprozedur auszuführen, wenn diese Ereignisse auftreten, legen Sie die OnGotFocus-Eigenschaft auf den Namen des Makros oder auf [Ereignisprozedur] fest.

Diese Ereignisse treten auf, wenn der Fokus als Reaktion auf eine Benutzeraktion verschoben wird, z. B. wenn Sie die TAB-TASTE drücken oder auf das Objekt klicken, oder wenn Sie die SetFocus-Methode in Visual Basic oder die SelectObject-, GoToRecord-, GoToControl- oder GoToPage-Aktion in einem Makro verwenden.

Ein Steuerelement kann den Fokus nur erhalten, wenn seine Eigenschaften Visible und Enabled auf Ja festgelegt sind. Ein Formular kann den Fokus nur erhalten, wenn es keine Steuerelemente enthält oder wenn alle sichtbaren Steuerelemente deaktiviert sind. Wenn ein Formular sichtbare, aktivierte Steuerelemente enthält, tritt das GotFocus-Ereignis für das Formular nicht auf.

Sie können angeben, was geschieht, wenn ein Formular oder Steuerelement den Fokus erhält, indem Sie beim Auftreten des GotFocus-Ereignisses ein Makro oder eine Ereignisprozedur ausführen. Beispielsweise können Sie durch Anfügen einer GotFocus-Ereignisprozedur an jedes Steuerelement eines Formulars den Benutzer durch die Anwendung führen, indem Sie kurze Anweisungen oder Meldungen in einem Textfeld anzeigen. Sie können auch visuelle Hinweise bereitstellen, indem Sie vom Steuerelement mit dem Fokus abhängende Steuerelemente aktivieren, deaktivieren oder anzeigen.

Hinweis

Um die Reihenfolge anzupassen, in der der Fokus beim Drücken der TAB-TASTE vom Steuerelement zum Steuerelement eines Formulars wechselt, legen Sie die Aktivierreihenfolge fest, oder geben Sie Zugriffstasten für die Steuerelemente an.

Das GotFocus-Ereignis unterscheidet sich vom Enter-Ereignis darin, dass das GotFocus-Ereignis jedes Mal auftritt, wenn ein Steuerelement den Fokus erhält. For example, suppose the user clicks a check box on a form, then clicks a report, and finally clicks the check box on the form to bring it to the foreground. The GotFocus event occurs both times the check box receives the focus. In contrast, the Enter event occurs only the first time the user clicks the check box. Das GotFocus-Ereignis tritt nach dem Enter-Ereignis auf.

Wenn Sie den Fokus auf ein Steuerelement eines Formulars verschieben, das nicht über den Fokus für dieses Formular verfügt, treten zuerst die Ereignisse Exit und LostFocus für das Steuerelement mit dem Fokus für dieses Formular auf. Anschließend treten die Ereignisse Enter und GotFocus für das Steuerelement auf, zu dem Sie gewechselt sind.

Wenn Sie zum Verschieben des Fokus von einem Steuerelement eines Hauptformulars auf ein Steuerelement eines Unterformulars dieses Formulars die Maus verwenden, treten die folgenden Ereignisse ein:

  • Exit (für das Steuerelement des Hauptformulars)
  • LostFocus (für das Steuerelement des Hauptformulars)
  • Enter (für das Unterformularsteuerelement)
  • Exit (für das Steuerelement des Unterformulars, das den Fokus hatte)
  • LostFocus (für das Steuerelement des Unterformulars, das den Fokus hatte)
  • Enter (für das Steuerelement des Unterformulars, das den Fokus erhalten hat)
  • GotFocus (für das Steuerelement des Unterformulars, das den Fokus erhalten hat)

Wenn das Steuerelement, zu dem Sie im Unterformular wechseln, zuvor den Fokus hatte, tritt weder das Enter-Ereignis noch das GotFocus-Ereignis auf, sondern das Enter-Ereignis für das Unterformular-Steuerelement. Wenn Sie den Fokus von einem Steuerelement auf einem Unterformular zu einem Steuerelement im Hauptformular verschieben, treten die Exit - und LostFocus-Ereignisse für das Steuerelement auf dem Unterformular nicht auf, nur das Exit-Ereignis für das Unterformular-Steuerelement und die Enter - und GotFocus-Ereignisse für das Steuerelement im Hauptformular.

Hinweis

Sie verwenden häufig die Maus oder eine Taste wie TAB, um den Fokus auf ein anderes Steuerelement zu verschieben. Dies führt dazu, dass zusätzlich zu den weiter oben erwähnten Ereignissen Mausereignisse oder Tastaturereignisse eintreten.

Wenn Sie zwischen zwei geöffneten Formularen wechseln, tritt das Deactivate-Ereignis für das erste Formular und das Activate-Ereignis für das zweite Formular auf. Wenn die Formulare keine sichtbaren aktivierten Steuerelemente enthalten, tritt das LostFocus-Ereignis für das erste Formular vor dem Deactivate-Ereignis und das GotFocus-Ereignis für das zweite Formular nach dem Activate-Ereignis auf.

Beispiel

Im folgenden Beispiel wird eine Meldung in einem Bezeichnungsfeld angezeigt, wenn ein Optionsfeld den Fokus erhält. Um das Beispiel auszuprobieren, fügen Sie die folgenden Ereignisprozeduren zu einem Formular mit dem Namen Kontakte hinzu, das eine Optionsschaltfläche mit dem Namen OptionYes und eine Bezeichnung namens LabelYes enthält.

Private Sub OptionYes_GotFocus() 
 Me!LabelYes.Caption = "Option button 'Yes' has the focus." 
End Sub 
 
Private Sub OptionYes_LostFocus() 
 Me!LabelYes.Caption = "" ' Clear caption. 
End Sub

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.