Projekt polecenia

Po dodaniu polecenia do pakietu VSPackage należy określić, gdzie ma ona być wyświetlana, gdy jest dostępna i jak ma być obsługiwana.

Definiowanie poleceń

Aby zdefiniować nowe polecenia, dołącz plik tabeli poleceń programu Visual Studio (vsct) do projektu VSPackage. Jeśli pakiet VSPackage został utworzony przy użyciu szablonu pakietu programu Visual Studio, projekt zawiera jeden z tych plików. Aby uzyskać więcej informacji, zobacz pliki tabeli poleceń programu Visual Studio (vsct).

Program Visual Studio scala wszystkie znalezione pliki vsct , aby można było wyświetlić polecenia. Ponieważ te pliki różnią się od pliku binarnego VSPackage, program Visual Studio nie musi załadować pakietu w celu znalezienia poleceń. Aby uzyskać więcej informacji, zobacz Jak pakiety VSPackages dodają elementy interfejsu użytkownika.

Program Visual Studio używa atrybutu ProvideMenuResourceAttribute rejestracji do definiowania zasobów menu i poleceń. Aby uzyskać więcej informacji, zobacz Implementacja poleceń.

Polecenia można zmieniać w czasie wykonywania na wiele różnych sposobów. Mogą być wyświetlane lub ukryte, włączone lub wyłączone. Mogą wyświetlać różne tekst lub ikony albo zawierać różne wartości. Przed załadowaniem pakietu VSPackage przez program Visual Studio można przeprowadzić wiele dostosowań. Aby uzyskać więcej informacji, zobacz Jak pakiety VSPackages dodają elementy interfejsu użytkownika.

Programy obsługi poleceń

Podczas tworzenia polecenia należy podać program obsługi zdarzeń, aby wykonać polecenie. Jeśli użytkownik wybierze polecenie, musi być odpowiednio kierowany. Rozsyłanie polecenia oznacza wysłanie go do poprawnego pakietu VSPackage w celu włączenia lub wyłączenia go, ukrycia lub wyświetlenia i wykonania go, jeśli użytkownik zdecyduje się to zrobić. Aby uzyskać więcej informacji, zobacz Algorytm routingu poleceń.

Środowisko poleceń programu Visual Studio

Program Visual Studio może hostować dowolną liczbę pakietów VSPackage, a każdy z nich może współtworzyć własny zestaw poleceń. Środowisko wyświetla tylko polecenia odpowiednie dla bieżącego zadania. Aby uzyskać więcej informacji, zobacz Dostępność poleceń i Obiekty kontekstu zaznaczenia.

Pakiet VSPackage definiujący nowe polecenia, menu, paski narzędzi lub menu skrótów udostępnia informacje o poleceniach programu Visual Studio podczas instalacji za pośrednictwem wpisów rejestru odwołujących się do zasobów w zestawach natywnych lub zarządzanych. Następnie każdy zasób odwołuje się do pliku zasobu danych binarnych (cto), który jest generowany podczas kompilowania pliku tabeli poleceń programu Visual Studio (.vsct). Dzięki temu program Visual Studio udostępnia scalone zestawy poleceń, menu i paski narzędzi bez konieczności ładowania wszystkich zainstalowanych pakietów VSPackage.

Organizacja poleceń

Środowisko umieszcza polecenia według grupy, priorytetu i menu.

• Grupy to logiczne kolekcje powiązanych poleceń, na przykład grupa poleceń Wycinanie, kopiowanie i wklejanie . Grupy to polecenia wyświetlane w menu.

• Priorytet określa kolejność wyświetlania poszczególnych poleceń w grupie w menu.

• Menu działają jako kontenery dla grup.

  Środowisko wstępnie zdefiniowanych poleceń, grup i menu. Aby uzyskać więcej informacji, zobacz Domyślne polecenie, grupa i umieszczanie paska narzędzi.

  Polecenie można przypisać do grupy podstawowej. Grupa podstawowa kontroluje położenie polecenia w strukturze menu głównego i w oknie dialogowym Dostosowywanie . Polecenie może być wyświetlane w wielu grupach; na przykład polecenie może znajdować się w menu głównym, w menu skrótów i na pasku narzędzi. Aby uzyskać więcej informacji, zobacz Jak pakiety VSPackages dodają elementy interfejsu użytkownika.

Routing poleceń

Proces wywoływania i routingu poleceń dla pakietów VSPackage różni się od procesu wywoływania metod w wystąpieniach obiektów.

Środowisko kieruje polecenia sekwencyjnie z najbardziej wewnętrznego (lokalnego) kontekstu polecenia, który jest oparty na bieżącym zaznaczeniu, do najbardziej zewnętrznego (globalnego) kontekstu. Pierwszym kontekstem, który jest w stanie wykonać polecenie, jest ten, który go obsługuje. Aby uzyskać więcej informacji, zobacz Algorytm routingu poleceń.

W większości przypadków środowisko obsługuje polecenia przy użyciu interfejsu IOleCommandTarget . Ponieważ schemat routingu poleceń umożliwia obsługę poleceń wielu różnych obiektów, można zaimplementować przez dowolną liczbę obiektów; IOleCommandTarget obejmują one kontrolki Microsoft ActiveX, implementacje widoku okien, obiekty dokumentów, hierarchie projektów i same obiekty vsPackage (dla poleceń globalnych). W niektórych wyspecjalizowanych przypadkach, na przykład polecenia routingu w hierarchii, IVsHierarchy interfejs musi zostać zaimplementowany.

Powiązane tematy

Nazwa	opis
Implementacja poleceń	Opisuje sposób implementowania poleceń w programie VSPackage.
Dostępność poleceń	Opisuje sposób określania kontekstu programu Visual Studio, które polecenia są dostępne.
Algorytm routingu poleceń	Opisuje sposób, w jaki architektura routingu poleceń programu Visual Studio umożliwia obsługę poleceń przez różne pakiety VSPackage.
Wskazówki dotyczące umieszczania poleceń	Sugeruje sposób umieszczania poleceń w środowisku programu Visual Studio.
Jak pakiety VSPackage dodają elementy interfejsu użytkownika	Opisuje sposób, w jaki pakiety VSPackage mogą najlepiej korzystać z architektury poleceń programu Visual Studio.
Domyślne umieszczanie poleceń, grup i pasków narzędzi	Opisuje, jak pakiety VSPackage mogą najlepiej używać poleceń zawartych w programie Visual Studio.
Zarządzanie pakietami VSPackage	Opisuje sposób ładowania pakietów VSPackage programu Visual Studio.
Pliki tabeli poleceń programu Visual Studio (vsct)	Zawiera informacje o plikach vsct opartych na formacie XML, które służą do opisywania układu i wyglądu poleceń w pakietach VSPackage.