Menambahkan toolbar ke jendela alat

Panduan ini menunjukkan cara menambahkan toolbar ke jendela alat.

Bilah alat adalah strip horizontal atau vertikal yang berisi tombol yang terikat ke perintah. Panjang toolbar di jendela alat selalu sama dengan lebar atau tinggi jendela alat, tergantung di mana toolbar ditampung.

Tidak seperti bilah alat di IDE, bilah alat di jendela alat harus ditampung dan tidak dapat dipindahkan atau disesuaikan. Jika VSPackage ditulis dalam kode yang tidak dikelola, toolbar dapat ditampar di tepi mana pun.

Untuk informasi selengkapnya tentang cara menambahkan toolbar, lihat Menambahkan toolbar.

Membuat toolbar untuk jendela alat

1. Buat proyek VSIX bernama TWToolbar yang memiliki perintah menu bernama TWTestCommand dan jendela alat bernama TestToolWindow. Untuk informasi selengkapnya, lihat Membuat ekstensi dengan perintah menu dan Membuat ekstensi dengan jendela alat. Anda perlu menambahkan templat item perintah sebelum menambahkan templat jendela alat.

2. Di TWTestCommandPackage.vsct, cari bagian Simbol. Dalam simpul GuidSymbol bernama guidTWTestCommandPackageCmdSet mendeklarasikan toolbar dan grup toolbar, sebagai berikut.

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

3. Di bagian atas bagian Commands , buat Menus bagian . Menu Tambahkan elemen untuk menentukan toolbar.

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

   Bilah alat tidak dapat ditumpuk seperti submenu. Oleh karena itu, Anda tidak perlu menetapkan induk. Selain itu, Anda tidak perlu mengatur prioritas, karena pengguna dapat memindahkan toolbar. Biasanya, penempatan awal toolbar didefinisikan secara terprogram, tetapi perubahan berikutnya oleh pengguna dipertahankan.

4. Di bagian Grup, tentukan grup untuk berisi perintah untuk toolbar.

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

5. Di bagian Tombol, ubah induk elemen Tombol yang ada ke grup toolbar sehingga toolbar akan ditampilkan.

   <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>
   

   Secara default, jika toolbar tidak memiliki perintah, toolbar tidak muncul.

   Karena toolbar baru tidak ditambahkan secara otomatis ke jendela alat, toolbar harus ditambahkan secara eksplisit. Ini akan dibahas di bagian berikutnya.

Menambahkan toolbar ke jendela alat

1. Di TWTestCommandPackageGuids.cs tambahkan baris berikut.

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

2. Di TestToolWindow.cs tambahkan pernyataan penggunaan berikut.

   using System.ComponentModel.Design;
   

3. Di konstruktor TestToolWindow tambahkan baris berikut.

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

Menguji toolbar di jendela alat

1. Bangun proyek dan mulai penelusuran kesalahan. Instans eksperimental Visual Studio akan muncul.

2. Pada menu Lihat/Windows Lainnya, klik Uji ToolWindow untuk menampilkan jendela alat.

   Anda akan melihat toolbar (terlihat seperti ikon default) di kiri atas jendela alat, tepat di bawah judul.

3. Pada toolbar, klik ikon untuk menampilkan pesan TWTestCommandPackage Inside TWToolbar.TWTestCommand.MenuItemCallback().

Konten terkait

• Menambahkan bilah alat