Udostępnij za pośrednictwem

Element kombi

  • Artykuł

Definiuje polecenia wyświetlane w polu kombi. Istnieją cztery rodzaje pól kombi, w następujący sposób: DropDownCombo, DynamicCombo, IndexCombo i MRUCombo.

Składnia

<combo guid="guidMyCommandSet" id="MyCommand" defaultWidth="20" idCommandList="MyCommandListID" priority="0x102" type="DropDownCombo">
  <Parent>... </Parent
  <CommandFlag>... </CommandFlag>
  <Strings>... </Strings>
</combo>

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.
defaultWidth Wymagany. Liczba całkowita określająca szerokość pikseli pola kombi.
idCommandList Wymagany. Identyfikator wysyłany do aktywnego obiektu docelowego polecenia w celu pobrania listy elementów, które mają być wyświetlane w polu kombi. Identyfikator będzie znajdować się w tym samym zakresie identyfikatora GUID co kontrolka.
priority Opcjonalny. Wartość liczbowa określająca priorytet.
type Opcjonalny. Wyliczona wartość określająca typ przycisku.

Jeśli nie podano, użyj przycisku.

DropDownCombo
Pakiet VSPackage jest odpowiedzialny za wypełnienie zawartości tego pola kombi. Użytkownik nie może wpisać niczego w polu tekstowym tej listy rozwijanej.

DynamicCombo
Pakiet VSPackage jest odpowiedzialny za wypełnienie zawartości tego pola kombi. Użytkownik może edytować tę kombinację, a także wybierać elementy.

IndexCombo
Tak samo jak DynamicCombo, z tą różnicą, że zgłasza indeks elementu, a nie jego tekst.

MRUCombo
Wypełnione przez zintegrowane środowisko projektowe (IDE) w imieniu pakietu VSPackage. Użytkownik może edytować w tym polu kombi. Środowisko IDE zapamiętuje maksymalnie 16 ostatnich wpisów na pole kombi.

Gdy użytkownik wybierze coś w polu kombi lub wprowadzi coś nowego, środowisko IDE powiadamia odpowiedni pakiet VSPackage.
Stan Opcjonalny. Zobacz Atrybuty warunkowe.

Elementy podrzędne

Element opis
Parent Opcjonalny. Element nadrzędny przycisku.
CommandFlag Wymagany. Zobacz Element flagi polecenia. Prawidłowe wartości CommandFlag dla przycisku są następujące.

-Casesensitive

- CommandWellOnly

- DefaultDisabled

- DefaultInvisible

- DynamicVisibility (Widoczność dynamiczna)

- FilterKeys

- IkonaAndText

- NoAutoComplete

- NoButtonCustomize

- NoCustomize

- NoKeyCustomize

- StretchHorizontally
Ciągi Wymagany. Zobacz Element Ciągi. Należy zdefiniować podrzędny element ButtonText.
Annotation Opcjonalny komentarz.

Elementy nadrzędne

Element opis
Commands, element Reprezentuje kolekcję poleceń na pasku narzędzi VSPackage.

Przykład

<Combo guid="guidWidgetPackage" id="cmdidInsertOptions"
  defaultWidth="100" idCommandList="cmdidGetInsertOptionsList">
  <CommandFlag>DynamicVisibility</CommandFlag>
  <Strings>
    <ButtonText>Select Insert Options</ButtonText>
  </Strings>
</Combo>

<Combo guid="guidWidgetPackage" id="cmdidInsertOptions"
  priority="0x0500" type="DropDownCombo" defaultWidth="100"
  idCommandList="cmdidGetInsertOptionsList">
  <Parent guid="cmdSetGuidWidgetCommands" id="groupIDFileEdit">
  <CommandFlag>DynamicVisibility</CommandFlag>
  <Strings>
    <ButtonText>Select Insert Options</ButtonText>
  </Strings>
</Combo>

Zobacz też