UI_EVENTPARAMS_COMMAND Struktur (uiribbon.h)
Enthält Informationen zu einem Befehl, der einem Ereignis zugeordnet ist.
Syntax
typedef struct _UI_EVENTPARAMS_COMMAND {
UINT CommandID;
PCWSTR CommandName;
UINT ParentCommandID;
PCWSTR ParentCommandName;
UINT SelectionIndex;
UI_EVENTLOCATION Location;
} UI_EVENTPARAMS_COMMAND;
Member
CommandID
Die ID des Befehls , der sich direkt auf das Ereignis bezieht, das in der Markupressourcendatei angegeben wird.
CommandName
Der Befehlsname , der CommandId zugeordnet ist.
ParentCommandID
Die ID für das übergeordnete Element des Befehls, der in der Markupressourcendatei angegeben wird.
ParentCommandName
Der Befehlsname des übergeordneten Elements, das CommandId zugeordnet ist.
SelectionIndex
SelectionIndex wird nur verwendet, wenn ein UI_EVENTTYPE_CommandExecuted ausgelöst wurde, als Reaktion darauf, dass der Benutzer ein Element in einem ComboBox- oder Elementkatalog ausgewählt hat. In diesen Fällen enthält SelectionIndex den Index des ausgewählten Elements. In allen anderen Fällen ist sie auf 0 festgelegt.
Location
Einer der Werte von UI_EVENTLOCATION.
Hinweise
Der von CommandID und CommandName identifizierte Befehl hängt davon ab, welches Ereignis aufgetreten ist: Bei einem UI_EVENTTYPE_TabActivated Ereignis identifizieren sie die Registerkarte; für ein UI_EVENTTYPE_MenuOpened-Ereignis identifizieren sie das Menü; für UI_EVENTTYPE_CommandExecuted Ereignisse identifizieren sie den auszuführenden Befehl; und für UI_EVENTTYPE_TooltipShown Ereignisse identifizieren sie den Befehl , der diese QuickInfo besitzt.
ParentCommandID und ParentCommandName identifizieren den übergeordneten Befehl (falls vorhanden) des Befehls, der diesem Ereignis zugeordnet ist. Wenn kein übergeordnetes Element vorhanden ist, ist ParentCommandID null und ParentCommandName ist eine leere Zeichenfolge.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Kopfzeile | uiribbon.h |