Komut tasarımı

BIR VSPackage'a komut eklediğinizde, nerede görüneceğini, ne zaman kullanılabilir olduğunu ve nasıl işleneceğini belirtmeniz gerekir.

Komutları tanımlama

Yeni komutları tanımlamak için VSPackage projenize bir Visual Studio komut tablosu (.vsct) dosyası ekleyin. Visual Studio paket şablonunu kullanarak bir VSPackage oluşturduysanız, proje bu dosyalardan birini içerir. Daha fazla bilgi için bkz. Visual Studio komut tablosu (.vsct) dosyaları.

Visual Studio, bulduğu tüm .vsct dosyalarını birleştirerek komutları görüntüleyebilmesini sağlar. Bu dosyalar VSPackage ikilisinden farklı olduğundan, Visual Studio'nın komutları bulmak için paketi yüklemesi gerekmez. Daha fazla bilgi için bkz. VSPackages kullanıcı arabirimi öğelerini nasıl ekler?

Visual Studio, menü kaynaklarını ve komutlarını tanımlamak için kayıt özniteliğini kullanır ProvideMenuResourceAttribute . Daha fazla bilgi için bkz. Komut uygulaması.

Komutlar çalışma zamanında çeşitli yollarla değiştirilebilir. Bunlar görüntülenebilir veya gizlenebilir, etkinleştirilebilir veya devre dışı bırakılabilir. Farklı metinler veya simgeler görüntüleyebilir veya farklı değerler içerebilirler. Visual Studio VSPackage'ınızı yüklemeden önce çok sayıda özelleştirme gerçekleştirilebilir. Daha fazla bilgi için bkz. VSPackages kullanıcı arabirimi öğelerini nasıl ekler?

Komut işleyicileri

Bir komut oluşturduğunuzda, komutu yürütmek için bir olay işleyicisi sağlamanız gerekir. Kullanıcı komutu seçerse uygun şekilde yönlendirilmelidir. Bir komutu yönlendirmek, bunu etkinleştirmek veya devre dışı bırakmak, gizlemek veya görüntülemek ve kullanıcı bunu yapmayı seçerse yürütmek için doğru VSPackage'a göndermek anlamına gelir. Daha fazla bilgi için bkz. Komut yönlendirme algoritması.

Visual Studio komut ortamı

Visual Studio istediğiniz sayıda VSPackage barındırabilir ve her biri kendi komut kümesine katkıda bulunabilir. Ortam yalnızca geçerli göreve uygun komutları görüntüler. Daha fazla bilgi için bkz. Komut kullanılabilirliği ve Seçim bağlam nesneleri.

Yeni komutları, menüleri, araç çubuklarını veya kısayol menülerini tanımlayan BIR VSPackage, komut bilgilerini yerel veya yönetilen derlemelerdeki kaynaklara başvuran kayıt defteri girdileri aracılığıyla yükleme zamanında Visual Studio'ya sağlar. Her kaynak daha sonra bir Visual Studio komut tablosu (.vsct) dosyası derlediğinizde oluşturulan bir ikili veri kaynağı (.cto) dosyasına başvurur. Bu, Visual Studio'nın yüklü tüm VSPackage'ları yüklemek zorunda kalmadan birleştirilmiş komut kümeleri, menüler ve araç çubukları sağlamasına olanak tanır.

Komut kuruluşu

Ortam komutları gruba, önceliğe ve menüye göre konumlandırr.

• Gruplar, kes, kopyala ve yapıştır komut grubu gibi ilgili komutların mantıksal koleksiyonlarıdır. Gruplar, menülerde görüntülenen komutlardır.

• Öncelik, bir gruptaki komutların menüde hangi sırayla görüneceğini belirler.

• Menüler, gruplar için kapsayıcı görevi görür.

  Ortam bazı komutları, grupları ve menüleri önceden tanımlanmıştır. Daha fazla bilgi için bkz. Varsayılan komut, grup ve araç çubuğu yerleşimi.

  Bir komut birincil gruba atanabilir. Birincil grup, komutun ana menü yapısındaki ve Özelleştir iletişim kutusundaki konumunu denetler. Bir komut birden çok grupta görünebilir; örneğin, komut ana menüde, kısayol menüsünde ve araç çubuğunda olabilir. Daha fazla bilgi için bkz. VSPackages kullanıcı arabirimi öğelerini nasıl ekler?

Komut yönlendirme

VSPackage'lar için komut çağırma ve yönlendirme işlemi, nesne örneklerinde yöntemleri çağırma işleminden farklıdır.

Ortam, komutları geçerli seçimi temel alan en içteki (yerel) komut bağlamından en dıştaki (genel) bağlama sıralı olarak yönlendirir. Komutu yürütebilen ilk bağlam, komutu işleyen bağlamdır. Daha fazla bilgi için bkz. Komut yönlendirme algoritması.

Çoğu durumda ortam, arabirimini kullanarak IOleCommandTarget komutları işler. Komut yönlendirme düzeni birçok farklı nesnenin komutları işlemesine olanak sağladığından, IOleCommandTarget herhangi bir sayıda nesne tarafından uygulanabilir; bunlar Microsoft ActiveX denetimleri, pencere görünümü uygulamaları, belge nesneleri, proje hiyerarşileri ve VSPackage nesnelerinin kendileridir (genel komutlar için). Bazı özel durumlarda, örneğin, bir hiyerarşideki yönlendirme komutları arabiriminin IVsHierarchy uygulanması gerekir.

İlgili konular

Başlık	Description
Komut uygulaması	VSPackage'da komutların nasıl uygulanacaklarını açıklar.
Komut kullanılabilirliği	Visual Studio bağlamı hangi komutların kullanılabilir olduğunu nasıl belirler açıklar.
Komut yönlendirme algoritması	Visual Studio komut yönlendirme mimarisinin komutların farklı VSPackage'lar tarafından işlenmesini nasıl sağladığını açıklar.
Komut yerleştirme yönergeleri	Visual Studio ortamında komutların nasıl konumlandırılacağı önerisinde bulunur.
VSPackages kullanıcı arabirimi öğelerini nasıl ekler?	VSPackage'ların Visual Studio komut mimarisini en iyi nasıl kullanabileceğini açıklar.
Varsayılan komut, grup ve araç çubuğu yerleşimi	VSPackage'ların Visual Studio'da bulunan komutları nasıl en iyi şekilde kullanabileceğini açıklar.
VSPackage'ları yönetme	Visual Studio'nın VSPackage'ları nasıl yüklediği açıklanır.
Visual Studio komut tablosu (.vsct) dosyaları	VSPackage'lardaki komutların düzenini ve görünümünü açıklamak için kullanılan XML tabanlı .vsct dosyaları hakkında bilgi sağlar.