Verwenden meiner Makros mit XLplus
XLplus Ver. 3.X bietet Ihnen eine bequeme Möglichkeit, Ihre eigenen Makros / VBA Lösungen in XLplus zu integrieren. Ihre Tools werden dabei wie XLplus Add-Ons behandelt. Nachdem Sie Ihr Tool installiert haben, ist es im Add-Ons Menu zum Starten verfügbar.
Hinweis:
XLplus Ver. 3.X hat eine Demo Datei in das Verzeichnis, in dem es installiert ist, gestellt, die zum Testen und als Referenz verwendet werden kann. Die Datei heißt
myOwnMacro.xlam. Sie können dieses Add-On mittels des
Add-On Managers installieren und testen - sowie anschließend analysieren: Verwenden Sie den
Add-In Manager um das Tool temporär zu einem Arbeitsbuch zu konvertieren. Sie können nun dessen Einstellungen mit der folgenden Hilfe vergleichen. Möchten Sie das Tool hiernach erneut installieren, wandeln Sie es in ein Add-In zurück, speichern Sie es und starten Sie den
Add-On Manager erneut.
Um Ihr Tool für XLplus vorzubereiten, fügen Sie einfach 2 Arbeitsblätter in Ihre Lösung ein. Diese steuern den Installationsprozess.
Das erste Arbeitsblatt muß Install_Settings benannt werden, dass zweite Arbeitsblatt Install_Ribbon.
Arbeitsblatt Install_Settings muß die folgende Information beinhalten:
- Add-On Name
- Ver.
- Tools
- Description UK
- Description DE
|
Add-On Name |
Der Name Ihres Tools, wie er im Add-On Manager bei der Installation Ihres Tools angezeigt wird.
Hinweis: Dieser Add-On Name muss identisch sein mit dem Namen, den Sie im Arbeitsblatt Install_Ribbon in Spalte Add-On Name angeben. Sind diese Namen nicht identisch, dann können Sie Ihr Tool nicht korrekt deinstallieren oder updaten. |
| Ver. |
Die Version Ihres Tools. |
| Tools |
Eine Liste aller Tools, die Sie installieren werden. Dies sind die einzelnen Funktionen, die Sie in das Add-Ons Menu einfügen werden. Diese Information wird benötigt, um Ihr Tool korrekt deinstallieren zu können. Eine korrekte Deinstallation ist benötigt, falls Sie Ihr Tool auf eine aktuellere Version updaten möchten.
Die Namen Ihrer Tools müßen die englischen Namen sein, die Sie in Arbeitsblatt Install_Ribbon angegeben haben. |
| Description UK / DE |
Eine kurze Beschreibung Ihrer Tools in Englisch und Deutsch. Diese Information wird während des Installationsprozesses angezeigt. |
Ex.: Install Settings
Das zweite Arbeitsblatt Install_Ribbon muß die folgende Information enthalten:
- objHierachyID
- objContainer
- Add-On Name
- objID
- objisContainer
- objType
- objImage
- objMsoImage
- objItemSize
- objOnAction
- objLabel
- objSupertip
- objScreentip
| objHierachyID |
Die objHierachyID gruppiert Ihr Control in eine Menu Gruppe. Alle objHierachyID müssen eine Zahl größer 100 sein. Mit der Verwendung von objHierachyID können Sie Ihre Tools thematisch gruppieren.
Status: Benötigt
Proposal:
Wir empfehlen das folgende Nummernschema:
| 101 |
Datei |
| 102 |
Bearbeiten |
| 103 |
Einfügen |
| 104 |
Format |
| 105 |
Extras |
| 106 |
Daten |
| 107 |
Ansicht |
| 108 |
Fenster |
| 109 + |
eigene Menunamen |
|
| objContainer |
objContainer ist eine kurze Beschreibung Ihres gruppierten Kommandos, z.B. Bearbeiten oder Datei. Es erleichtert das Handling einer größeren Anzahl verschiedener Tools, falls objHierachyID mit einer Beschreibung versehen wird.
Status: Benötigt |
| Add-On Name |
Add-On Name ist der Name, den Sie in Arbeitsblatt Install_Settings angegeben haben.
Hinweis: Add-On Name muss identisch sein mit dem in Arbeitsblatt Install_Settings angegebenen Add-On Namen. Andernfalls können Sie Ihr Add-In nicht korrekt deinstallieren oder updaten.
Hinweis: Add-On Name muss nicht angegeben werden für Container Objekte (z.B. Menu, Siehe objisContainer) aber zwingend für einzelne Controls, z.B. Buttons.
Status: Benötigt |
| objID |
objID ist eine einzigartige ID, die Ihr Tool im MS Excel Ribbon identifiziert. Falls nicht angegeben oder bereits verwendet, wird die Installationsroutine eine einzigartige ID für Sie erstellen.
Status: Optional |
| objisContainer |
objisContainer ist eine Zahl, die angibt, ob Ihr Control eine Gruppe (Container) oder ein einzelnes Control ist.
1 = Control ist eine Gruppe (Container)
0 = Control ist ein einzelnes Control
Es ist wichtig, diese Werte sorgfältig zu setzen.
Status: Benötigt
Beispiel:
| menu |
Gruppe (1) |
| gallery |
Gruppe (1) |
| button |
Control (0) |
| menuSeparator |
Control (0) |
|
| objType |
objType spezifiziert das hinzuzufügende Control. Momentan können die folgenden Controls erfolgreich hinzugefügt werden:
- menu
- gallery
- button
- menuSeparator
Sie sollten höchstens menu und button benötigen.
Hinweis: objType Elemente sind in der korrekten Groß- und Kleinschreibung anzugeben.
Status: Benötigt |
| objImage |
objImage ist der Dateiname eines Bildes für dieses Control. Siehe unten für Details.
Status: Optional |
| objMsoImage |
objMsoImage ist der Name eines MS Excel build-in Bildes für Ihr Control. Siehe unten für Details.
Status: Optional |
| objItemSize |
objItemSize steuert die Anzeigegröße von Bildern innerhalb einer Gruppe, z.B. einem menu. Setzen Sie dies zu large, um große Bilder für alle Controls dieser Gruppe anzuzeigen.
Die Optionen sind: large oder normal.
Hinweis: objItemSize darf ausschließlich Gruppen zugewiesen werden, z.B. menu!
Status: Optional |
| objOnAction |
objOnAction ist der komplette Pfad zu dem Modul, welches gestartet werden soll, wenn ein Benutzer das Control aufruft. Der Installationsprozess wird jedwede Pfadinformation, die in objOnAction enthalten ist, durch einen aktuellen Pfad zu Ihrem Tool ersetzen. Die Information, die mindestens angegeben sein muß, ist:
z.B. MyModule.MySub
Status: Benötigt |
| objLabel |
objLabel ist der Name Ihres Tools, wie er im XLplus Add-Ons Menu angezeigt wird. Dies muß in Englisch und Deutsch angegeben sein.
Hinweis: Sie sollten ebenfalls Namen für Ihre Gruppen angeben.
Status: Benötigt |
| objSupertip |
objSupertip ist Information, die angezeigt wird, wenn ein Benutzer die Maus über ein Control bewegt. Diese Information kann eine längere Beschreibung sein, als objScreentip. Die Information sollte in Englisch und Deutsch verfügbar sein.
Status: Optional |
| objScreentip |
objScreentip ist ein schneller und kurzer Hinweis über ein Tool.
Status: Optional |
Ex.: Ribbon Settings
Verwenden von Bildern
Am Einfachsten können Bilder verwendet werden, in dem die in MS Excel vorhandenen Bilder genutzt werden (objMsoImage). Es existieren verschiedene Tools, die Ihnen helfen, diese Bilder zu identifizieren.
Möchten Sie Ihre eigenen Bilder verwenden, folgen Sie bitte folgender Prozedur:
- Speichern Sie Ihre Bilder in einem Unterverzeichnis des Verzeichnisses, in dem XLplus installiert ist. in. Dieses Unterverzeichnis muß images benannt werden.
- Stellen Sie dem Namen Ihres Bildes einen Backslash (\) voran, wenn Sie objImage spezifizieren.
Während der Installation Ihres Tools wird
XLplus den korrekten Pfad zu Ihrem Bild für den Ribbon erstellen.
Dateitypen
Ihr Tool muß ein Excel Add-In im Format MS Excel 2000/2003 (*.XLA) oder MS Excel 2007 oder höher (*.XLAM) sein. Normale Arbeitsbücher werden vom XLplus Add-On Manager nicht berücksichtigt.
Übersetzungen
Ihr Tool muß objLabel in Englisch und Deutsch spezifizieren. Falls Sie es nicht in Deutsch (oder Englisch) übersetzen möchten, verwenden Sie einfach den Englischen/Deutschen Text im benötigten Feld. Beide Sprachen müssen angegeben werden, da XLplus das Wechseln der Sprache zur Laufzeit ermöglicht.
Ich habe es kaputt gemacht ...
Sollten Sie das instabile Ribbon Konstrukt von MS kaputt gekriegt haben, möchten Sie vielleicht komplett von vorn beginnen. XLplus Ver. 3.X bietet ein Tool, mit dem das XLplus Add-Ons Menu komplett gelöscht werden kann. Nachdem dies gelaufen ist, sind alle Add-Ons aus XLplus entfernt und Sie können erneut beginnen.
Hinweis: XLplus Ver. 3.X bietet ein weiteres Tool, welches Sie in der Entwicklung von Add-Ins unterstützt. Add-In Manager ermöglicht die Verwaltung aller gerade geladenen Excel Add-Ins aus Excel heraus (anstelle der IDE). Mit Add-In Manager könen Sie Add-Ins speichern und schliessen.
FAQ
Ich sehe keine Supertips
Stellen Sie sicher, dass Excel Supertips anzeigen darf. Sie finden diese Einstellung in Excel - Optionen - General - Screentip Style.
Screenshot:
Ich erhalte kein Add-On Menu mehr
Es ist wahrscheinlich, dass Sie ein oder zwei Einstellungen fehlerhaft vorgenommen haben. Sie können einstellen, dass Sie Fehlermeldungen bzgl. des Ribbons erhalten. Diese können bei der Identifikation des Problems helfen. Sie finden diese Einstellungen in Excel - Optionen - Fortgeschritten. Aktivieren Sie Show Add-In user interface errors.
Screenshot:
Ich erhalte eine Fehlermeldung "Cannot get handle to Ribbon"
Ein unbehandelter Fehler trat in Ihrer Applikation auf, welcher Excel veranlasste, das XLplus Ribbon Tab von XLplus zu trennen. Starten Sie XLplus erneut, so das es den XLplus Ribbon Tab neu laden und den handle zu ihm speichern kann.
Mein Makro startet nicht und ich erhalte Fehlermeldungen
Prüfen Sie Ihre Einstellungen auf Arbeitsblatt Install_Ribbon; vergleichen Sie diese mit der hier gegebenen Information und der Demodatei. Reduzieren Sie Ihre Einstellungen auf ein menu plus darin befindliche buttons. Falls Sie sicher sind, Ihre Einstellungen sind korrekt, prüfen Sie den Code Ihrer Applikation - Fehler in Ihrer Applikation wird den Ribbon ins Stolpern bringen.
Wie prüfe ich meinen Code am Besten?
Fügen Sie Haltepunkte (breakpoints) zu Ihrem Code hinzu. Sie können manuel Haltepunkte in der VBE setzen oder eine einzige Zeile Code hinzufügen: Stop. Das Stop Kommando wird Ihren Code anhalten und Sie können schrittweise durch Ihren Code gehen. Sollte Ihr Code überraschend abgebrochen werden, dann ist es mehr als wahrscheinlich, das dieser Fehler auch den Ribbon ins Stolpern gebracht hat.
Wie kann ich testen, ob der Ribbon stolperte?
Versuchen Sie die Sprache von XLplus zu wechseln - sollte dies mit dem Fehler "Cannot get handle to Ribbon" fehlschlagen, dann ist der Ribbon aus dem Tritt gekommen.
Excel ist komplett abgestürzt ...
Yep, MS Excel 2007 sowie MS Excel 2010 sind crash-kids wenn es um den Ribbon geht ...