Wiki der Access Code Library

Gemeinsam zu mehr Effizienz in der Anwendungserstellung

ACLib-FilterForm-Wizard

Aus Access Code Library
Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

Mit dem FilterForm-Assistenten wird Code zum Filtern von Daten in einem Formular eingefügt.

Download

ACLibFilterFormWizard.zip

Letzte Änderung

Version 1.4.0: Filtereinträge aus gebundenem Formular erzeugen

Bedienung

Installation

  1. Download der Zip-Datei ACLibFilterFormWizard.zip
  2. Entpacken in ein beliebiges Verzeichnis
    • Die Zip-Datei einhält ein VB-Script (Install.vbs) zum Kopieren der Datei in das Access-Add-In-Verzeichnis.
  3. Access-Add-In installieren
    • Allgemeine Variante
      1. Access starten
      2. Access-Add-In-Manager öffnen
      3. Entpackte Datei ACLibFilterFormWizard.mda auswählen. Die Datei wird von Access ins Verzeichnis '%appdata%\Microsoft\AddIns' kopiert.
    • Install/Update-Variante mit Install.vbs
      1. Install.vbs ausführen
      2. Auswählen ob das Add-In als mde oder mdb verwendet werden soll (Empfehlung: mde)
        • Add-In wird ins Verzeichnis '%appdata%\Microsoft\AddIns' kopiert.
      3. Bei einem "Update" ist Installation abgeschlossen
        Für eine Erst-Installation sind noch folgende Schritte notwendig:
        1. Access starten
        2. Access-Add-In-Manager öffnen
        3. Filter-Form-Wizard auswählen und auf "Installieren" klicken
  4. Die ursprünglich entpackten Dateien können gelöscht werden.

Der FilterForm-Assistent ist ein Access Menü-Add-In und kann über das Add-In-Menü in der Menüleiste oder in der Multifunktionsleiste geöffnet werden.


Verwendung des Assistenten für den Import des Filter-Codes

Datei:ACL-FilterForm-Wizard_Filter_einstellen.png

Den FilterForm-Assistenten über das Add-In-Menü öffnen. Anschließend folgende Schritte in der Maske ausführen:

  1. Formular auswählen
  2. Optional: Steuerelemente zum Anwenden der Filterbedingungen und Löschen der Filterwerte auswählen
  3. Gewünschte Filter in der Maske eintragen
    • Datenfeld: das zu filternde Datenfeld
    • Datentyp: der Datentyp des Datenfeldes
    • Vergleichsoperator: Wie soll der Datenfeldinhalt mit dem Filterwert verglichen werden (>, >=, <, ...)
    • Steuerelement(e) auswählen
      • Steuerelement: das Steuerelement mit dem Filterwert
      • Weitere Steuerelemente: falls für den Filterausdruck mehr als ein Steuerelement benötigt wird (z. B. für Between), die Namen der Steuerelemente mit "," getrennt in dieses Feld eintragen
      • Falls das Steuerelement noch nicht im Formular enthalten ist, kann dieses durch aktivieren von "Neu" unterhalb der Steuerelementauswahl erstellt werden
  4. UseFilter-Methode wählen
    • auskommentierter Beispiel-Code: Es wird im Formular-Codemodul die Methode UseFilter erstellt, deren INhalt auskommentiert ist und manuell angepasst werden muss
    • aktuelles Formular filtern: Der Code in der UseFilter-Methode bezieht sich auf das aktuelle Formular unter Verwendung der Eigenschaft Form.Filter
    • Unterformular: das Unterformularsteuerelement im Dropdown auswählen, die UseFilter-Methode wird die Eigenschaft Form.Filter des Unterformulars verwenden
  5. Filter-Variante auswählen
    • FilterControlManager-Methoden: Die Filterung erfolgt über die Klasse FilterControlManager - dabei werden Änderungen in den Filter-Steuerelementen von der Klasse erfasst und entsprechend der Einstellung/Konfiguaration die Filterung der Daten ausgeführt
    • FilterStringBuilder-Methoden: Zum Filtern wird mittels Klasse FilterStringBuilder der Filterstring erzeugt, die Filterung erfolgt mittels Code innerhalb des Filter-Formulars
  6. benötigten SQL-Dialekt auswählen (Standard: Jet/DAO)
  7. Schaltfläche Formular-Code einfügen betätigen
  8. Den eingefügten Code an die eigenen Bedürfnisse anpassen.

Alle mit dem Wizard verwendeten Steuerelemente benötigen einen Namen ohne Leerzeichen, damit dieser 1:1 im VBA-Code verwendet werden kann.

Mittels Mausklick auf Klassen installieren können bereits vorhandene Codemodule (Klassen, Standardmodule) auf die im FilterForm-Wizard enthaltene Version aktualisiert werden.



Video: Filter-Formular mit der Unterstützung des FilterForm-Assistenten erstellen

Weiterführende Links: SQL-Text für Filterbedingung