Araç penceresine araç çubuğu ekleme

Bu kılavuzda araç penceresine araç çubuğunun nasıl ekleneceği gösterilmektedir.

Araç çubuğu, komutlara bağlı düğmeler içeren yatay veya dikey bir şerittir. Araç penceresindeki araç çubuğunun uzunluğu, araç çubuğunun yerleştirildiği yere bağlı olarak araç penceresinin genişliği veya yüksekliğiyle her zaman aynıdır.

IDE'deki araç çubuklarının aksine, araç penceresindeki bir araç çubuğunun sabitlenmiş olması gerekir ve taşınamaz veya özelleştirilemez. VSPackage yönetilmeyen kodla yazılmışsa, araç çubuğu herhangi bir kenara yerleştirilebilir.

Araç çubuğu ekleme hakkında daha fazla bilgi için bkz . Araç çubuğu ekleme.

Araç penceresi için araç çubuğu oluşturma

1. Hem TWTestCommand adlı TWToolbar bir menü komutuna hem de TestToolWindow adlı bir araç penceresine sahip adlı bir VSIX projesi oluşturun. Daha fazla bilgi için bkz . Menü komutuyla uzantı oluşturma ve Araç penceresiyle uzantı oluşturma. Araç penceresi şablonunu eklemeden önce komut öğesi şablonunu eklemeniz gerekir.

2. TWTestCommandPackage.vsct dosyasında Simgeler bölümünü arayın. guidTWTestCommandPackageCmdSet adlı GuidSymbol düğümünde aşağıdaki gibi bir araç çubuğu ve araç çubuğu grubu bildirin.

   <IDSymbol name="TWToolbar" value="0x1000" />
   <IDSymbol name="TWToolbarGroup" value="0x1050" />
   

3. Bölümün Commands en üstünde bir Menus bölüm oluşturun. Araç çubuğunu tanımlamak için bir Menu öğe ekleyin.

   <Menus>
       <Menu guid="guidTWTestCommandPackageCmdSet" id="TWToolbar" type="ToolWindowToolbar">
           <CommandFlag>DefaultDocked</CommandFlag>
           <Strings>
               <ButtonText>Test Toolbar</ButtonText>
               <CommandName>Test Toolbar</CommandName>
           </Strings>
       </Menu>
   </Menus>
   

   Araç çubukları alt menüler gibi iç içe yerleştirilemiyor. Bu nedenle, üst öğe atamanız gerekmez. Ayrıca, kullanıcı araç çubuklarını taşıyabildiği için öncelik ayarlamanız gerekmez. Genellikle, bir araç çubuğunun ilk yerleşimi program aracılığıyla tanımlanır, ancak kullanıcı tarafından yapılan sonraki değişiklikler kalıcı olur.

4. Gruplar bölümünde, araç çubuğu komutlarını içerecek bir grup tanımlayın.

   
   <Group guid="guidTWTestCommandPackageCmdSet" id="TWToolbarGroup" priority="0x0000">
       <Parent guid="guidTWTestCommandPackageCmdSet" id="TWToolbar" />
   </Group>
   

5. Düğmeler bölümünde, araç çubuğunun görüntülenmesi için mevcut Button öğesinin üst öğesini araç çubuğu grubu olarak değiştirin.

   <Button guid="guidTWTestCommandPackageCmdSet" id="TWTestCommandId" priority="0x0100" type="Button">
       <Parent guid="guidTWTestCommandPackageCmdSet" id="TWToolbarGroup" />
       <Icon guid="guidImages" id="bmpPic1" />
       <Strings>
           <ButtonText>Invoke TWTestCommand</ButtonText>
       </Strings>
   </Button>
   

   Varsayılan olarak, bir araç çubuğunun komutu yoksa görünmez.

   Yeni araç çubuğu araç penceresine otomatik olarak eklenmediği için araç çubuğunun açıkça eklenmesi gerekir. Bu konu, sonraki bölümde açıklanmaktadır.

Araç çubuğunu araç penceresine ekleme

1. TWTestCommandPackageGuids.cs aşağıdaki satırları ekleyin.

   public const string guidTWTestCommandPackageCmdSet = "00000000-0000-0000-0000-0000";  // get the GUID from the .vsct file
   public const int TWToolbar = 0x1000;
   

2. TestToolWindow.cs aşağıdaki using deyimini ekleyin.

   using System.ComponentModel.Design;
   

3. TestToolWindow oluşturucusunda aşağıdaki satırı ekleyin.

   this.ToolBar = new CommandID(new Guid(TWTestCommandPackageGuids.guidTWTestCommandPackageCmdSet), TWTestCommandPackageGuids.TWToolbar);
   

Araç penceresinde araç çubuğunu test edin

1. Projeyi derleyin ve hata ayıklamaya başlayın. Visual Studio deneysel örneği görünmelidir.

2. Görünüm / Diğer Windows menüsünde Test AracıWindow'a tıklayarak araç penceresini görüntüleyin.

   Araç penceresinin sol üst kısmında başlığın hemen altında bir araç çubuğu (varsayılan simge gibi görünür) görmeniz gerekir.

3. Araç çubuğunda, TWToolbar.TWTestCommand.MenuItemCallback() içinde TWTestCommandPackage iletisini görüntülemek için simgeye tıklayın.

İlgili içerik

• Araç çubuğu ekleme