Ungebundene List- und ComboBox per Callback

2023, 4/2023, Formulare und Steuerelemente

Im Beitrag “Ungebundene Listen und Kombis mit Daten füllen” (www.access-im-unternehmen.de/1440) haben wir uns angesehen, wir man Kombinations- und Listenfelder über das Zuweisen einer Wertliste oder mit der AddItem-Methode füllen kann. Es gibt noch eine interessante Alternative, von der wir hoffen, dass wir damit sogar noch einige Einträg mehr zu den Listen-Steuerelementen hinzufügen können als mit den oben genannten Methoden. Bei dieser Alternative handelt es sich um eine Technik, die eher stiefmütterlich behandelt wird: Die Callbackfunktion. Wie man diese nutzt und ob man tatsächlich mehr Daten als mit einer Wertliste in ungebundenen Listen-Steuerelementen anzeigen, untersuchen wir in diesem Beitrag.

Einfaches Beispiel für das Füllen per Callbackfunktion

Bevor wir uns daran begeben, die Daten umfangreicher Tabellen in ein Listenfeld zu füllen, schauen wir und die grundlegende Vorgehensweise beim Verwenden von Callback-Funktionen zum Füllen von Kombinations- und Listenfeldern an. Bei Verwendung einer Callbackfunktion nutzen wir keine der drei bekannten Möglichkeiten für die Eigenschaft Herkunftsart, sondern wir geben dort den Namen einer Funktion an.

Diese legen wir außerdem im Klassenmodul des Formulars an, in dem sich auch das Kombinations- oder Listenfeld befindet. Die Callbackfunktion muss einen speziellen Aufbau haben. Zumindest die Parameter müssen nach einem festen Schema angegeben werden und auch innerhalb der Funktion sind einige Regel zu beachten, damit diese wie gewünscht arbeitet. Für ein einfaches Beispiel fügen wir einem Formular ein Listenfeld hinzu, für dessen Eigenschaft Herkunftstyp wie den Namen der Callbackfunktion angeben, in diesem Fall Beispielcallback (siehe Bild 1).

Listenfeld mit Callback-Funktion

Bild 1: Listenfeld mit Callback-Funktion

Aufbau und Parameter der Callbackfunktion

Die Callbackfunktion erwartet bestimmte Parameter, die beim Aufruf automatisch von dem Steuerelement, dem sie zugeordnet ist, übergeben werden. Der Kopf der Prozedur sieht so aus:

Function Beispielcallback(ctl As Control, lngID As Long, _
          lngRow As Long, lngColumn As Long, _
          intCode As Integer) As Variant

Die hier verwendeten Parameter liefern die folgenden Werte:

  • ctl: Verweis auf das Steuerelement, für welches die Callbackfunktion aufgerufen wurde. Dies ist sinnvoll, falls es mehr als ein Steuerelement gibt, das die gleiche Callbackfunktion aufruft – was aber eher selten der Fall sein dürfte.
  • lngID: Liefert eine eindeutige ID für das aufrufende Steuerelement.
  • lngRow: Gibt an, für welche Zeile ein Wert abgefragt wird.
  • lngColumn: Gibt an, für welche Spalte ein Wert abgefragt wird.
  • intCode: Gibt die aktuelle Funktion des Aufrufs an.

Mit dem Rückgabewert mit dem Datentyp Variant übergeben wir die jeweils angeforderten Informationen an das Steuerelement.

Aufbau der Callbackfunktion

Die Callbackfunktion muss, damit sie korrekt funktioniert und das Steuerelement wie gewünscht gefüllt wird, die mit dem Parameter intCode angefragten Informationen zusammenstellen und zurückliefern. intCode kann verschiedene Werte annehmen, für die jeweils Konstanten definiert sind. Diese lauten:

  • acLBInitialize (0): Dieser Wert für intCode wird beim ersten Aufruf der Callback-Funktion übergeben. Hier wird geprüft, ob das Kombinations- oder Listenfeld überhaupt mit dieser Funktion gefüllt werden soll. Falls ja, muss der Wert True als Rückgabewert der Funktion festgelegt werden.
  • acLBOpen (1): Beim Aufruf der Funktion mit dem Wert acLBOpen für den Parameter intCode erwartet Access eine Zahl als Rückgabewert, die das Steuerelement, von dem aus die Callback-Funktion aufgerufen wurde, eindeutig identifiziert. Hintergrund ist, dass man theoretisch mehrere Steuerelemente mit der gleichen Callbackfunktion ausstatten kann. Wenn sichergestellt ist, dass nur ein Steuerelement diese Funktion als Wert für die Eigenschaft Herkunftsart verwendet, können Sie hier einfach den Wert 1 als Funktionswert angeben. Anderenfalls geben Sie das Ergebnis der Funktion Timer zurück, welche die Zeit in Millisekunden berechnet – dies geht nur schief, wenn die Funktion zweimal in der gleichen Millisekunde aufgerufen wird, was unwahrscheinlich ist.
  • acLBGetRowCount (3): Dieser Aufruf der Funktion soll die Anzahl der zu füllenden Zeilen ermitteln. Dies ist der geeignete Ort, um die anzuzeigenden Daten zusammenzustellen.
  • acLBGetColumnCount (4): Dieser Funktionsaufruf erwartet die Übergabe der Anzahl der zu füllenden Spalten.
  • acLBGetColumnWidth (5): Dieser Funktionsaufruf erwartet die Übergabe der Breiten der zu füllenden Spalten.
  • acLBGetValue (6): Die Callback-Funktion wird für jedes anzuzeigende Elemente einmal mit dem Wert acLBGetValue für den Parameter intCode aufgerufen. Die Anzahl der Elemente ergibt sich aus dem Produkt aus Zeilen- und Spaltenzahl. Welche Zeile und Spalte gerade abgefragt wird, können Sie den weiteren Parametern lngRow und lngColumn entnehmen.
  • acLBGetFormat (7): Auch der Aufruf mit diesem Parameterwert erfolgt für jedes anzuzeigende Element einmal. Hier können Sie die Formatierung der Listeneinträge vornehmen (standardmäßig -1).
  • acLBClose (8), acLBEnd (9): Diese beiden Parameter werden in weiteren Aufrufen der Callback-Funktion nach dem Füllen des Steuerelements übergeben. Damit können Sie beispielsweise den Zeitpunkt erfassen, zu dem das Steuerelement komplett gefüllt ist.

Beispiel für eine Callbackfunktion

Nachfolgend haben wir das denkbar einfachste Beispiel für eine Callbackfunktion zusammengestellt:

Function Beispielcallback(ctl As Control, _
         lngID As Long, lngRow As Long, _
         lngColumn As Long, intCode As Integer) _
         As Variant
     Select Case intCode
         Case acLBInitialize
             Beispielcallback = True
         Case acLBOpen
             Beispielcallback = 1
         Case acLBGetRowCount
             Beispielcallback = 1
         Case acLBGetColumnCount
             Beispielcallback = 1
         Case acLBGetColumnWidth
             Beispielcallback = -1
         Case acLBGetValue
             Beispielcallback = "Test"
         Case acLBGetFormat
             Beispielcallback = Null
         Case Else
             Debug.Print intCode
     End Select
End Function

Du hast das Ende des frei verfügbaren Textes erreicht. Möchtest Du ...

Oder bist Du bereits Abonnent und hast Zugangsdaten? Dann logge Dich gleich hier ein:
Die Zugangsdaten findest Du im aktuellen gedruckten Heft oder in der E-Mail, die Du als Abonnent mit jeder neuen Ausgabe erhältst.

Schreibe einen Kommentar