Udostępnij za pośrednictwem

Element przycisku

  • Artykuł

Definiuje element, z którego użytkownik może korzystać. Przyciski mogą być różnego rodzaju: Przycisk, MenuButton i SplitDropDown.

Składnia

<Button guid="guidMyCommandSet" id="MyCommand" priority="0x102" type="button">
  <Parent>... </Parent>
  <Icon>... </Icon>
  <CommandFlag>... </CommandFlag>
  <Strings>... </Strings>
</Button>

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut opis
Identyfikator GUID Wymagany. Identyfikator GUID/identyfikator polecenia.
identyfikator Wymagany. Identyfikator identyfikatora polecenia identyfikatora GUID/identyfikatora.
priority Opcjonalny. Wartość liczbowa określająca priorytet.
type Opcjonalny. Wyliczona wartość określająca rodzaj przycisku.

Jeśli nie podano, użyj przycisku.

Przycisk
Standardowe polecenie wyświetlane na paskach narzędzi (zazwyczaj jako ikoniczny przycisk), menu i menu kontekstowe.

MenuButton
Element menu, który nie wykonuje polecenia, ale tworzy inne menu.

SplitDropDown
Kontrolki, takie jak przyciski Cofnij i Wykonaj ponownie na standardowym pasku narzędzi w programie Microsoft Word.
Stan Opcjonalny. Zobacz Atrybuty warunkowe.

Elementy podrzędne

Element opis
Element nadrzędny Opcjonalny. Element nadrzędny przycisku.
Ikona, element Opcjonalny. Ikona skojarzona z przyciskiem.
Element flagi polecenia Wymagany. Prawidłowe wartości CommandFlag dla przycisku są następujące.

- AllowParams

- CommandWellOnly

- DefaultDisabled

- DefaultInvisible

- DontCache

- DynamicItemStart

- DynamicVisibility (Widoczność dynamiczna)

- FixMenuController

- IkonaAndText

- NoButtonCustomize

- NoCustomize

- NoKeyCustomize

- NoShowOnMenuController

-Pict

- PostExec

- ProfferedCmd

- RouteToDocs

- TextCascadeUseBtn

- TextMenuUseButton

- Zamiany tekstu

- TextChangesButton

- TextContextUseButton

- TextMenuCtrlUseMenu

- TextMenuUseButton

-Textonly
Strings, element Wymagany. Należy zdefiniować podrzędny element ButtonText.
Annotation Opcjonalny komentarz.

Elementy nadrzędne

Element opis
Element Przyciski Elementy przycisków grup.

Przykład

W poniższym przykładzie zdefiniowano przycisk w pliku vsct .

<Button guid="guidMenuTextCmdSet" id="cmdidMyCommand" priority="0x0100" type="Button">
   <Parent guid="guidMenuTextCmdSet" id="MyMenuGroup" />
   <Icon guid="guidImages" id="bmpPic1" />
   <CommandFlag>TextChanges</CommandFlag>
   <Strings>
         <CommandName>cmdidMyCommand</CommandName>
         <ButtonText>My Command name</ButtonText>
   </Strings>
</Button>

Zobacz też