Visual Studio menü çubuğuna menü ekleme

Bu izlenecek yol, Visual Studio tümleşik geliştirme ortamının (IDE) menü çubuğuna nasıl menü ekleneceğini gösterir. IDE menü çubuğunda Dosya, Düzenleme, Görünüm, Pencere ve Yardım gibi menü kategorileri bulunur.

Visual Studio menü çubuğuna yeni menü eklemeden önce komutlarınızın mevcut bir menüye yerleştirilip yerleştirilmeyeceğini göz önünde bulundurun. Komut yerleştirme hakkında daha fazla bilgi için bkz . Visual Studio için menüler ve komutlar.

Menüler projenin .vsct dosyasında bildirilir. Menüler ve .vsct dosyaları hakkında daha fazla bilgi için bkz . Komutlar, menüler ve araç çubukları.

Bu kılavuzu tamamlayarak, tek bir komut içeren Test Menüsü adlı bir menü oluşturabilirsiniz.

Özel komut öğesi şablonu olan bir VSIX projesi oluşturma

1. adlı TopLevelMenubir VSIX projesi oluşturun. "vsix" araması yaparak VSIX proje şablonunu Yeni Proje iletişim kutusunda bulabilirsiniz. Daha fazla bilgi için bkz . Menü komutuyla uzantı oluşturma.

2. Proje açıldığında TestCommand adlı özel bir komut öğesi şablonu ekleyin. Çözüm Gezgini proje düğümüne sağ tıklayın ve Yeni Öğe Ekle'yi>seçin. Yeni Öğe Ekle iletişim kutusunda Visual C# / Genişletilebilirlik'e gidin ve Komut'a tıklayın. Pencerenin en altındaki Ad alanında, komut dosyası adını TestCommand.cs olarak değiştirin.

IDE menü çubuğunda menü oluşturma

1. Çözüm Gezgini'da TopLevelMenuPackage.vsct dosyasını açın.

   Dosyanın sonunda, birkaç <GuidSymbol> düğüm içeren bir <Symbols> düğüm vardır. adlı guidTopLevelMenuPackageCmdSetdüğüme aşağıdaki gibi yeni bir simge ekleyin:

   <IDSymbol name="TopLevelMenu" value="0x1021"/>
   

2. düğümde<Commands>, hemen öncesinde <Groups>boş <Menus> bir düğüm oluşturun. Düğümde <Menus> , aşağıdaki gibi bir <Menu> düğüm ekleyin:

   <Menus>
         <Menu guid="guidTopLevelMenuPackageCmdSet" id="TopLevelMenu" priority="0x700" type="Menu">
           <Parent guid="guidSHLMainMenu"
                   id="IDG_VS_MM_TOOLSADDINS" />
           <Strings>
             <ButtonText>Test Menu</ButtonText>
           </Strings>
       </Menu>
   </Menus>
   

   guid Menünün ve id değerleri, komut kümesini ve komut kümesindeki belirli menüyü belirtir.

   guid Üst öğe ve id değerleri, Visual Studio menü çubuğunun Araçlar ve Eklentiler menülerini içeren bölümünde menüyü konumlandırın.

   öğesi, <ButtonText> metnin menü öğesinde gösterilmesi gerektiğini belirtir.

3. <Groups> bölümünde öğesini bulun <Group> ve öğesini yeni eklediğimiz menüye işaret eden şekilde değiştirin<Parent>:

   <Groups>
       <Group guid="guidTopLevelMenuPackageCmdSet" id="MyMenuGroup" priority="0x0600">
           <Parent guid="guidTopLevelMenuPackageCmdSet" id="TopLevelMenu"/>
       </Group>
   </Groups>
   

   Bu, grubu yeni menünün bir parçası yapar.

4. <Buttons> bölümünde düğümü bulun<Button>. Ardından düğümde <Strings> öğesini olarak Test Commanddeğiştirin<ButtonText>.

   Visual Studio Paket şablonunun üst öğesi olarak ayarlanmış bir Button öğe oluşturduğuna MyMenuGroupdikkat edin. Sonuç olarak, bu komut menünüzün üzerinde görünür.

Uzantıyı derleme ve test etme

1. Projeyi derleyin ve hata ayıklamaya başlayın. Deneysel örneğin bir örneği görünmelidir.

2. Deneysel örnekteki Uzantılar menüsü bir Test Menüsü menüsü içermelidir.

3. Test Menüsü menüsünde Test Komutu'na tıklayın.

   Bir ileti kutusu görünmelidir ve "TestCommand Inside TopLevelMenu.TestCommand.MenuItemCallback()" iletisini görüntülemelidir.

İlgili içerik

• Komutlar, menüler ve araç çubukları