Tambahkan Bilah Alat

Panduan ini menunjukkan cara menambahkan toolbar ke Visual Studio IDE.

Bilah alat adalah strip horizontal atau vertikal yang berisi tombol yang terikat ke perintah. Tergantung pada implementasinya, toolbar di IDE dapat diposisikan ulang, ditampung di sisi mana pun dari jendela IDE utama, atau dibuat untuk tetap berada di depan jendela lain.

Selain itu, pengguna dapat menambahkan perintah ke toolbar atau menghapusnya dengan menggunakan kotak dialog Kustomisasi . Biasanya, toolbar di VSPackages dapat disesuaikan pengguna. IDE menangani semua kustomisasi, dan VSPackage merespons perintah. VSPackage tidak perlu tahu di mana perintah berada secara fisik.

Untuk informasi selengkapnya tentang menu, lihat Perintah, menu, dan toolbar.

Membuat ekstensi dengan toolbar

Buat proyek VSIX bernama IDEToolbar. Tambahkan templat item perintah menu bernama ToolbarTestCommand. Untuk informasi tentang cara melakukannya, lihat Membuat ekstensi dengan perintah menu.

Membuat toolbar untuk IDE

  1. Di ToolbarTestCommandPackage.vsct, cari bagian Simbol. Dalam elemen GuidSymbol bernama guidToolbarTestCommandPackageCmdSet, tambahkan deklarasi untuk toolbar dan grup toolbar, sebagai berikut.

    <IDSymbol name="Toolbar" value="0x1000" />
    <IDSymbol name="ToolbarGroup" value="0x1050" />
    
  2. Di bagian atas bagian Perintah, buat bagian Menu. Tambahkan elemen Menu ke bagian Menu untuk menentukan toolbar Anda.

    <Menus>
        <Menu guid="guidToolbarTestCommandPackageCmdSet" id="Toolbar" type="Toolbar">
            <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 grup 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.

  3. Di bagian Grup , setelah entri grup yang ada, tentukan elemen Grup untuk berisi perintah untuk toolbar.

    <Group guid="guidToolbarTestCommandPackageCmdSet" id="ToolbarGroup" priority="0x0000">
        <Parent guid="guidToolbarTestCommandPackageCmdSet" id="Toolbar" />
    </Group>
    
  4. Buat tombol muncul pada toolbar. Di bagian Tombol, ganti blok Induk di Tombol ke toolbar. Blok Tombol yang dihasilkan akan terlihat seperti ini:

    <Button guid="guidToolbarTestCommandPackageCmdSet" id="ToolbarTestCommandId" priority="0x0100" type="Button">
        <Parent guid= "guidToolbarTestCommandPackageCmdSet" id="ToolbarGroup" />
        <Icon guid="guidImages" id="bmpPic1" />
        <Strings>
            <ButtonText>Invoke ToolbarTestCommand</ButtonText>
        </Strings>
    </Button>
    

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

  5. Bangun proyek dan mulai penelusuran kesalahan. Instans eksperimental akan muncul.

  6. Klik kanan bilah menu Visual Studio untuk mendapatkan daftar toolbar. Pilih Uji Toolbar.

  7. Sekarang Anda akan melihat toolbar Anda sebagai ikon di sebelah kanan ikon Temukan di File. Saat Mengklik ikon, Anda akan melihat kotak pesan yang bertuliskan ToolbarTestCommandPackage. Di dalam IDEToolbar.ToolbarTestCommand.MenuItemCallback().