TextBox.GotFocus-Ereignis (Access)

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

Syntax

Ausdruck verwendet werden. GotFocus

Ausdruck Eine Variable, die ein TextBox-Objekt darstellt.

Hinweise

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. durch Drücken der TAB-TASTE oder Klicken auf das Objekt, 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 Sichtbar und Aktiviert 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 in einem Formular vom Steuerelement zum anderen wechselt, wenn Sie die TAB-TASTE drücken, 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 empfängt. 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 auf dem Unterformular wechseln, zuvor den Fokus hatte, tritt weder das Ereignis "Enter " noch das Ereignis "GotFocus " auf, aber das Ereignis ENTER für das Steuerelement "Unterformular" tritt ein. Wenn Sie den Fokus von einem Steuerelement in einem Unterformular auf ein Steuerelement im Hauptformular verschieben, treten die Ereignisse Exit und LostFocus für das Steuerelement im Unterformular nicht auf, sondern nur das Exit-Ereignis für das Unterformularsteuerelement sowie die ENTER- und GotFocus-Ereignisse für das Steuerelement im Hauptformular.

Hinweis

Häufig wird die Maus oder eine Taste wie die Tabulatortaste verwendet, 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. Fügen Sie zum Testen des Beispiels die folgenden Ereignisprozeduren zu einem Formular mit dem Namen "Kontakte " hinzu, das ein Optionsfeld mit dem Namen "Wahlja " und eine Bezeichnung mit dem Namen "BezeichnungJa" 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.