Udostępnij za pośrednictwem


Element flagi polecenia

Modyfikuje element nadrzędny.

Składnia

<CommandFlag>DynamicVisibility</CommandFlag>

Atrybuty i elementy

W poniższej sekcji opisano prawidłowe wartości elementów.

Atrybuty

Brak.

Elementy podrzędne

Wartość Opis
AllowParams Wskazuje, że użytkownicy mogą wprowadzać parametry polecenia w oknie Polecenia , gdy wpiszą nazwę kanoniczną polecenia.

Prawidłowe dla: Button
Zawszeutwórz Menu jest tworzone, nawet jeśli nie ma żadnych grup ani przycisków.

Prawidłowe dla: Menu
Casesensitive W pozycjach użytkownika jest rozróżniana wielkość liter.

Prawidłowe dla: Combo
CommandWellOnly Zastosuj tę flagę, jeśli polecenie nie jest wyświetlane w menu najwyższego poziomu i chcesz udostępnić ją w celu dodatkowego dostosowania powłoki, na przykład w celu powiązania go ze skrótem klawiaturowym. Po zainstalowaniu pakietu VSPackage można dostosować te polecenia, otwierając okno dialogowe Opcje , a następnie edytując umieszczanie poleceń w kategorii Środowisko klawiatury. Ta flaga nie ma wpływu na umieszczanie w menu skrótów, paskach narzędzi, kontrolerach menu lub podmenu.

Prawidłowe dla: Button, Combo
DefaultDisabled Domyślnie polecenie jest wyłączone, jeśli pakiet VSPackage, który implementuje go nie jest załadowany lub QueryStatus metoda nie została wywołana.

Prawidłowe dla: Button, Combo
DefaultDocked Domyślnie zadokowany. To ustawienie nie ma już zastosowania do pasków narzędzi, ponieważ są one zawsze zadokowane.
DefaultInvisible Domyślnie polecenie jest niewidoczne, jeśli pakiet VSPackage, który go implementuje, nie został załadowany lub QueryStatus metoda nie została wywołana.

Zalecamy połączenie tej funkcji z flagą DynamicVisibility .

Prawidłowe dla: Button, , ComboMenu
DontCache Środowisko programistyczne nie buforuje QueryStatus wyników metody dla tego polecenia.

W przypadku menu informuje kontroler menu, aby nie buforować tekstu elementów menu. Użyj tej flagi, gdy menu zawiera elementy dynamiczne lub elementy, które mają tekst dynamiczny.

Prawidłowe dla: Button, Menu
DynamicAutomationName Określa, że procedura obsługi QueryStatus będzie reagować na OLECMDTEXTFEXT_AUTOMATIONNAME i zwraca ciąg, który ma być używany jako nazwa automatyzacji dla kontrolki. Jeśli używasz polecenia OleMenuCommand, możesz ustawić właściwość AutomationName w procedurze obsługi BeforeQueryStatus, jeśli ta flaga jest ustawiona.

W przypadku użycia w elemecie Menu ta flaga ma zastosowanie tylko do menu typu MenuController lub MenuControllerLatched.

Prawidłowe dla: Button, , ComboMenu
DynamicItemStart Wskazuje początek listy dynamicznej. Dzięki temu środowisko może utworzyć listę przez kolejne wywołanie QueryStatus metody w elementach listy do momentu zwrócenia flagi OLECMDERR_E_UNSUPPORTED. Działa to dobrze w przypadku elementów, takich jak listy ostatnio używane (MRU) i listy okien.

Prawidłowe dla: Button
Dynamiczne widoczność Widoczność polecenia można zmienić za pomocą metody lub za pomocą QueryStatus identyfikatora GUID kontekstu zawartego VisibilityConstraints w sekcji.

Dotyczy poleceń wyświetlanych na paskach narzędzi i menu, ale nie na paskach narzędzi najwyższego poziomu, które są wyświetlane w oknie głównym. Elementy paska narzędzi najwyższego poziomu można wyłączyć, ale nie ukrywać, gdy flaga OLECMDF_INVISIBLE jest zwracana z QueryStatus metody . Polecenia paska narzędzi wyświetlane na paskach narzędzi mogą być ukryte.

W menu ta flaga wskazuje również, że powinna być automatycznie ukryta, gdy wszystkie jego elementy członkowskie są ukryte. Ta flaga jest zwykle przypisywana do podmenu, ponieważ menu najwyższego poziomu mają już to zachowanie.

Ta flaga powinna być połączona z flagą DefaultInvisible .

Prawidłowe dla: Button, , ComboMenu
FiltryKlucze Zobacz temat Filtrowanie kluczy w obszarze Element kombi.

Prawidłowe dla: Combo
FixMenuController Jeśli to polecenie jest umieszczone na kontrolerze menu, polecenie jest zawsze domyślne; oznacza to, że polecenie jest zaznaczone za każdym razem, gdy zostanie wybrany przycisk kontrolera menu. Jeśli kontroler menu ma ustawioną flagę TextIsAnchorCommand , kontroler menu pobiera również jego tekst z polecenia, które ma flagę FixMenuController .

Flaga FixMenuController powinna zawierać tylko jedno polecenie na kontrolerze menu. Jeśli więcej niż jedno polecenie jest tak oznaczone, ostatnie polecenie w menu staje się poleceniem domyślnym.

Prawidłowe dla: Button
IconAndText Pokaż ikonę i tekst w menu i pasku narzędzi.

Prawidłowe dla: Button, , ComboMenu
NoAutoComplete Funkcja autouzupełniania jest wyłączona.

Prawidłowe dla: Combo
NoButtonCustomize Nie pozwól użytkownikowi dostosować tego przycisku.

Prawidłowe dla: Button, Combo
NoKeyCustomize Nie włączaj dostosowywania klawiatury.

Prawidłowe dla: Button, Combo
NoShowOnMenuController Jeśli to polecenie jest umieszczone na kontrolerze menu, polecenie nie jest wyświetlane na liście rozwijanej.

Prawidłowe dla: Button
NotInTBList Nie jest wyświetlana na liście dostępnych pasków narzędzi. Jest to prawidłowe tylko dla typów menu paska narzędzi.

Prawidłowe dla: Menu
NoToolbarClose Użytkownik nie może zamknąć paska narzędzi. Jest to prawidłowe tylko dla typów menu paska narzędzi.

Prawidłowe dla: Menu
Pict Pokaż tylko ikonę na pasku narzędzi, ale tylko tekst w menu. Jeśli nie określono żadnej ikony, na pasku narzędzi zostanie wyświetlone możliwe kliknięcie puste miejsce.

Prawidłowe dla: Button
PostExec Sprawia, że polecenie nie blokuje. Środowisko deweloperskie odwraca wykonywanie do momentu ukończenia wszystkich zapytań przetwarzania wstępnego.

Prawidłowe dla: Button
RouteToDocs Polecenie jest kierowane do aktywnego dokumentu.

Prawidłowe dla: Button
StretchHorizontally Po ustawieniu tej flagi szerokość staje się minimalną szerokością pola kombi, a jeśli na pasku narzędzi znajduje się miejsce, pole kombi rozciąga się w celu wypełnienia dostępnego miejsca. Dzieje się tak tylko wtedy, gdy pasek narzędzi jest zadokowany w poziomie, a tylko jedno pole kombi na pasku narzędzi może używać flagi (flaga jest ignorowana na wszystkich z wyjątkiem pierwszego pola kombi).

Prawidłowe dla: Combo
Zamiany tekstu Tekst polecenia lub menu można zmienić w czasie wykonywania, zazwyczaj za pomocą QueryStatus metody .

Prawidłowe dla: Button, Menu
TextChangesButton Prawidłowe dla: Button
TextIsAnchorCommand W przypadku kontrolera menu tekst menu jest pobierany z domyślnego (kotwicy) polecenia. Polecenie kotwicy jest ostatnim poleceniem wybranym lub zatrzaśniętym. Jeśli ta flaga nie jest ustawiona, kontroler menu używa własnego MenuText pola. Jednak kliknięcie kontrolera menu nadal włącza ostatnie wybrane polecenie z tego kontrolera.

Zalecamy połączenie tej flagi z flagą TextChanges .

Ta flaga dotyczy tylko menu typu MenuController lub MenuControllerLatched.

Prawidłowe dla: Menu
TextMenuCtrlUseMenu MenuText Użyj pola na kontrolerach menu. Polem domyślnym jest ButtonText.

Prawidłowe dla: Button
TextMenuUseButton ButtonText Użyj pola dla menu. Pole domyślne to MenuText , jeśli jest określone.

Prawidłowe dla: Button
Textonly Pokaż tylko tekst na pasku narzędzi lub menu, ale nie ma ikony, nawet jeśli jest określona ikona.

Prawidłowe dla: Button
PrzełącznikPatternAvailable Wskazuje, że przycisk obsługuje sprawdzanie/zatrzaśnięty (oznacza to, że może zwrócić OLEMCDF_LATCHED lub ustawić właściwość Checked na OleMenuCommand). Dzięki temu warstwa automatyzacji uwidacznia wzorzec przełącznika, dzięki czemu czytniki zawartości ekranu będą odczytywać zaznaczony/niezaznakowany stan wraz z tekstem przycisku.

Prawidłowe dla: Button

Elementy nadrzędne

Element opis
Element Przyciski Udostępnia grupę elementów przycisku .
Menu, element Definiuje wszystkie menu implementowane przez pakiet VSPackage.

Zobacz też