ToggleButton.DblClick-Ereignis (Access)

Das DblClick-Ereignis tritt auf, wenn der Benutzer vor dem Systemzeitlimit für das Doppelklicken zweimal hintereinander die linke Maustaste drückt und wieder loslässt, während sich der Mauszeiger auf einem Objekt befindet.

Syntax

Ausdruck. DblClick (Abbrechen)

Ausdruck Eine Variable, die ein ToggleButton-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Abbrechen Erforderlich Integer Durch die Einstellung wird bestimmt, ob das DblClick-Ereignis auftritt. Wenn Sie das Cancel-Argument auf True (1) festlegen, wird das DblClick-Ereignis abgebrochen.

HinwBemerkungeneise

Auf einem Formular tritt das DblClick-Ereignis auf, wenn der Benutzer auf einen leeren Bereich oder datensatzauswahl auf dem Formular doppelklicken. Für ein Steuerelement tritt dieses Ereignis ein, wenn der Benutzer in der Formularansicht auf das Steuerelement oder dessen Bezeichnungsfeld doppelklickt. Das DblClick-Ereignis tritt ein, wenn der Benutzer auf das Formular oder Steuerelement doppelklickt, jedoch bevor das Ergebnis des Doppelklickens angezeigt wird (z. B. bevor Microsoft Access das Wort auswählt, auf dem sich die Einfügemarke in einem Textfeld befindet).

Dieses Ereignis gilt nicht für Kontrollkästchen, Optionsfelder oder Umschaltflächen in einer Optionsgruppe. Sie betrifft nur die Optionsgruppe selbst.

Dieses Ereignis gilt nicht für eine Bezeichnung, die an ein anderes Steuerelement angefügt ist, z. B. die Bezeichnung für ein Textfeld. Es gilt lediglich für "frei stehende" Bezeichnungsfelder. Das Doppelklicken auf eine angefügte Bezeichnung hat die gleiche Auswirkung wie das Doppelklicken auf das zugeordnete Steuerelement. Die normalen Ereignisse für das Steuerelement treten auf, aber keine Ereignisse für die angefügte Bezeichnung.

Um ein Makro oder eine Ereignisprozedur auszuführen, wenn dieses Ereignis auftritt, legen Sie die OnDblClick-Eigenschaft auf den Namen des Makros oder auf [Ereignisprozedur] fest.

Bei Steuerelementen hängt das Ergebnis des Doppelklickens vom Steuerelement ab. So wird z. B. durch das Doppelklicken auf ein Wort in einem Textfeld das gesamte Wort ausgewählt. Beim Doppelklicken auf ein Steuerelement, das ein OLE-Objekt enthält, wird die Anwendung, mit der das Objekt erstellt wurde, zur Bearbeitung des Objekts gestartet.

Wenn das DblClick-Ereignis nicht innerhalb des Doppelklick-Zeitlimits des Systems auftritt, erkennt das Formular, der Formularabschnitt oder das Steuerelement anstelle eines einzelnen DblClick-Ereignisses zwei Click-Ereignisse. Das Zeitlimit für Doppelklicks hängt von der Einstellung unter Doppelklickgeschwindigkeit auf der Registerkarte Schaltflächen der Option Maus des Windows-Systemsteuerung ab.

Durch Ausführen eines Makros oder einer Ereignisprozedur beim Eintreten des DblClick-Ereignisses können Sie ein Fenster oder ein Dokument öffnen, wenn Sie auf ein Symbol doppelklicken.

Durch Doppelklicken auf ein Steuerelement treten die Ereignisse Click und DblClick auf. Wenn der Fokus beim Doppelklicken noch nicht auf das Steuerelement gesetzt ist, treten vor den Ereignissen Click und DblClick zunächst die Ereignisse Enter und GotFocus für das Steuerelement auf.

Bei Objekten, die auf Mausereignisse reagieren, treten die Ereignisse in der folgenden Reihenfolge ein:

MouseDownMouseUpClickDblClick

Wenn Sie auf eine Befehlsschaltfläche doppelklicken, treten die folgenden Ereignisse in der angegebenen Reihenfolge ein:

MouseDownMouseUpClickDblClickMouseUpClick

Der zweite Klick hat möglicherweise keine Auswirkung (z. B. wenn das Click-Makro oder die Ereignisprozedur als Reaktion auf das erste Auftreten des Click-Ereignisses ein gebundenes Dialogfeld öffnet). Um zu verhindern, dass das zweite Click-Makro oder die zweite Ereignisprozedur ausgeführt wird, fügen Sie eine CancelEvent-Aktion in das DblClick-Makro ein, oder verwenden Sie das Cancel-Argument in der DblClick-Ereignisprozedur . Im Allgemeinen sollte ein Doppelklicken auf eine Befehlsschaltfläche unterbunden werden.

Wenn Sie auf ein anderes Steuerelement als eine Befehlsschaltfläche doppelklicken, tritt das zweite Click-Ereignis nicht auf.

Beispiel

Das folgende Beispiel zeigt, wie Sie mit einer DblClick-Ereignisprozedur ein Formular öffnen können, das Datensätze aus der Tabelle anzeigt, die die Datenquelle eines Kombinationsfelds ist. Wenn der Benutzer in einem Bestellformular auf das Kombinationsfeld Salesperson doppelklicken, wird das Formular Mitarbeiter angezeigt, in dem der Datensatz für den im Kombinationsfeld ausgewählten Mitarbeiter angezeigt wird.

Um das Beispiel auszuprobieren, fügen Sie die folgende Ereignisprozedur zu einem Formular namens Orders hinzu, das ein Kombinationsfeld mit dem Namen EmployeeID enthält. Das Kombinationsfeld sollte als Zeilenquelle dieselbe Tabelle aufweisen, die die Quelle für das Formular Mitarbeiter ist (oder eine Abfrage, die auf dieser Tabelle basiert).

Private Sub EmployeeID_DblClick(Cancel As Integer) 
 DoCmd.OpenForm "Employees", , , _ 
 "EmployeeID = Forms!Orders!EmployeeID" 
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.