5 Die Datenbank Eine bestehende Multifunktionsleiste anpassen Eine neue Multifunktionsleiste erstellen 218

Transkript

1 5 Die Datenbank Eine bestehende Multifunktionsleiste anpassen In der Datenbank EIGENELEISTE.ACCDB gibt es das Formular frmkunden. Wenn dieses Formular geöffnet wird, erscheint eine zusätzliche Registerkarte namens Wichtig. Diese Registerkarte enthält die beiden Gruppen Zwischenablage und Drucken. Die Gruppe Zwischenablage fasst die drei vordefinierten Befehle Ausschneiden, Kopieren und Einfügen zusammen. In der zweiten Gruppe finden Sie zwei Schaltflächen für das Öffnen und Schließen des Formulars in der Seitenansicht. Alle selbst definierten Registerkarten werden mit dem Tagpaar <tabs> und </tabs> zusammengefasst. Die Registerkarte und jede Gruppe besitzen einen eindeutigen Namen ( id ) und eine Beschriftung ( label ). Alle fünf eingebauten Schaltflächen werden mit dem Schlüsselwort control eingeleitet. Welche vordefinierte Schaltfläche erscheinen soll, wird über ihre idmso angegeben. Die Beschriftung in der Schaltfläche neben dem Symbol ist frei vergebbar ( label ). Der Zustand jeder Schaltfläche wird zudem aktiviert. <customui xmlns=" <ribbon startfromscratch="false"> <tabs> <tab id="bdwichtig" label="wichtig" visible="true"> <group id="bdzwischenablage" label="zwischenablage"> <control idmso="cut" label="ausschneiden" enabled="true"/> <control idmso="copy" label="kopieren" enabled="true"/> <control idmso="paste" label="einfügen" enabled="true"/> <group id="bddrucken" label="drucken"> <control idmso="fileprintpreview" label="seitenansicht" enabled="true" imagemso="fileprintpreview"/> <control idmso="printpreviewclose" label="schließen" enabled="true" imagemso="printpreviewclose"/> </tab> </tabs> </ribbon> </customui> Bis jetzt wurden nur eingebaute Schaltflächen in der eigenen Registerkarte verwendet. Im nächsten Beispiel, in dem die Multifunktionsleiste nicht erweitert, sondern vollständig neu erzeugt wird, werden selbst definierte Schaltflächen eingesetzt. Eine neue Multifunktionsleiste erstellen Wenn Sie das Attribut startfromscratch des Befehls ribbon auf True setzen, erstellen Sie eine komplett neue Multifunktionsleiste. Es werden alle vordefinierten Registerkarten und auch die Registerkarte Add-Ins versteckt. Zudem wird der Inhalt des DATEI-Menüs geändert, das über die Office -Schaltfläche geöffnet wird. Es werden dann nur noch die Menüpunkte für eine neue Datenbank zum Öffnen, Speichern, Drucken und zum Datenbankschließen sowie die beiden Schaltflächen Access-Optionen und Access beenden angezeigt. Außerdem wird durch diese Vorgehensweise auch die Symbolleiste für den Schnellzugriff nicht mehr angezeigt. Im Dialogfeld Access-Optionen kann zwar noch die Seite 218

2 5.4 Eine Datenbankanwendung erstellen Anpassen in den Vordergrund geholt werden, jedoch ist es nicht mehr möglich, weitere Befehle aus der linken Liste in die rechte Liste zu kopieren. Die Schaltfläche Hinzufügen bleibt deaktiviert. Über den nachfolgenden XML-Code wird ein benutzerdefinierte Multifunktionsleiste angelegt. Diese Leiste enthält die beiden Registerkarten Vorgänge und Hilfe. Die erstgenannte Registerkarte beinhaltet die drei Gruppen Kunden, Weitere Daten und Formulare, die zweite Registerkarte verfügt über die beiden Gruppen Anwendung Info und Hilfe Info. Die Gruppe Kunden fasst die zwei Schaltflächen Kunden bearbeiten und Kunden drucken zusammen. Die Gruppe Weitere Daten fasst die zwei Schaltflächen Bestellungen und Details und Artikel zusammen, wobei die letztgenannte Schaltfläche zusätzlich das Standardsymbol für die Sicherheit (imagemso="private") anzeigt. In der dritten Gruppe der Registerkarte Vorgänge befindet sich eine Drop-down-Liste, die alle Formulare der Datenbank auflistet. Auch sie besitzt neben der Beschriftung noch über ein Standardsymbol. In der Gruppe Anwendung Info der Registerkarte Hilfe wird nur ein feststehender Text angezeigt. Die zweite Gruppe enthält eine Umschaltfläche ( togglebutton ) namens Hilfe und eine normale Befehlsschaltfläche. Die beiden Schaltflächen sind durch eine senkrechte Linie ( Separator ) voneinander getrennt. <customui xmlns=" onload="onribbonload"> <ribbon startfromscratch="true"> <tabs> <tab id="tabadmin" label="vorgänge"> <group id="grpkunden" label="kunden"> <button id="btnfrmkunden" label="kunden bearbeiten" size="large" onaction="onopenform" tag="frmkunden"/> <button id="btnrptkunden" label="kunden drucken" size="large" onaction="onopenreport" tag="rptkunden"/> <group id="grpbestell" label="weitere Daten"> <button id="btnfrmbestell" label="bestellungen und Details" size="large" onaction="onopenform" tag="frmbestellungen Hauptformular"/> <button id="btnfrmartikel" label="artikel" size="large" imagemso="private" onaction="onopenform" tag="frmartikel"/> <group id="grpartikel" label="formulare"> <dropdown id="ddformlist" label="formulare" imagemso="addtofavorites" getitemcount="ongetformcount" GetItemLabel="onGetFormNames" onaction="ondropdownaction"/> </tab> <tab id="tabhelp" label="hilfe"> <group id="grpanwinfo" label="anwendung Info"> <labelcontrol id="lblbsp1" label="beispiel zur eigenen"/> <labelcontrol id="lblbsp2" label="multifunktionsleiste"/> <group id="grphilfe" label="hilfe Info"> 219

3 5 Die Datenbank <togglebutton id="tglhilfe" label="hilfe" size="large" onaction="onshowhelp"/> <separator id="sep1"/> <button id="btninfo" label="info" size="large" onaction="onopenform" tag="frminfo"/> </tab> </tabs> </ribbon> </customui> Jedes Steuerelement in der Multifunktionsleiste besitzt einen eindeutigen Namen, der über das Attribut id festgelegt ist, und normalerweise auch eine Beschriftung, die mit dem Attribut label definiert wird. Dabei kann es sich bei dem Steuerelement um eine Registerkarte, eine Gruppe, eine Befehlsschaltfläche, eine Drop-down-Liste etc. handeln. Damit durch einen Klick auf eine Schaltfläche eine Aktion erfolgt, ist allen Schaltflächen und auch der Drop-down-Liste das Attribut onaction zugeordnet, dem der Name einer Callback-Prozedur übergeben wird. Dabei kann es sich um dieselbe oder um unterschiedliche Subprozeduren handeln. Wenn der Callback-Prozedur ein Parameter, wie der Name eines bestimmten Formulars, übergeben werden soll, kann dafür das Attribut tag verwendet werden. Die Drop-down-Liste besitzt noch zwei weitere Callback- Prozeduren, die mit den beiden Attributen getitemcount und getitemlabel verbunden werden. Das äußerste Element in der XML-Datei mit dem Namen customui aktiviert auch eine Callback-Prozedur. Dies geschieht direkt beim Laden des XML-Codes und Anzeigen der Multifunktionsleiste. Das entsprechende Attribut lautet onload. Schritt 2: VBA-Prozeduren schreiben Wenn Sie benutzerdefinierte Steuerelemente in der Multifunktionsleiste einsetzen, müssen im zweiten Schritt die dazugehörigen Prozeduren (Callback-Prozeduren) programmiert werden, die festlegen, welche Aktionen ausgeführt werden sollen. Dabei sollten folgende Punkte berücksichtigt werden: Es muss ein Verweis auf die Objektbibliothek Microsoft Office 12.0 Object Library existieren. Diesen Verweis stellen Sie über das Verweise -Dialogfeld über das Menü EXTRAS in der VBA-Entwicklungsumgebung ein. Die Übergabeparameter der verschiedenen Subprozeduren sind fest definiert. Der Name der Prozeduren ist frei wählbar. Häufig kann eine Subprozedur für mehrere Ereignisse benutzt werden. Das Attribut tag des buttons -Befehls in der XML-Datei kann zum Beispiel zum Speichern des Formular- oder Berichtsnamens eingesetzt werden. Auf diese Weise können mehrere Datenbankobjekte mit derselben Prozedur geöffnet werden. Um die Multifunktionsleiste zu aktualisieren, rufen Sie die Invalidate -Methode und die Refresh -Methode des IRibbonUI -Objekts auf. In der OnLoad -Subprozedur erstellen Sie dafür einen Verweis auf die aktuelle Multifunktionsleiste, die gerade geladen und angezeigt wird. 220

4 5.4 Eine Datenbankanwendung erstellen Jede Callback-Prozedur besitzt einen bestimmten, fest definierten Aufbau mit fast immer einem oder mehreren Übergabeparametern. Den Name der Prozedur dürfen Sie festlegen. Die Verbindung zwischen der Prozedur und dem Ereignis, bei dem die Prozedur aufgerufen werden soll, erfolgt im XML-Code bei dem entsprechenden Steuerelement über ein Attribut, das zum Beispiel onaction oder onload heißen kann. In der nachfolgenden Tabelle werden einige häufig verwendete Callback-Prozeduren aufgelistet. Tabelle 5.14 Steuerelemente und ihre Callback-Prozeduren Steuerelemente customui Alle Steuerelemente Alle Steuerelemente button checkbox, togglebutton dropdown dropdown dropdown editbox VBA-Syntax der Callback-Prozedur Sub onload(ribbon As IRibbonUI) Sub GetVisible(control as IRibbonControl, ByRef visible) sub GetEnabled(control as IRibbonControl, ByRef enabled) Sub OnAction(control as IRibbonControl) Sub OnAction(control as IRibbonControl, pressed as Boolean) sub GetItemCount(control as IRibbonControl, ByRef count) sub GetItemLabel(control as IRibbonControl, index as Integer, ByRef label) sub OnAction(control as IRibbonControl, selectedid as String, selectedindex as Integer) sub OnChange(control as IRibbonControl, text as String) In der Datenbank EIGENELEISTE.ACCDB existiert das Modul Multifunktionsleiste, in dem die für dieses Beispiel notwendigen Callback-Prozeduren definiert sind. Oberhalb jeder Subprozedur steht ein erklärender Kommentar, sodass Sie sofort wissen, zu welchem Attribut die Callback-Prozedur gehört. Alle onaction -Prozeduren verfügen über den Übergabeparameter control, über den Sie auf das Steuerelement und dessen Attribute im XML-Code zugreifen können. Auf diese Weise kann über das tag -Attribut der Formular- beziehungsweise Berichtsname an die Methode OpenForm beziehungsweise OpenReport des DoCmd -Objekts übergeben werden. Um die Drop-down-Liste mit den Namen aller Formulare zu füllen, werden die beiden Callback-Prozeduren ongetformcount und ongetformnames gebraucht. Wenn ein Eintrag aus der Liste vom Anwender ausgewählt wird, soll dieses Formular automatisch geöffnet werden. Diese Arbeit führt die Callback-Prozedur OnDropDownAction durch. Im Übergabeparameter selectedindex steht der Index des selektierten Listeneintrags. Dieser Index kann der Auflistung AllForms übergeben werden, da in beiden Fällen der Index bei 0 beginnt. Durch einen Klick auf die Umschaltfläche ( togglebutton ) soll abwechselnd das Formular frmhilfe geöffnet und wieder geschlossen werden. Die zum Attribut onaction zugeordnete Callback-Prozedur onshowhelp besitzt als zweites Argument 221

5 5 Die Datenbank pressed, das den aktuellen Status der Umschaltfläche angibt. Darüber kann entschieden werden, ob das Formular geöffnet oder geschlossen werden muss. '******************** EIGENELEISTE.ACCDB *************** '********************** Modul Multifunktionsleiste****** Option Compare Database Option Explicit Public MLeiste As IRibbonUI ' verbunden mit onload-callback der Multifunktionsleiste ' Verweis auf die Multifunktionsleiste merken Public Sub onribbonload(ribbon As IRibbonUI) Set MLeiste = Ribbon ' verbunden mit onaction-callback von Buttons ' Formulare öffnen Public Sub onopenform(control As IRibbonControl) DoCmd.OpenForm control.tag ' verbunden mit onaction-callback eines Buttons ' Berichte in der Seitenansicht darstellen Public Sub onopenreport(control As IRibbonControl) DoCmd.OpenReport control.tag, acviewpreview ' verbunden mit onaction-callback des Hilfe-Buttons ' Toggle Button zum Öffnen und Schließen des Hilfe-Formulars Public Sub onshowhelp(control As IRibbonControl, pressed As Boolean) If (pressed) Then DoCmd.OpenForm "frmhilfe" Else DoCmd.Close acform, "frmhilfe" End If ' verbunden mit getitemcount-callback der Drop-down-Liste ' Anzahl der Formulare ermitteln Public Sub ongetformcount(control As IRibbonControl, ByRef count) count = CurrentProject.AllForms.count ' verbunden mit getitemlabel-callback der Drop-down-Liste ' Drop-down-Liste mit Formularen füllen Public Sub ongetformnames(control As IRibbonControl, index As Integer, ByRef label) ' set the label label = CurrentProject.AllForms(index).Name ' verbunden mit onaction-callback der Drop-down-Liste ' Gewähltes Formular aus der Drop-down-Liste öffnen Sub OnDropDownAction(control As IRibbonControl, selectedid As String, selectedindex As Integer) DoCmd.OpenForm CurrentProject.AllForms(selectedIndex).Name ' für spätere Erweiterungen Public Sub fktmleisteaktualisieren() ' zwischengespeicherte Werte für die Steuerelemente ' in der Multifunktionsleiste auf ungültig setzen MLeiste.Invalidate ' Multifunktionsleiste komplett aktualisieren MLeiste.Refresh 222

6 6 Tabellen Objekte für den Datentyp Anlage verwenden Access 2007 besitzt den neuen Datentyp Anlage für Tabellenfelder, der mehrere Bilder, Dokumente etc. enthalten kann. Um auf diesen Inhalt zugreifen zu können, wurden die neuen DAO-Objekte ComplexType, Recordset2 und Field2 eingeführt. Die zwei zuletzt genannten verhalten sich wie die bereits vorgestellten Recordset - und Field - Objekt mit dem Unterschied, dass sie zusätzliche Eigenschaften und Methoden besitzen. Die Funktion fktkundenanlage öffnet die Tabelle Kunden-Daten, die unter anderem das Feld Dokus mit dem Datentyp Anlage besitzt. Dabei wird der DAO-Objekttyp Recordset2 benutzt, um überhaupt auf das Feld Dokus zugreifen zu können. Falls es sich um ein Feld mit dem Datentyp Anlage handelt, steht in der Eigenschaft IsComplex der Wert True. Zusätzlich besitzt dieses Feld dann die Eigenschaft ComplexType, die ein gleichnamiges Objekt enthält, das auf die Anlagen verweist. Dieses Objekt besitzt die Auflistung Fields, in der alle Felder dieses speziellen Objekttyps hinterlegt sind. Diese Felder werden im Direktbereich unterhalb des Name dieses Felds Dokus aufgelistet. '***************** BASICPRG.ACCDB ***************** '******************* Modul: Anlagen *************** Function fktkundenanlage() As Variant Dim dbdatenbank As DAO.Database Dim dtnamenstab As DAO.Recordset2 Dim flddoku As DAO.Field Set dbdatenbank = CurrentDb Set dtnamenstab = dbdatenbank.openrecordset("kunden-daten", dbopentable) Debug.Print "Datentyp Anlage: " & dtnamenstab.dokus.name Debug.Print "IsComplex: " & dtnamenstab.dokus.iscomplex Debug.Print "Felder dieses Typs:" For Each flddoku In dtnamenstab.dokus.complextype.fields Debug.Print " " & flddoku.name Next flddoku dtnamenstab.close dbdatenbank.close End Function Über die Methode SaveToFile können die Anlagen eines Datensatzes, die in einem Feld des Datentyps Anlage hinterlegt sind, in ein bestimmtes Verzeichnis gespeichert werden. Dazu wird eine Variable vom Typ Recordset2 benötigt, in die ein Verweis auf den Wert des Tabellenfelds Dokus geschrieben wird. Anschließend kann in einer Schleife über das Feld FileData auf jedes einzelne Dokument in dieser Anlage zugegriffen werden. Die Funktion fktanlagenspeichern sichert die Anlagen des ersten Datensatzes der Tabelle Kunden-Daten in das Verzeichnis E:\TEMP\Anlage. Dieses Verzeichnis muss existieren, damit das Beispiel funktionieren kann. '***************** BASICPRG.ACCDB ***************** '******************* Modul: Anlagen *************** Function fktanlagenspeichern() Dim dbdatenbank As DAO.Database 310

7 6.2 Auf Daten in Tabellen mit DAO und ADO zugreifen Dim dtnamenstab As DAO.Recordset Dim dtanlage As DAO.Recordset2 Set dbdatenbank = CurrentDb Set dtnamenstab = dbdatenbank.openrecordset("kunden-daten", _ dbopentable) Debug.Print "Firma: " & dtnamenstab.fields(1).value Set dtanlage = dtnamenstab.fields("dokus").value While Not dtanlage.eof dtanlage.fields("filedata").savetofile "E:\TEMP\Anlage" dtanlage.movenext Wend Debug.Print "Anlagen sind gespeichert im Verzeichnis E:\TEMP\Anlage" dtanlage.close dtnamenstab.close dbdatenbank.close End Function Verschiedene Cursor-Arten in ADO einsetzen Auch im ADO-Objektmodell wird mit Recordsets gearbeitet. Um in ADO ein Recordset zu erstellen, wird dessen Open -Methode benutzt. Über diese Methode können Tabellen geöffnet, doch keine neuen Tabellen erzeugt werden recordset.open Source, ActiveConnection, CursorType, LockType, Options Tabelle 6.12 Parameter der Methode Open des Objekts Recordset bei ADO Parameter Source ActiveConnection CursorType LockType Optionen Kurzbeschreibung Name der Tabelle, Abfrage, Sicht oder SQL-Anweisung Verweis auf ein Connection -Objekt oder ConnectionString Zulässiger Cursor-Arten Legt das Sperrverfahren fest. Ermöglicht weitere Optionen wie zum Beispiel den direkten Zugriff auf Tabellen. Cursor-Arten Die verschiedenen Cursor-Arten legen die Möglichkeiten der Datensatznavigation, der Aktualisierbarkeit von Daten und der sichtbaren Darstellung von Datenänderungen durch andere Benutzer fest. Sie sind mit den Recordsettypen des DAO-Objektmodells vergleichbar. Ein dynamischer Cursor ( adopendynamic ) ermöglicht das Anzeigen, Ändern und Löschen. Es sind auch Änderungen von anderen Benutzern sichtbar. Ein Cursor vom Typ Schlüsselgruppe ( adopenkeyset ) ähnelt dem dynamischen Cursor, doch sind Änderungen, die andere Benutzer ausführen, nicht sichtbar. 311