Návrh příkazu

Když do balíčku VSPackage přidáte příkaz, musíte určit, kde se má zobrazit, kdy je k dispozici a jak se má zpracovat.

Definování příkazů

Pokud chcete definovat nové příkazy, zahrňte do projektu VSPackage soubor tabulky příkazů sady Visual Studio (.vsct). Pokud jste vytvořili balíček VSPackage pomocí šablony balíčku sady Visual Studio, projekt obsahuje jeden z těchto souborů. Další informace najdete v souborech příkazové tabulky sady Visual Studio (.vsct).

Visual Studio sloučí všechny soubory .vsct , které najde, aby mohl zobrazit příkazy. Vzhledem k tomu, že se tyto soubory liší od binárního souboru VSPackage, visual Studio nemusí balíček načíst, aby příkazy našli. Další informace naleznete v tématu Jak balíčky VSPackages přidávají prvky uživatelského rozhraní.

Visual Studio používá ProvideMenuResourceAttribute atribut registrace k definování prostředků a příkazů nabídky. Další informace naleznete v tématu Implementace příkazu.

Příkazy je možné změnit v době běhu několika různými způsoby. Můžou se zobrazit nebo skrýt, povolit nebo zakázat. Můžou zobrazovat různé texty nebo ikony nebo obsahovat různé hodnoty. Před načtením balíčku VSPackage sady Visual Studio může být provedeno velké množství přizpůsobení. Další informace naleznete v tématu Jak balíčky VSPackages přidávají prvky uživatelského rozhraní.

Obslužné rutiny příkazů

Při vytváření příkazu je nutné zadat obslužnou rutinu události ke spuštění příkazu. Pokud uživatel vybere příkaz, musí být správně směrován. Směrování příkazu znamená, že ho odešlete do správného balíčku VSPackage, který povolí nebo zakáže, skryje nebo zobrazí a spustí ho, pokud se to uživatel rozhodne. Další informace naleznete v tématu Algoritmus směrování příkazů.

Příkazové prostředí sady Visual Studio

Visual Studio může hostovat libovolný počet balíčků VSPackage a každý může přispívat vlastní sadou příkazů. Prostředí zobrazí pouze příkazy, které jsou vhodné pro aktuální úlohu. Další informace najdete v tématu Dostupnost příkazů a kontextové objekty výběru.

Balíček VSPackage, který definuje nové příkazy, nabídky, panely nástrojů nebo místní nabídky, poskytuje v sadě Visual Studio informace o příkazech v době instalace prostřednictvím položek registru, které odkazují na prostředky v nativních nebo spravovaných sestaveních. Každý prostředek pak odkazuje na soubor binárního datového prostředku (.cto), který se vytvoří při kompilaci souboru tabulky příkazů sady Visual Studio (.vsct). To umožňuje sadě Visual Studio poskytovat sloučené sady příkazů, nabídky a panely nástrojů, aniž by bylo nutné načítat všechny nainstalované balíčky VSPackage.

Organizace příkazů

Prostředí umístí příkazy podle skupiny, priority a nabídky.

• Skupiny jsou logické kolekce souvisejících příkazů, například skupina příkazů Vyjmout, Kopírovat a Vložit . Skupiny jsou příkazy, které se zobrazují v nabídkách.

• Priorita určuje pořadí, ve kterém se jednotlivé příkazy ve skupině zobrazí v nabídce.

• Nabídky fungují jako kontejnery pro skupiny.

  Prostředí předdefinuje některé příkazy, skupiny a nabídky. Další informace naleznete v tématu Výchozí příkaz, skupina a umístění panelu nástrojů.

  Příkaz lze přiřadit primární skupině. Primární skupina řídí pozici příkazu v hlavní struktuře nabídek a v dialogovém okně Přizpůsobit . Příkaz se může objevit ve více skupinách; Příkaz může být například v hlavní nabídce, v místní nabídce a na panelu nástrojů. Další informace naleznete v tématu Jak balíčky VSPackages přidávají prvky uživatelského rozhraní.

Směrování příkazů

Proces vyvolání a směrování příkazů pro VSPackage se liší od procesu volání metod v instancích objektů.

Prostředí směruje příkazy postupně z nejvnitřnějšího (místního) kontextu příkazu, který je založen na aktuálním výběru, do vnějšího (globálního) kontextu. Prvním kontextem, který je schopen provést příkaz, je ten, který ho zpracovává. Další informace naleznete v tématu Algoritmus směrování příkazů.

Ve většině případů prostředí zpracovává příkazy pomocí IOleCommandTarget rozhraní. Vzhledem k tomu, že schéma směrování příkazů umožňuje zpracování příkazů mnoha různými objekty, IOleCommandTarget lze je implementovat libovolným počtem objektů. Patří mezi ně ovládací prvky Microsoft technologie ActiveX, implementace zobrazení oken, objekty dokumentů, hierarchie projektů a samotné objekty VSPackage (pro globální příkazy). V některých specializovaných případech, například příkazy směrování v hierarchii, IVsHierarchy musí být implementováno rozhraní.

Příbuzná témata

Titulek	Popis
Implementace příkazů	Popisuje, jak implementovat příkazy v balíčku VSPackage.
Dostupnost příkazů	Popisuje, jak kontext sady Visual Studio určuje, které příkazy jsou k dispozici.
Algoritmus směrování příkazů	Popisuje, jak architektura směrování příkazů sady Visual Studio umožňuje zpracování příkazů různými balíčky VSPackage.
Pokyny pro umístění příkazů	Navrhuje umístění příkazů v prostředí sady Visual Studio.
Jak balíčky VSPackage přidávají prvky uživatelského rozhraní	Popisuje, jak můžou balíčky VSPackage nejlépe využívat architekturu příkazů sady Visual Studio.
Výchozí umístění příkazů, skupin a panelů nástrojů	Popisuje, jak můžou balíčky VSPackage nejlépe používat příkazy, které jsou součástí sady Visual Studio.
Správa balíčků VSPackage	Popisuje, jak Sada Visual Studio načítá balíčky VSPackage.
Soubory tabulky příkazů sady Visual Studio (.vsct)	Poskytuje informace o souborech .vsct založených na jazyce XML, které slouží k popisu rozložení a vzhledu příkazů v rozšíření VSPackages.