{"id":55000703,"date":"2010-02-01T00:00:00","date_gmt":"2020-05-22T22:10:49","guid":{"rendered":"http:\/\/access-im-unternehmen.aix-dev.de\/aiu\/?p=703"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-30T00:00:00","slug":"VBACode_mit_Doxygen_dokumentieren","status":"publish","type":"post","link":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/","title":{"rendered":"VBA-Code mit Doxygen dokumentieren"},"content":{"rendered":"<p><img loading=\"lazy\" decoding=\"async\" src=\"http:\/\/vg05.met.vgwort.de\/na\/68e838ada7404990afe6629abc74d7ad\" width=\"1\" height=\"1\" alt=\"\"><\/p>\n<p><b>Jeder Programmierer muss einmal Farbe bekennen: N&auml;mlich, wenn er &auml;ltere, umfangreiche und komplexe Anwendungen wieder ausgr&auml;bt und sich in diese einarbeitet, weil der Kunde &auml;nderungsw&uuml;nsche &auml;u&szlig;ert. Wohl dem, der gut dokumentiert hat &#8211; er findet sich mit Sicherheit gleich besser zurecht als ohne Dokumentation. Noch einfacher haben Sie es, wenn Sie Methoden und Eigenschaften Ihrer Anwendungen sch&ouml;n &uuml;bersichtlich in einer Hilfedatei nachlesen k&ouml;nnen. Doch wer betreibt schon einen solchen Aufwand Die Antwort ist einfach: Jeder, der Spa&szlig; daran und den vorliegenden Beitrag gelesen hat.<\/b><\/p>\n<p><b>Wozu externe Code-Dokumentation<\/b><\/p>\n<p>Sie werden sicher zustimmen, dass Kommentare im Code die Lesbarkeit erh&ouml;hen. Eine Beschreibung der Aufgabe einer Prozedur und die Bedeutung der Parameter erleichtert deren Verwendung. Auch Kommentare im Code-Block vereinfachen ihre &Uuml;berarbeitung, wenn man nach einiger Zeit in einer Prozedur einen Fehler beseitigen muss oder eine Erweiterung einbauen m&ouml;chte.<\/p>\n<p>Doch warum sollten Sie Code-Kommentare in einer Hilfedatei oder einer <b>.html<\/b>-Seite bereitstellen, wenn der Kommentar jederzeit im Code nachgelesen werden kann F&uuml;r folgende Szenarien ist eine externe Hilfe-Datei sinnvoll:<\/p>\n<ul>\n<li class=\"aufz-hlung\">Code-Bibliotheken (Access-mde\/accde oder COM-dll)<\/li>\n<li class=\"aufz-hlung\">Schnittstellenbeschreibungen <\/li>\n<li class=\"aufz-hlung\">Modularer Anwendungsaufbau (inkl. Kapselung von Code in Klassen)<\/li>\n<\/ul>\n<p>Davon abgesehen kann es nat&uuml;rlich auch so n&uuml;tzlich sein, nicht jedes Mal im Modul einzelne Objekte oder Methoden aufzusuchen, wenn man einmal eine Beschreibung nachsehen m&ouml;chte &#8211; zumal ja meist auch noch eine Menge Code enthalten ist und die Beschreibungen nicht gleich erkennbar sind.<\/p>\n<p>Ein Kommentar in einer privaten (nach au&szlig;en nicht sichtbaren) Prozedur einer Klasse hat f&uuml;r eine externe Code-Dokumentation eher wenig Bedeutung, da f&uuml;r den Benutzer dieser Klasse die internen Methoden nach dem Konzept der Kapselung keine Rolle spielen.<\/p>\n<p>Den Benutzer einer solchen Klasse interessieren viel mehr die nach au&szlig;en sichtbaren Elemente wie Methoden, Eigenschaften und Ereignisse. Fasst man deren Beschreibung in einer gut lesbaren Struktur zusammen, entsteht ein n&uuml;tzliches Werkzeug zum Schreiben von Code, der auf die Klasse zugreift, da nicht immer in der Klasse nachgelesen werden muss.<\/p>\n<p>Stellen Sie sich einmal vor, wenn zum Access-Objekt-Modell keine Online-Hilfe verf&uuml;gbar w&auml;re.<\/p>\n<p>Jeder Access-VBA-Programmierer w&uuml;rde viel Zeit mit der Suche nach den passenden Parameter-Werten der Methoden aus diesen Access-Klassen verschwenden. Mit der Online-Hilfe reicht ein Blick in die Dokumentation der betroffenen Methode und man erh&auml;lt einen &Uuml;berblick &uuml;ber die Einsatzm&ouml;glichkeiten. <\/p>\n<p>Mit dem Einsatz des OpenSource-Tools <b>Doxygen<\/b> k&ouml;nnen Sie eine &auml;hnliche Dokumentation Ihres Codes erreichen, ohne besonderen Mehraufwand durch die Dokumentation zu betreiben. Sie m&uuml;ssen nur die Anmerkungen, die Sie zu Prozeduren, Modul-K&ouml;pfen und so weiter schreiben, in eine f&uuml;r Doxygen erkennbare Form bringen (s. Listing 1).<\/p>\n<p class=\"kastentabelleheader\">Listing 1: Beispiel f&uuml;r Prozedur-Kommentar <\/p>\n<pre>''-------------------------------------------------------------------\r\n'' Function: DeleteTableDef (2009-06-28)\r\n''-------------------------------------------------------------------\r\n''\/**\r\n'' &lt;summary&gt;\r\n'' Tabelle im Frontend l&ouml;schen\r\n'' &lt;\/summary&gt;\r\n'' &lt;param name=&quot;sTabName&quot;&gt;Tabellen-Name&lt;\/param&gt;\r\n'' &lt;returns&gt;Boolean&lt;\/returns&gt;\r\n'' &lt;remarks&gt;\r\n'' &lt;\/remarks&gt;\r\n''**\/\r\n''------------------------------------------------------------------\r\nPublic Function DeleteTableDef(ByVal sTabName As String) As Boolean\r\n    ...\r\nEnd Function<\/pre>\n<p>Das Resultat ist beeindruckend &#8211; Abb. 1 liefert einen kleinen Vorgeschmack auf das, was sich mit dem hier vorgestellten Tool erreichen l&auml;sst. Voraussetzung ist nat&uuml;rlich das Anlegen einer Kommantarzeil in entsprechender Syntax.<\/p>\n<p><img decoding=\"async\" src=\"..\/fileadmin\/_temp_\/2010_01\/Doxygen-web-images\/pic007_opt.jpeg\" alt=\"pic007.png\" \/><\/p>\n<p><b><span style=\"color:darkgrey\">Bild 1: Eine mit unserem Tool und Doxygen erstellte .chm-Datei<\/span><\/b><\/p>\n<p class=\"zwischen-berschrift-oberer-spaltenrand\">Was folgt<\/p>\n<p>In diesem Beitrag zeigen wir Ihnen zun&auml;chst, welche Tools Sie f&uuml;r die automatische Erstellung der Dokumentation aus benutzerdefinierten Kommentaren im Quellcode ben&ouml;tigen und wie Sie diese installieren. Danach stellen wir das Tool <b>Doxygen <\/b>vor und zeigen, wie es grunds&auml;tzlich funktioniert.<\/p>\n<p>Da Sie aber mit Access arbeiten und nat&uuml;rlich gern alles mit dieser Anwendung erledigen w&uuml;rden, haben wir Ihnen noch ein Add-In gebaut, das die Eingabe der n&ouml;tigen Parameter und die Steuerung von <b>Doxygen <\/b>erlaubt. Ganz zum Schluss lernen Sie, wie die Syntax der Kommentare aussehen muss, damit <b>Doxygen <\/b>diese verarbeiten kann. <\/p>\n<p class=\"zwischen-berschrift-oberer-spaltenrand\">Hilfstools<\/p>\n<p>Bevor Sie eine Dokumentation Ihres Codes mit Doxygen erstellen k&ouml;nnen, m&uuml;ssen Sie einige Hilfsmittel herunterladen. Folgende Programme und Tools werden ben&ouml;tigt:<\/p>\n<ul>\n<li class=\"aufz-hlung\">Doxygen zum Erzeugen der Dokumentation: <b>http:\/\/www.stack.nl\/~dimitri\/doxygen\/<\/b><\/li>\n<li class=\"aufz-hlung\"><b>Vbfilter<\/b>, ein <b>awk<\/b>-Skript zum Konvertieren des VB-Codes in einen von Doxygen auswertbaren Text: <b>http:\/\/www.stack.nl\/~dimitri\/doxygen\/dl\/vbfilter.zip<\/b> (Beschreibung siehe <b>http:\/\/www.stack.nl\/~dimitri\/doxygen\/helpers.html<\/b>)<\/li>\n<li class=\"aufz-hlung\"><b>Unix tools <\/b>(<b>sh.exe<\/b>, <b>gawk.exe<\/b>, <b>tee.exe<\/b>) &#8211; diese werden f&uuml;r die <b>vbfilter.bat <\/b>ben&ouml;tigt: <b>http:\/\/sourceforge.net\/projects\/unxutils\/<\/b> <\/li>\n<li class=\"aufz-hlung\">Optional: <b>HTML Help Workshop <\/b><\/li>\n<\/ul>\n<p>Die hier beschriebenen Tools werden wohlgemerkt nur f&uuml;r die Erstellung der Dokumentation ben&ouml;tigt. Der Benutzer kann sp&auml;ter ohne spezielle Software auf diese zugreifen.<\/p>\n<p>Die Doxygen-Installation beginnen Sie mit der Ausf&uuml;hrung der Setup-Datei <b>doxygen-1.x.x-setup.exe<\/b>. Nach der Doxygen-Installation m&uuml;ssen Sie die <b>VB-Filter <\/b>installieren. Dazu kopieren Sie die Dateien aus der <b>vbfilter.zip<\/b>-Datei in ein beliebiges Verzeichnis.<\/p>\n<p>Dieses Verzeichnis darf im Verzeichnispfad kein Leerzeichen enthalten. Sp&auml;ter ben&ouml;tigen Sie bei der Verwendung von Doxygen Schreibrechte in diesem Verzeichnis (beachten Sie das vor allem, wenn Sie Windows Vista oder Windows 7 verwenden).<\/p>\n<p>Ein passender Ablageort w&auml;re <b>C:\\ProgramData\\doxygen\\vbfilter<\/b>.<\/p>\n<p>In das gleiche Verzeichnis kopieren Sie auch die Dateien <b>sh.exe<\/b>, <b>gawk.exe <\/b>und <b>tee.exe <\/b>aus der Zip-Datei <b>UnxUtils.zip<\/b>. <\/p>\n<p><b>Konfiguration<\/b><\/p>\n<p>Nachdem alle Dateien installiert wurden, sollten Sie die Datei <b>vbfilter.bat <\/b>anpassen, damit sichergestellt ist, dass <b>sh.exe <\/b>erreicht werden kann.<\/p>\n<p>Erg&auml;nzen Sie daf&uuml;r in der Batch-Datei eine Zeile (s. Listing 2, Zeile 2), die auf das Laufwerk <b>c:\\<\/b> wechselt, in dem Ihre <b>vbfilter<\/b>-Programmdateien liegen.<\/p>\n<p class=\"kastentabelleheader\">Listing 2: Die Konfigurationsdatei Vbfilter.bat<\/p>\n<pre>@echo off\r\nC:\r\ncd %1%\r\nset teeCommand=.\/tee -a ''%2%.doxylog''\r\nset awkCommand=.\/gawk.exe -f vbfilter.awk ''%2%''\r\nset fullCommand=&quot;%awkCommand% | %teeCommand%&quot;\r\nrem sh.exe -c %fullCommand%\r\nsh.exe -c &quot;.\/gawk.exe -f vbfilter.awk ''%2%''&quot;<\/pre>\n<p>Die allgemeine Konfiguration ist damit abgeschlossen. Starten Sie nun den <b>Doxywizard <\/b>aus dem Programm-Men&uuml;.<\/p>\n<p>In der ersten Eingabemaske (siehe Bild 2) stellen Sie den Projektnamen und das Verzeichnis der Code-Dateien ein. In dieses Verzeichnis m&uuml;ssen Sie die VBA-Module aus der Access-Datenbank exportieren, deren Kommentare <b>Doxygen <\/b>verarbeiten soll (wie dies geschieht, erl&auml;utern wir weiter unten).<\/p>\n<p><img decoding=\"async\" src=\"..\/fileadmin\/_temp_\/2010_01\/Doxygen-web-images\/dg_start_opt.jpeg\" alt=\"dg_start.png\" \/><\/p>\n<p><b><span style=\"color:darkgrey\">Bild 2: Startmaske von Doxywizard<\/span><\/b><\/p>\n<p>Danach stellen Sie in dieser Maske das Zielverzeichnis ein. In das Zielverzeichnis beziehungsweise dessen <b>html<\/b>-Unterverzeichnis schreibt <b>Doxygen <\/b>die <b>.html<\/b>-Dateien und die Hilfedatei. Normalerweise reicht f&uuml;r das Zielverzeichnis die Angabe eines Punktes aus.<\/p>\n<p>Mit dieser Einstellung wird das Verzeichnis der <b>Doxygen<\/b>-Konfigurationsdatei als Basis-Pfad verwendet und die <b>.html<\/b>-Dateien werden in das Unterverzeichnis <b>html <\/b>eingef&uuml;gt. Nat&uuml;rlich k&ouml;nnen Sie die Dateien auch in ein <b>html<\/b>-Unterverzeichnis im Verzeichnis der zu dokumentierenden Access-Datenbank schreiben lassen.<\/p>\n<p><!--30percent--><\/p>\n<p>F&uuml;r eine &uuml;bersichtliche Gliederung der Dateien empfehlen wir folgende Verzeichnisstruktur:<\/p>\n<pre>&lt;Verzeichnis der .mdb\/.accdb-Datei&gt;\r\n-Doxygen (Zielverzeichnis)\r\n-Html\r\n-Pictures\r\n-Source (Exportverzeichnis\r\nbeziehungsweise\r\nSource-Code-Verzeichnis)<\/pre>\n<p>In das Verzeichnis <b>Doxygen <\/b>speichern Sie die <b>Doxygen<\/b>-Konfigurationsdatei und in das Verzeichnis <b>Source <\/b>exportieren Sie die VBA-Module.<\/p>\n<p>Damit <b>Doxygen <\/b>die Textdateien mit dem VB-Code erkennt, m&uuml;ssen Sie deren Dateierweiterung im Bereich <b>Expert <\/b>des <b>Doxygen<\/b>-Fensters im Bereich <b>Input <\/b>in der Eigenschaft <b>FILE_PATTERNS <\/b>eintragen (siehe Bild 3). &Uuml;blicherweise sind das die Erweiterungen <b>*.bas <\/b>und <b>*.cls<\/b>.<\/p>\n<p><img decoding=\"async\" src=\"..\/fileadmin\/_temp_\/2010_01\/Doxygen-web-images\/pic002_opt.jpeg\" alt=\"pic002.png\" \/><\/p>\n<p><b><span style=\"color:darkgrey\">Bild 3: Doxygen-Konfiguration: File-Patterns<\/span><\/b><\/p>\n<p>Den wichtigsten Konfigurationsschritt nehmen Sie im gleichen Bereich weiter unten f&uuml;r die Eigenschaft <b>INPUT_FILTER<\/b> vor (siehe Bild 4). In dieser Eigenschaft m&uuml;ssen Sie die <b>VB-Filter <\/b>durch folgenden Eintrag aktivieren (passen Sie den Pfad den Gegebenheiten Ihres Dateisystems an):<\/p>\n<p><img decoding=\"async\" src=\"..\/fileadmin\/_temp_\/2010_01\/Doxygen-web-images\/pic003_opt.jpeg\" alt=\"pic003.png\" \/><\/p>\n<p><b><span style=\"color:darkgrey\">Bild 4: Doxygen-Konfiguration: Input-Filter<\/span><\/b><\/p>\n<pre>C:\/ProgramData\/doxygen\/vbfilter\/vbfilter.bat C:\\ProgramData\\doxygen\\vbfilter<\/pre>\n<p>Nach dem Speichern der <b>Doxygen<\/b>-Konfigurationsdatei k&ouml;nnen Sie nun Ihre Code-Dokumentation erstellen. Dazu exportieren Sie zun&auml;chst die VBA-Module Ihrer Datenbank in das eingestellte Code-Verzeichnis und starten im <b>Doxywizard<\/b>-Register <b>Run<\/b> die Erzeugung der <b>html<\/b>-Dateien.<\/p>\n<p>Zum Testen k&ouml;nnen Sie die Module des DBMS-Connection-Wizards verwenden, der in der letzten Ausgabe vorgestellt wurde &#8211; sie enthalten bereits einige von Doxygen verarbeitbare Kommentare.<\/p>\n<p>Falls Sie nicht nur <b>.html<\/b>-Dateien erstellen wollen, sondern auch eine Hilfe-Datei erzeugt werden soll, ben&ouml;tigen Sie noch den <b>HTML Help Workshop <\/b>von Microsoft, dessen <b>hhc.exe<\/b>-Datei Sie in der HTML-Register-Eigenschaft <b>HHC_LOCATION <\/b>einstellen &#8211; vorher m&uuml;ssen Sie jedoch noch die Option <b>GENERATE _HTMLHELP <\/b>aktivieren (siehe Bild 5).<\/p>\n<p><img decoding=\"async\" src=\"..\/fileadmin\/_temp_\/2010_01\/Doxygen-web-images\/pic004_opt.jpeg\" alt=\"pic004.png\" \/><\/p>\n<p><b><span style=\"color:darkgrey\">Bild 5: Doxygen-Konfiguration: CHM-Eigenschaften<\/span><\/b><\/p>\n<p>Geben Sie au&szlig;erdem unter <b>CHM_FILE <\/b>noch Pfad und Dateiname der zu erstellenden <b>.chm<\/b>-Datei an. Die <b>.chm<\/b>-Hilfe-Datei wird von <b>Doxygen <\/b>erzeugt und in das <b>html<\/b>-Verzeichnis eingef&uuml;gt.<\/p>\n<p><b>Access Add-In: Doxygen-Wizard<\/b><\/p>\n<p>Damit der Aufwand f&uuml;r die <b>Doxygen<\/b>-Konfiguration nicht zu gro&szlig; wird und Sie die VBA-Module m&uuml;helos exportieren k&ouml;nnen, haben wir Ihnen ein Access-Men&uuml;-Add-In erstellt.<\/p>\n<p>Sie finden die zum Zeitpunkt der Drucklegung dieses Magazins aktuelle Version auf der Heft-CD beziehungsweise im Downloadbereich von <b>http:\/\/www.access-im-unternehmen.de<\/b>. Da das Tool jedoch weiterentwickelt wird, finden Sie die aktuelle Version jeweils hier: <b>http:\/\/access.joposol.com\/download\/DoxygenWizard.zip<\/b><\/p>\n<p>Zum Installieren speichern Sie die Datei <b>DoxygenWizard<\/b>.mda in einem beliebigen Verzeichnis. Starten Sie dann Access und rufen Sie den Add-In-Manager auf.<\/p>\n<p>F&uuml;gen Sie die soeben gespeicherte <b>.mda<\/b>-Datei zu den vorhandenen Add-Ins hinzu. Anschlie&szlig;end finden Sie dieses im Men&uuml; der verf&uuml;gbaren Add-Ins unter dem Namen <b>Doxygen-Wizard<\/b>.<\/p>\n<p>Im Register <b>Grundeinstellungen <\/b>(s.<b> <\/b>Abb. 6) tragen Sie zun&auml;chst den Projektnamen und die Versionsnummer ein. Als N&auml;chstes stellen Sie in dieses Register das <b>Code<\/b>-Verzeichnis und das Zielverzeichnis f&uuml;r die <b>.html<\/b>-Dateien ein.<\/p>\n<p><img decoding=\"async\" src=\"..\/fileadmin\/_temp_\/2010_01\/Doxygen-web-images\/pic006_opt.jpeg\" alt=\"pic006.png\" \/><\/p>\n<p><b><span style=\"color:darkgrey\">Bild 6: Doxygen-Wizard: Grundeinstellungen<\/span><\/b><\/p>\n<p>Das Register <b>Doxygen-Konfiguration <\/b>(siehe Bild 7) dient der &Uuml;berpr&uuml;fung und Einstellung der Basiseinstellungen.<\/p>\n<p><img decoding=\"async\" src=\"..\/fileadmin\/_temp_\/2010_01\/Doxygen-web-images\/pic005_opt.jpeg\" alt=\"pic005.png\" \/><\/p>\n<p><b><span style=\"color:darkgrey\">Bild 7: Doxygen-Wizard: Doxygen-Konfiguration<\/span><\/b><\/p>\n<p>Diese Einstellungen m&uuml;ssen &uuml;blicherweise nur einmal festgelegt werden und werden im Add-In zwischengespeichert und f&uuml;r neue Anwendungen beziehungsweise Konfigurationsdateien &uuml;bernommen.<\/p>\n<p>Der Doxygen-Wizard speichert die Einstellungen in der Datei <b>doxygen.config <\/b>ab, die im <b>Output<\/b>-Verzeichnis liegt. Beim Add-In-Start wird eine vorhandene Datei ausgewertet.<\/p>\n<p>Somit k&ouml;nnen Sie auch direkt die Konfigurationsdatei mit <b>Doxywizard <\/b>(ein mit Doxygen mitgeliefertes GUI) bearbeiten.<\/p>\n<p>Sollten Sie w&auml;hrend der &auml;nderung mittels <b>Doxywizard <\/b>das Access-Add-In <b>Doxygen-Wizard <\/b>ge&ouml;ffnet haben, k&ouml;nnen Sie durch Bet&auml;tigen der Schaltfl&auml;che <b>Datei neu einlesen <\/b>(siehe Bild 5) die neuen Werte in den Assistenten laden.<\/p>\n<p>Zum Exportieren der Module bet&auml;tigen Sie die Schaltfl&auml;che <b>Code exportieren<\/b>.<\/p>\n<p>Nach dem Exportieren starten Sie den <b>Doxywizard <\/b>&uuml;ber die Schaltfl&auml;che <b>Doxygen starten <\/b>und aktivieren im Register <b>Run <\/b>die Erstellung der Dokumentation.<\/p>\n<p><b>Doxygen-taugliche Kommentare<\/b><\/p>\n<p>Nachdem Sie nun Doxygen installiert haben und die Haupt-Einstellungen kennen, ist es an der Zeit, die notwendige Syntax der VBA-Kommentare kennenzulernen. Als Einleitung f&uuml;r einen Doxygen-Kommentarblock dient die Zeichenkombination <b>\/**<\/b> und als Endemarkierung verwenden Sie <b>**\/<\/b>.<\/p>\n<p>Der Text zwischen diesen Marken wird von <b>Doxygen <\/b>ausgewertet. F&uuml;r die Strukturierung von Doxygen-Parametern k&ouml;nnen HTML-&auml;hnliche Marken verwendet werden.<\/p>\n<p><b>&lt;summary&gt; <\/b>leitet die Kurzbeschreibung ein. Alternativ k&ouml;nnte auch <b>\\brief <\/b>verwendet werden. <\/p>\n<p><b>&lt;\/ summary&gt; <\/b>kennzeichnet das Ende der Kurzbeschreibung.<\/p>\n<p>Zwischen den Marken <b>&lt;remarks&gt; <\/b>und <b>&lt;\/remarks&gt; <\/b>werden zus&auml;tzliche Anmerkungen eingetragen.<\/p>\n<p>Die Marke <b>&lt;param&gt; <\/b>dient der Beschreibung der Prozedurparameter.<\/p>\n<p>Falls Sie in einem Kommentar auf eine Prozedur verweisen wollen, k&ouml;nnen Sie die Marke <b>&lt;see cref = &#8230;&gt; <\/b>verwenden. Mit dieser Marke erzeugt <b>Doxygen <\/b>in der HTML-Ausgabe einen Link zur angegebenen Stelle.<\/p>\n<p><b>Doxygen <\/b>unterst&uuml;tzt eine Vielzahl von Marken und Befehlen. Eine Beschreibung all dieser Befehle w&uuml;rde den Rahmen dieses Beitrags sprengen, daher werden wir Ihnen nur einige oft ben&ouml;tigte Beispiele zeigen. Die <b>Doxygen<\/b>-Dokumentation ist allerdings sehr ausf&uuml;hrlich und gut strukturiert.<\/p>\n<p>Daher empfehlen wir Ihnen, in dieser Dokumentation zu st&ouml;bern und sich von den F&auml;higkeiten von Doxygen &uuml;berraschen zu lassen.<\/p>\n<p>Einen Kommentar-Block in einem Modul oder Klassenmodul k&ouml;nnten Sie gem&auml;&szlig; Listing 3 gestalten.<\/p>\n<p class=\"kastentabelleheader\">Listing 3: Kommentarblock: Klassenmodul<\/p>\n<pre>''------------------------------------------------------------------\r\n'' Klassenmodul: DaoHandler (2009-06-15)\r\n''------------------------------------------------------------------\r\n''\/**\r\n'' &lt;summary&gt;\r\n'' DAO-Zugriffsmethoden\r\n'' &lt;\/summary&gt;\r\n'' &lt;remarks&gt;\r\n'' ...\r\n'' &lt;\/remarks&gt;\r\n''**\/\r\n''------------------------------------------------------------------<\/pre>\n<p>F&uuml;r Doxygen ist nur der Textabschnitt innerhalb <b>\/** <\/b>und <b>**\/ <\/b>wirksam. Die Zeilen davor erleichtern nur die Lesbarkeit innerhalb des Klassenmoduls. Innerhalb der Marke <b>&lt;summary&gt; <\/b>ist eine kurze Beschreibung der Klasse enthalten. In <b>&lt;remarks&gt; <\/b>ist Platz f&uuml;r f&uuml;r Zusatzanmerkungen.<\/p>\n<p>Ein Kommentarblock f&uuml;r eine Prozedur k&ouml;nnte wie in Listing 4 aussehen. Im <b>&lt;summary&gt;<\/b>-Block wird mittels <b>&lt;see cref&gt;<\/b> auf die Methode <b>OpenRecordset <\/b>aus der Klasse <b>DaoHandler <\/b>verwiesen.<\/p>\n<p class=\"kastentabelleheader\">Listing 4: Kommentar-Block Prozedur<\/p>\n<pre>''-----------------------------------------------------------------------\r\n'' Function: OpenDaoRecordset (2009-06-28)\r\n''-----------------------------------------------------------------------\r\n''\/**\r\n'' &lt;summary&gt;\r\n'' OpenDaoRecordset = &lt;see cref=DaoHandler#OpenRecordset&gt;CurrentDbConnection.DAO.OpenRecordset&lt;\/see&gt;\r\n'' &lt;\/summary&gt;\r\n'' &lt;param name=&quot;Source&quot;&gt;SQL-Anweisung&lt;\/param&gt;\r\n'' &lt;param name=&quot;RecordsetType&quot;&gt;DAO.RecordsetTypeEnum (Standard: dbOpenDynaset)&lt;\/param&gt;\r\n'' &lt;param name=&quot;RecordsetOptions&quot;&gt;DAO.RecordsetOptionEnum (Standard: dbSeeChanges)&lt;\/param&gt;\r\n'' &lt;param name=&quot;LockEdit&quot;&gt;DAO.LockTypeEnum (Standard: dbOptimistic)&lt;\/param&gt;\r\n'' &lt;returns&gt;DAO.Recordset&lt;\/returns&gt;\r\n'' &lt;remarks&gt;&lt;\/remarks&gt;\r\n''**\/\r\n''-----------------------------------------------------------------------\r\nPublic Function OpenDaoRecordset(ByVal Source As String, _\r\n    Optional ByVal RstType As DAO.RecordsetTypeEnum = dbOpenDynaset, _\r\n    Optional ByVal RstOptions As DAO.RecordsetOptionEnum, _\r\n    Optional ByVal LockEdit As DAO.LockTypeEnum = dbOptimistic) As DAO.Recordset<\/pre>\n<p>Mit den <b>&lt;param&gt;<\/b>-Zeilen werden die einzelnen Parameter der Prozedur <b>OpenDaoRecordset <\/b>genauer beschrieben.<\/p>\n<p><b>&lt;returns&gt; <\/b>ist f&uuml;r die Beschreibung des R&uuml;ckgabewertes der Prozedur ma&szlig;gebend.<\/p>\n<p>F&uuml;r eine umfangreichere Dokumentation ist es hilfreich, wenn Sie erg&auml;nzend zur Code-Dokumentation noch allgemeine Beschreibungstexte einf&uuml;gen. Daf&uuml;r reicht es aus, wenn Sie in einem Modul nur Kommentare schreiben. In Listing 5 sehen Sie eine M&ouml;glichkeit zur Konfiguration einer Startseite.<\/p>\n<p class=\"kastentabelleheader\">Listing 5: Kommentar-Block Startseite<\/p>\n<pre>''\/** \\mainpage DBMS-Connection-Wizard\r\n'' \\image html pictures\/wizardform.png\r\n'' &lt;CENTER&gt;\\ref grpWizard &amp;nbsp;&amp;nbsp;&amp;nbsp; | &amp;nbsp;&amp;nbsp;&amp;nbsp; \\ref grpCodeLib&lt;\/CENTER&gt;\r\n''**\/<\/pre>\n<p><b>\\mainpage<\/b> dient der Beschreibung der Startseite. Mit <b>\\image <\/b>wird ein Bild angef&uuml;gt, das sich im <b>doxygen<\/b>-Unterverzeichnis <b>pictures <\/b>befindet. Die beiden <b>\\ref<\/b>-Anweisungen verweisen auf eine <b>Doxygen<\/b>-Gruppe.<\/p>\n<p>Eine Gruppe wird mit <b>\\defgroup <\/b>oder <b>@defgroup <\/b>(s. Listing 6) erzeugt und erm&ouml;glicht eine Gruppierung von Seiten innerhalb der Dokumentation. Diese Gruppen werden in der von <b>Doxygen <\/b>aus der Dokumentation erstellten Hilfe-Datei im Inhaltsverzeichnis verwendet.<\/p>\n<p class=\"kastentabelleheader\">Listing 6: Kommentarblock Gruppe<\/p>\n<pre>    ''\/**\r\n    '' @defgroup grpWizard DBMS-Connection-Wizard\r\n    '' Access-Add-In: DBMS-Connection-Wizard\r\n    ''**\/\r\n    ''\/**\r\n    '' \\defgroup grpCodeLib Code-Bibliothek\r\n    '' Klassen und Module f&uuml;r die Verwendung in den Access-Anwendungen\r\n    ''**\/<\/pre>\n<p>Um Elemente Gruppen zuzuordnen, m&uuml;ssen diese mit der Anweisung <b>\\addtogroup <\/b>gekennzeichnet werden (s. Listing 7). Die Elemente einer Gruppe k&ouml;nnen mit <b>@{ <\/b>und <b>@} <\/b>eingeklammert werden. Dann m&uuml;ssen Sie nicht f&uuml;r jedes Element die Gruppenzuordnung anf&uuml;gen.<\/p>\n<p class=\"kastentabelleheader\">Listing 7: Kommentarblock Elemente einer Gruppe<\/p>\n<pre>''\/** \\addtogroup grpWizard\r\n'' @{ **\/\r\n''\r\n''\/**\r\n'' \\page wizard_install Installation\r\n''\r\n'' Das Access-Add-In wird &uuml;ber den Add-In-Manger durch hinzuf&uuml;gen der Datei &lt;em&gt;DbmsConnectionWizard.\r\n'' mda&lt;\/em&gt; installiert.\r\n'' Falls Sie Vista oder Windows 7 verwenden und die Benutzerkontensteuerung (UAC) aktiviert haben,\r\n'' starten Sie zuvor Access als Administrator, da f&uuml;r die Registrierung der Assistenten Admin-Rechte\r\n'' notwendig sind.\r\n'' Sollten es Ihnen nicht m&ouml;glich sein, Admin-Rechte zu erhalten, so k&ouml;nnen Sie das Add-In trotzdem\r\n'' verwenden.\r\n'' Es steht Ihnen dann allerdings nur das Men&uuml;-Add-In zur Verf&uuml;gung.\r\n[...]\r\n''**\/\r\n''\r\n'' \/** @} **\/<\/pre>\n<p>Weitere Beispiele finden Sie in den Modulen des Access-Add-Ins <b>DbmsConnectionWizard<\/b>, das im Beitrag <b>Der DBMS-Connection-Wizard <\/b>(Shortlink 681) vorgestellt wurde.<\/p>\n<p><b>Hilfswerkzeuge<\/b><\/p>\n<p>Wie Sie an den letzten beiden Beispielen sahen, kann ein Kommentarblock f&uuml;r Doxygen relativ umfangreich werden. Da aber meist &auml;hnliche Strukturen ben&ouml;tigt werden, ist es empfehlenswert, ein Hilfswerkzeug wie das VBA-Add-In MZ-Tools zu verwenden, um bestimmte Kommentar-Bl&ouml;cke einzuf&uuml;gen. MZ-Tools unterst&uuml;tzt standardm&auml;&szlig;ig das Einf&uuml;gen von Modulkopf und Prozedurkopf. Zwei Beispiele f&uuml;r MZ-Tools-Einstellungen sehen Sie in Listing 8 und Listing 9.<\/p>\n<p class=\"kastentabelleheader\">Listing 8: MZ-Tools-Einstellung Modulkopf<\/p>\n<pre>    ''--------------------------------------------------------\r\n    '' {MODULE_TYPE}: {MODULE_NAME} ({DATE})\r\n    ''--------------------------------------------------------\r\n    ''\/**\r\n    '' &lt;summary&gt;\r\n    '' {MODULE_NAME}\r\n    '' &lt;\/summary&gt;\r\n    '' &lt;remarks&gt;\r\n    '' &lt;\/remarks&gt;\r\n    ''**\/\r\n    ''--------------------------------------------------------<\/pre>\n<p class=\"kastentabelleheader\">Listing 9: MZ-Tools-Einstellung Prozedurkopf<\/p>\n<pre>''-------------------------------------------------------\r\n'' {PROCEDURE_TYPE}: {PROCEDURE_NAME} ({DATE})\r\n''-------------------------------------------------------\r\n''\/**\r\n'' &lt;summary&gt;\r\n'' {PROCEDURE_NAME}\r\n'' &lt;\/summary&gt;\r\n'' &lt;param name=&quot;Param&quot;&gt;&lt;\/param&gt;\r\n'' &lt;returns&gt;{FUNCTION_RETURN_TYPE_NAME}&lt;\/returns&gt;\r\n'' &lt;remarks&gt;\r\n'' &lt;\/remarks&gt;\r\n''**\/\r\n''-------------------------------------------------------<\/pre>\n<p>Sollten Sie weitere Kommentarvorlagen ben&ouml;tigen, k&ouml;nnen Sie diese in den MZ-Tools als Code-Vorlage abspeichern.<\/p>\n<p>F&uuml;r die Dokumentationserstellung mit Doxygen sind sicherlich einige Tage Einarbeitungszeit erforderlich, um Doxygen effektiv nutzen zu k&ouml;nnen. Sobald Sie die Grundfunktionen beherrschen, werden Sie allerdings mit wenig Aufwand eine Dokumentation erzeugen, die einen sehr professionellen Eindruck erzeugen wird.<\/p>\n<p><b>Zusammenfassung und Ausblick<\/b><\/p>\n<p>Mit der Kombination aus OpenSource-Programmen wie <b>Doxygen<\/b> und unserem Access-Addin erhalten Sie ein Paket, mit dem Sie die in einer speziellen Syntax angelegten Kommentare in Ihrem VBA-Code automatisch etwa in eine <b>.chm<\/b>-Datei exportieren k&ouml;nnen. Es gibt auch noch andere M&ouml;glichkeiten, zum Beispiel den Export in andere Formate wie LaTeX, RTF oder XML. Weitere Informationen hierzu erhalten Sie in der <b>Doxygen<\/b>-Dokumentation. <\/p>\n<p><b>Links<\/b><\/p>\n<p class=\"quellen\">[1] Doxygen: http:\/\/www.stack.nl\/~dimitri\/doxygen\/<\/p>\n<p class=\"quellen\">[2] Vb-Filter: http:\/\/www.stack.nl\/~dimitri\/doxygen\/helpers.html, http:\/\/www.stack.nl\/~dimitri\/doxygen\/dl\/vbfilter.zip<\/p>\n<p class=\"quellen\">[3] Unix-Tools: http:\/\/sourceforge.net\/projects\/unxutils\/<\/p>\n<p class=\"quellen\">[4] MZ-Tools: http:\/\/www.mztools.com\/ <\/p>\n<p class=\"quellen\">[5] Download der Beispielanwendung: http:\/\/access.joposol.com\/download\/DoxygenWizard.zip<\/p>\n<h3>Downloads zu diesem Beitrag<\/h3>\n<p>Enthaltene Beispieldateien:<\/p>\n<p>readme.txt<\/p>\n<p>vbfilter.awk<\/p>\n<p>DoxygenWizard.mda<\/p>\n<p><a href=\"..\/fileadmin\/beispiele\/{42665D41-8B14-4FD2-93BC-599D4280C8F5}\/aiu_703.zip\">Download<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Jeder Programmierer muss einmal Farbe bekennen: N&auml;mlich, wenn er &auml;ltere, umfangreiche und komplexe Anwendungen wieder ausgr&auml;bt und sich in diese einarbeitet, weil der Kunde &Auml;nderungsw&uuml;nsche &auml;u&szlig;ert. Wohl dem, der gut dokumentiert hat &#8211;  er findet sich mit Sicherheit gleich besser zurecht als ohne Dokumentation. Noch einfacher haben Sie es, wenn Sie Methoden und Eigenschaften Ihrer Anwendungen sch&ouml;n &uuml;bersichtlich in einer Hilfedatei nachlesen k&ouml;nnen. Doch wer betreibt schon einen solchen Aufwand Die Antwort ist einfach: Jeder, der Spa&szlig; daran und den vorliegenden Beitrag gelesen hat.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_uf_show_specific_survey":0,"_uf_disable_surveys":false,"footnotes":""},"categories":[66012010,662010,44000025],"tags":[],"class_list":["post-55000703","post","type-post","status-publish","format-standard","hentry","category-66012010","category-662010","category-VBA_und_Programmiertechniken"],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v20.9 (Yoast SEO v27.3) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>VBA-Code mit Doxygen dokumentieren - Access im Unternehmen<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/\" \/>\n<meta property=\"og:locale\" content=\"de_DE\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"VBA-Code mit Doxygen dokumentieren\" \/>\n<meta property=\"og:description\" content=\"Jeder Programmierer muss einmal Farbe bekennen: N&auml;mlich, wenn er &auml;ltere, umfangreiche und komplexe Anwendungen wieder ausgr&auml;bt und sich in diese einarbeitet, weil der Kunde &Auml;nderungsw&uuml;nsche &auml;u&szlig;ert. Wohl dem, der gut dokumentiert hat - er findet sich mit Sicherheit gleich besser zurecht als ohne Dokumentation. Noch einfacher haben Sie es, wenn Sie Methoden und Eigenschaften Ihrer Anwendungen sch&ouml;n &uuml;bersichtlich in einer Hilfedatei nachlesen k&ouml;nnen. Doch wer betreibt schon einen solchen Aufwand Die Antwort ist einfach: Jeder, der Spa&szlig; daran und den vorliegenden Beitrag gelesen hat.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/\" \/>\n<meta property=\"og:site_name\" content=\"Access im Unternehmen\" \/>\n<meta property=\"article:published_time\" content=\"2020-05-22T22:10:49+00:00\" \/>\n<meta property=\"og:image\" content=\"http:\/\/vg05.met.vgwort.de\/na\/68e838ada7404990afe6629abc74d7ad\" \/>\n<meta name=\"author\" content=\"Andr\u00e9 Minhorst\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Verfasst von\" \/>\n\t<meta name=\"twitter:data1\" content=\"Andr\u00e9 Minhorst\" \/>\n\t<meta name=\"twitter:label2\" content=\"Gesch\u00e4tzte Lesezeit\" \/>\n\t<meta name=\"twitter:data2\" content=\"15\u00a0Minuten\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/\"},\"author\":{\"name\":\"Andr\u00e9 Minhorst\",\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/#\\\/schema\\\/person\\\/13395c4bcd7d7963efe33be9c584d93f\"},\"headline\":\"VBA-Code mit Doxygen dokumentieren\",\"datePublished\":\"2020-05-22T22:10:49+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/\"},\"wordCount\":2451,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/#primaryimage\"},\"thumbnailUrl\":\"http:\\\/\\\/vg05.met.vgwort.de\\\/na\\\/68e838ada7404990afe6629abc74d7ad\",\"articleSection\":[\"1\\\/2010\",\"2010\",\"VBA und Programmiertechniken\"],\"inLanguage\":\"de\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/\",\"url\":\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/\",\"name\":\"VBA-Code mit Doxygen dokumentieren - Access im Unternehmen\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/#primaryimage\"},\"thumbnailUrl\":\"http:\\\/\\\/vg05.met.vgwort.de\\\/na\\\/68e838ada7404990afe6629abc74d7ad\",\"datePublished\":\"2020-05-22T22:10:49+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/#breadcrumb\"},\"inLanguage\":\"de\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"de\",\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/#primaryimage\",\"url\":\"http:\\\/\\\/vg05.met.vgwort.de\\\/na\\\/68e838ada7404990afe6629abc74d7ad\",\"contentUrl\":\"http:\\\/\\\/vg05.met.vgwort.de\\\/na\\\/68e838ada7404990afe6629abc74d7ad\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/VBACode_mit_Doxygen_dokumentieren\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/access-im-unternehmen.de\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"VBA-Code mit Doxygen dokumentieren\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/#website\",\"url\":\"https:\\\/\\\/access-im-unternehmen.de\\\/\",\"name\":\"Access im Unternehmen\",\"description\":\"Das Magazin f\u00fcr Datenbankentwickler auf Basis von Microsoft Access\",\"publisher\":{\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/access-im-unternehmen.de\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"de\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/#organization\",\"name\":\"Andr\u00e9 Minhorst Verlag\",\"url\":\"https:\\\/\\\/access-im-unternehmen.de\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"de\",\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/access-im-unternehmen.de\\\/wp-content\\\/uploads\\\/2019\\\/09\\\/aiu_wp.png\",\"contentUrl\":\"https:\\\/\\\/access-im-unternehmen.de\\\/wp-content\\\/uploads\\\/2019\\\/09\\\/aiu_wp.png\",\"width\":370,\"height\":111,\"caption\":\"Andr\u00e9 Minhorst Verlag\"},\"image\":{\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/#\\\/schema\\\/logo\\\/image\\\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/access-im-unternehmen.de\\\/#\\\/schema\\\/person\\\/13395c4bcd7d7963efe33be9c584d93f\",\"name\":\"Andr\u00e9 Minhorst\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"de\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/1b9d010cf1716692cb9c34f21554e07d17d461acaea5b61b8cb21cbec678d48a?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/1b9d010cf1716692cb9c34f21554e07d17d461acaea5b61b8cb21cbec678d48a?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/1b9d010cf1716692cb9c34f21554e07d17d461acaea5b61b8cb21cbec678d48a?s=96&d=mm&r=g\",\"caption\":\"Andr\u00e9 Minhorst\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"VBA-Code mit Doxygen dokumentieren - Access im Unternehmen","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/","og_locale":"de_DE","og_type":"article","og_title":"VBA-Code mit Doxygen dokumentieren","og_description":"Jeder Programmierer muss einmal Farbe bekennen: N&auml;mlich, wenn er &auml;ltere, umfangreiche und komplexe Anwendungen wieder ausgr&auml;bt und sich in diese einarbeitet, weil der Kunde &Auml;nderungsw&uuml;nsche &auml;u&szlig;ert. Wohl dem, der gut dokumentiert hat - er findet sich mit Sicherheit gleich besser zurecht als ohne Dokumentation. Noch einfacher haben Sie es, wenn Sie Methoden und Eigenschaften Ihrer Anwendungen sch&ouml;n &uuml;bersichtlich in einer Hilfedatei nachlesen k&ouml;nnen. Doch wer betreibt schon einen solchen Aufwand Die Antwort ist einfach: Jeder, der Spa&szlig; daran und den vorliegenden Beitrag gelesen hat.","og_url":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/","og_site_name":"Access im Unternehmen","article_published_time":"2020-05-22T22:10:49+00:00","og_image":[{"url":"http:\/\/vg05.met.vgwort.de\/na\/68e838ada7404990afe6629abc74d7ad","type":"","width":"","height":""}],"author":"Andr\u00e9 Minhorst","twitter_card":"summary_large_image","twitter_misc":{"Verfasst von":"Andr\u00e9 Minhorst","Gesch\u00e4tzte Lesezeit":"15\u00a0Minuten"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/#article","isPartOf":{"@id":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/"},"author":{"name":"Andr\u00e9 Minhorst","@id":"https:\/\/access-im-unternehmen.de\/#\/schema\/person\/13395c4bcd7d7963efe33be9c584d93f"},"headline":"VBA-Code mit Doxygen dokumentieren","datePublished":"2020-05-22T22:10:49+00:00","mainEntityOfPage":{"@id":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/"},"wordCount":2451,"commentCount":0,"publisher":{"@id":"https:\/\/access-im-unternehmen.de\/#organization"},"image":{"@id":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/#primaryimage"},"thumbnailUrl":"http:\/\/vg05.met.vgwort.de\/na\/68e838ada7404990afe6629abc74d7ad","articleSection":["1\/2010","2010","VBA und Programmiertechniken"],"inLanguage":"de","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/","url":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/","name":"VBA-Code mit Doxygen dokumentieren - Access im Unternehmen","isPartOf":{"@id":"https:\/\/access-im-unternehmen.de\/#website"},"primaryImageOfPage":{"@id":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/#primaryimage"},"image":{"@id":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/#primaryimage"},"thumbnailUrl":"http:\/\/vg05.met.vgwort.de\/na\/68e838ada7404990afe6629abc74d7ad","datePublished":"2020-05-22T22:10:49+00:00","breadcrumb":{"@id":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/#breadcrumb"},"inLanguage":"de","potentialAction":[{"@type":"ReadAction","target":["https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/"]}]},{"@type":"ImageObject","inLanguage":"de","@id":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/#primaryimage","url":"http:\/\/vg05.met.vgwort.de\/na\/68e838ada7404990afe6629abc74d7ad","contentUrl":"http:\/\/vg05.met.vgwort.de\/na\/68e838ada7404990afe6629abc74d7ad"},{"@type":"BreadcrumbList","@id":"https:\/\/access-im-unternehmen.de\/VBACode_mit_Doxygen_dokumentieren\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/access-im-unternehmen.de\/"},{"@type":"ListItem","position":2,"name":"VBA-Code mit Doxygen dokumentieren"}]},{"@type":"WebSite","@id":"https:\/\/access-im-unternehmen.de\/#website","url":"https:\/\/access-im-unternehmen.de\/","name":"Access im Unternehmen","description":"Das Magazin f\u00fcr Datenbankentwickler auf Basis von Microsoft Access","publisher":{"@id":"https:\/\/access-im-unternehmen.de\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/access-im-unternehmen.de\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"de"},{"@type":"Organization","@id":"https:\/\/access-im-unternehmen.de\/#organization","name":"Andr\u00e9 Minhorst Verlag","url":"https:\/\/access-im-unternehmen.de\/","logo":{"@type":"ImageObject","inLanguage":"de","@id":"https:\/\/access-im-unternehmen.de\/#\/schema\/logo\/image\/","url":"https:\/\/access-im-unternehmen.de\/wp-content\/uploads\/2019\/09\/aiu_wp.png","contentUrl":"https:\/\/access-im-unternehmen.de\/wp-content\/uploads\/2019\/09\/aiu_wp.png","width":370,"height":111,"caption":"Andr\u00e9 Minhorst Verlag"},"image":{"@id":"https:\/\/access-im-unternehmen.de\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/access-im-unternehmen.de\/#\/schema\/person\/13395c4bcd7d7963efe33be9c584d93f","name":"Andr\u00e9 Minhorst","image":{"@type":"ImageObject","inLanguage":"de","@id":"https:\/\/secure.gravatar.com\/avatar\/1b9d010cf1716692cb9c34f21554e07d17d461acaea5b61b8cb21cbec678d48a?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/1b9d010cf1716692cb9c34f21554e07d17d461acaea5b61b8cb21cbec678d48a?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/1b9d010cf1716692cb9c34f21554e07d17d461acaea5b61b8cb21cbec678d48a?s=96&d=mm&r=g","caption":"Andr\u00e9 Minhorst"}}]}},"_links":{"self":[{"href":"https:\/\/access-im-unternehmen.de\/data\/wp\/v2\/posts\/55000703","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/access-im-unternehmen.de\/data\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/access-im-unternehmen.de\/data\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/access-im-unternehmen.de\/data\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/access-im-unternehmen.de\/data\/wp\/v2\/comments?post=55000703"}],"version-history":[{"count":0,"href":"https:\/\/access-im-unternehmen.de\/data\/wp\/v2\/posts\/55000703\/revisions"}],"wp:attachment":[{"href":"https:\/\/access-im-unternehmen.de\/data\/wp\/v2\/media?parent=55000703"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/access-im-unternehmen.de\/data\/wp\/v2\/categories?post=55000703"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/access-im-unternehmen.de\/data\/wp\/v2\/tags?post=55000703"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}