Ribbon-Elemente, Attribute und Ereignisse im Überblick

Transkript

1 -Elemente, Attribute und Ereignisse im Überblick In den folgenden Tabellen finden Sie die für die Programmierung von s notwendigen Elemente und deren Eigenschaften und Ereignisse.

2 Elemente, Attribute und Ereignisse Element Beschreibung mögliche Kind-Steuerelemente box Ein Rahmen, um Elemente zu gruppieren button,, checkbox,, combo- Box,, menu,, box, splitbutton, labelcontrol, buttongroup, dynamicmenu, control button buttongroup checkbox combobox command Schaltfläche Kann eine Gruppe von Schaltflächen enthalten Kontrollkästchen Kombinationsfeld, das beim Ändern den angezeigten Inhalt zurückgibt Dient zum Festlegen benutzerdefinierter Funktionen für eingebaute Steuerelemente und aktiviert oder deaktiviert diese button,, menu,, splitbutton, dynamicmenu, control commands Auflistung der command-elemente. command contextualtabs control Fasst tabsets mit kontextsensitiven tabs zusammen Übergeordnetes Element für eingebaute Objekte, erlaubt etwa das Einbauen des Schriftfarbe-Steuerelements in benutzerdefinierte tab-elemente tabset customui Root-Element eines -XML-Dokuments commands, ribbon dialogboxlauncher documentcontrols Fügt einer Gruppe eine kleine Schaltfläche zum Öffnen eines Dialogs hinzu Elemente der Schnellzugriffsleiste (qat), die nur für die aktuelle Anwendung zur Verfügung stehen sollen Kombinationsfeld, das beim Ändern die angezeigte ID und den Index liefert button button, separator, control dynamicmenu Zur Laufzeit zu erzeugendes Menü button,, checkbox, menu,, splitbutton, menuseparator, dynamicmenu, control Textfeld Galerie wie Kombinationsfeld, jedoch mehrspaltig und komfortabler button, group Gruppe innerhalb eines tab-elements button,, checkbox,, combo- Box,, menu,, box, labelcontrol, buttongroup, separator, dialogboxlauncher, control labelcontrol Element eines combobox-, - oder -Steuerelements, wird beim dynamischen Zuweisen überschrieben Steuerelement mit einer Beschriftung menu Menü-Steuerelement button,, checkbox, menu,, splitbutton, menuseparator, dynamicmenu, control menuseparator officemenu Trennstrich zwischen Menüpunkten Office-Menü-Element, kann um benutzerdefinierte Steuerelemente ergänzt werden button,, checkbox, menu,, splitbutton, menuseparator, dynamicmenu, control Tabelle 1: -Steuerelemente

3 Element Beschreibung mögliche Kind-Steuerelemente qat Schnellzugriffsleiste (Quick Access Toolbar), kann nur bei startfromscratch="true" angepasst werden sharedcontrols, documentcontrols ribbon Enthält alle -Bestandteile officemenu, qat, contextualtabs, tabs separator sharedcontrols splitbutton Trennstrich zwischen Steuerelementen Elemente, die für alle Office-Anwendungen verfügbar sein sollen Kombination aus Schaltfläche und Menü wie etwa das Steuerelement zum Einstellen der Objektansicht button, separator, control button, tab Eine Registerseite des group tabs Enthält die Registerseiten des tab tabset Fasst tab-elemente zusammen, die in bestimmten Kontexten sichtbar gemacht werden sollen Umschaltfläche tab Tabelle 1: -Steuerelemente

4 Elemente, Attribute und Ereignisse Eigenschaft Datentyp Werte Beschreibung boxstyle String horizontal vertical Legt fest, wie die Elemente innerhalb eines box-elements angeordnet werden columns Long Anzahl der Spalten in einem -Objekt description String Beschreibungstext, der in den Einträgen eines menu-elements angezeigt wird, wenn die Eigenschaft Size auf large eingestellt ist boxstyle String horizontal vertical Legt fest, wie die Elemente innerhalb eines box-elements angeordnet werden columns Long Anzahl der Spalten in einem -Objekt description String Beschreibungstext, der in den Einträgen eines menu-elements angezeigt wird, wenn die Eigenschaft Size auf large eingestellt ist enabled Boolean false true 0 1 Legt fest, ob ein Steuerelement aktiviert oder deaktiviert ist id String Eindeutige ID eines benutzerdefinierten Steuerelements; nicht zu benutzen in Kombination mit idmso oder idq idmso Long Eindeutige ID eines eingebauten Steuerelements; nicht zu benutzen in Kombination mit idmso oder idq idq Long Steuerelement-ID, enthält Namespace-Bezeichnung; nicht in Kombination mit id oder idmso image String String zum Angeben einer Image-Datei imagemso String Verweist auf ein eingebautes Symbol insertaftermso String Gibt an, hinter welches eingebaute Steuerelement mit idmso ein neues Element angelegt werden soll insertafterq String Gibt an, hinter welches eingebaute Steuerelement mit idq ein neues Element angelegt werden soll insertbeforemso String Gibt an, vor welches eingebaute Steuerelement mit idmso ein neues Element angelegt werden soll insertbeforeq String Gibt an, vor welches eingebaute Steuerelement mit idq ein neues Element angelegt werden soll Height Long Höhe eines Elements des -Steuerelements in Pixeln Size String normal large Größe eines Menü-Elements Width Long Breite eines Elements des -Steuerelements in Pixeln keytip String Gibt das Tastenkürzel an, dass beim Betätigen der Alt- Taste erscheint label String Bezeichnungsfeld eines Steuerelements maxlength Long Maximale Länge einer einzugebenden Zeichenkette rows Long Anzahl der Zeilen in einem -Steuerelement screentip String Überschrift des beim Überfahren des Elements angezeigten Textes showimage String false true 0 1 Soll ein Symbol angezeigt werden? Tabelle 2: Attribute von -Elementen

5 Eigenschaft Datentyp Werte Beschreibung showitemimage String false true 0 1 Soll ein Symbol für ein Listenelement des combobox-, - oder -Steuerelements angezeigt werden? showitemlabel String false true 0 1 Soll ein Text für ein Listenelement des combobox-, drop- Down- oder -Steuerelements angezeigt werden? showlabel String false true 0 1 Soll die Bezeichnung eines Steuerelements angezeigt werden? size String normal large Legt die Größe für die Anzeige eines Steuerelements fest. sizestring String Das Steuerelement wird so breit gestaltet, dass der für diese Eigenschaft angegebene Text komplett angezeigt wird. startfromscratch String false true 0 1 Legt fest, ob eingebaute s und einige Einträge des Office-Menüs ausgeblendet werden. supertip String Unter dem screentip beim Überfahren eines Elements angezeigter Text tag String? title String Fügt einem Trennstrich eines menu-elements eine Beschriftung hinzu. visible String false true 0 1 Gibt an, ob ein Element sichtbar ist. Tabelle 2: Attribute von -Elementen

6 Elemente, Attribute und Ereignisse Eigenschaft Steuerelement VBA-Syntax getdescription (several controls) Sub GetDescription(control As IControl, ByRef description) getenabled (several controls) Sub GetEnabled(control As IControl, ByRef enabled) getimage (several controls) Sub GetImage(control As IControl, ByRef image) getimagemso (several controls) Sub GetImageMso(control As IControl, ByRef imagemso) getitemcount combobox Sub GetItemCount(control As IControl, ByRef count) Sub GetItemCount(control As IControl, ByRef count) Sub GetItemCount(control As IControl, ByRef count) getitemheight Sub getitemheight(control As IControl, ByRef height) getitemid combobox Sub GetItemID(control As IControl, index As Integer, ByRef id) Sub GetItemID(control As IControl, index As Integer, ByRef id) Sub GetItemID(control As IControl, index As Integer, ByRef id) getitemimage combobox Sub GetItemImage(control As IControl, index As Integer, ByRef image) Sub GetItemImage(control As IControl, index As Integer, ByRef image) Sub GetItemImage(control As IControl, index As Integer, ByRef image) getitemlabel combobox Sub GetItemLabel(control As IControl, index As Integer, ByRef label) Sub GetItemLabel(control As IControl, index As Integer, ByRef label) Sub GetItemLabel(control As IControl, index As Integer, ByRef label) getitemscreentip combobox Sub GetItemScreenTip(control As IControl, index As Integer, ByRef screentip) Sub GetItemScreenTip(control As IControl, index As Integer, ByRef screentip) Sub GetItemScreenTip(control As IControl, index as Integer, ByRef screen) getitemsupertip combobox Sub GetItemSuperTip (control As IControl, index As Integer, ByRef supertip) Sub GetItemSuperTip (control As IControl, index As Integer, ByRef supertip) Sub GetItemSuperTip (control As IControl, index as Integer, ByRef screen) getitemwidth Sub getitemwidth(control As IControl, ByRef width) getkeytip (several controls) Sub GetKeytip (control As IControl, ByRef label) getlabel (several controls) Sub GetLabel(control As IControl, ByRef label) getpressed checkbox Sub GetPressed(control As IControl, ByRef return) Sub GetPressed(control As IControl, ByRef return) getscreentip (several controls) Sub GetScreentip(control As IControl, ByRef screentip) getselecteditemid Sub GetSelectedItemID(control As IControl, ByRef index) Tabelle 3: Ereignisse von -Elementen und die Syntax der passenden VBA-Routinen

7 Eigenschaft Steuerelement VBA-Syntax Sub GetSelectedItemID(control As IControl, ByRef index) getselecteditemindex Sub GetSelectedItemIndex(control As IControl, ByRef index) Sub GetSelectedItemIndex(control As IControl, ByRef index) getshowimage button Sub GetShowImage (control As IControl, ByRef showimage) getshowlabel button Sub GetShowLabel (control As IControl, ByRef showlabel) getsize (several controls) Sub GetSize(control As IControl, ByRef size) getsupertip (several controls) Sub GetSupertip(control As IControl, ByRef screentip) gettext combobox Sub GetText(control As IControl, ByRef text) Sub GetText(control As IControl, ByRef text) gettitle menuseparator Sub GetTitle (control As IControl, ByRef title) getvisible (several controls) Sub GetVisible(control As IControl, ByRef visible) loadimage customui Sub LoadImage(imageId As string, ByRef image) onaction button Sub OnAction(control As IControl) checkbox Sub OnAction(control As IControl, pressed As Boolean) Sub OnAction(control As IControl, selectedid As String, selectedindex As Integer) Sub OnAction(control As IControl, selectedid As String, selectedindex As Integer) Sub OnAction(control As IControl, pressed As Boolean) onchange combobox Sub OnChange(control As IControl, text As String) Sub OnChange(control As IControl, text As String) onload customui Sub OnLoad(ribbon As IUI) Tabelle 3: Ereignisse von -Elementen und die Syntax der passenden VBA-Routinen

8 Elemente, Attribute und Ereignisse Eigenschaften/ Steuerelemente box button buttongroup checkbox combobox command customui dynamicmenu boxstyle columns description enabled getcontent getdescription getenabled getimage getimagemso getitemcount getitemheight getitemid getitemimage getitemlabel getitemsupertip getitemwidth getkeytip getlabel getpressed getscreentip getshowimage getitemscreentip getselecteditemid getselecteditemindex getshowitemimage getshowlabel getsize getsupertip gettext gettitle Tabelle 4: Kombinationen aus Elementen und Attributen/Ereignissen labelcontrol menu menuseparator ribbon separator splitbutton tab tabset textbox

9 Eigenschaften/ Steuerelemente box button buttongroup checkbox combobox command customui dynamicmenu getvisible id idmso idq image imagemso insertaftermso insertafterq insertbeforemso insertbeforeq ItemHeight Size ItemWidth keytip label loadimage maxlength onaction onchange onload rows screentip showimage showitemimage showitemlabel showlabel size sizestring startfrom- Scratch supertip tag visible Tabelle 4: Kombinationen aus Elementen und Attributen/Ereignissen labelcontrol menu menuseparator ribbon separator splitbutton tab tabset textbox