Bagikan melalui


Menambahkan menu ke bilah menu Visual Studio

Panduan ini menunjukkan cara menambahkan menu ke bilah menu lingkungan pengembangan terintegrasi (IDE) Visual Studio. Bilah menu IDE berisi kategori menu seperti File, Edit, Tampilan, Jendela, dan Bantuan.

Sebelum menambahkan menu baru ke bilah menu Visual Studio, pertimbangkan apakah perintah Anda harus ditempatkan dalam menu yang sudah ada. Untuk informasi selengkapnya tentang penempatan perintah, lihat Menu dan perintah untuk Visual Studio.

Menu dideklarasikan dalam file .vsct proyek. Untuk informasi selengkapnya tentang menu dan file .vsct , lihat Perintah, menu, dan toolbar.

Dengan menyelesaikan panduan ini, Anda dapat membuat menu bernama Menu Uji yang berisi satu perintah.

Catatan

Mulai Visual Studio 2019, menu tingkat atas yang disumbangkan oleh ekstensi ditempatkan di bawah menu Ekstensi .

Membuat proyek VSIX yang memiliki templat item perintah kustom

  1. Buat proyek VSIX bernama TopLevelMenu. Anda dapat menemukan templat proyek VSIX dalam dialog Proyek Baru dengan mencari "vsix". Untuk informasi selengkapnya, lihat Membuat ekstensi dengan perintah menu.

  2. Saat proyek terbuka, tambahkan templat item perintah kustom bernama TestCommand. Di Penjelajah Solusi, klik kanan simpul proyek dan pilih Tambahkan>Item Baru. Dalam dialog Tambahkan Item Baru, buka Visual C# / Ekstensibilitas dan pilih Perintah. Di bidang Nama di bagian bawah jendela, ubah nama file perintah menjadi TestCommand.cs.

Membuat menu pada bilah menu IDE

  1. Di Penjelajah Solusi, buka TopLevelMenuPackage.vsct.

    Di akhir file, ada simpul <Symbols> yang berisi beberapa <GuidSymbol> simpul. Di simpul bernama guidTopLevelMenuPackageCmdSet, tambahkan simbol baru, sebagai berikut:

    <IDSymbol name="TopLevelMenu" value="0x1021"/>
    
  2. Buat simpul kosong <Menus> di simpul <Commands> , tepat sebelum <Groups>. Di simpul <Menus> , tambahkan simpul <Menu> , sebagai berikut:

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

    Nilai guid dan id menu tentukan set perintah dan menu tertentu dalam set perintah.

    Nilai guid dan id posisi induk menu di bagian bilah menu Visual Studio yang berisi menu Alat dan Add-in.

    Elemen <ButtonText> menentukan bahwa teks akan muncul di item menu.

  3. Di bagian <Groups> , temukan <Group> dan ubah <Parent> elemen untuk menunjuk ke menu yang baru saja kami tambahkan:

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

    Ini membuat grup menjadi bagian dari menu baru.

  4. Di bagian , <Buttons> temukan simpul <Button> . Kemudian, di simpul <Strings> , ubah elemen menjadi <ButtonText> Test Command.

    Perhatikan bahwa templat Paket Visual Studio telah menghasilkan Button elemen yang telah diatur induknya ke MyMenuGroup. Akibatnya, perintah ini muncul di menu Anda.

Membangun dan menguji ekstensi

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

  2. Menu Ekstensi dalam instans eksperimental harus berisi menu Menu Uji.

  3. Pada menu Menu Uji, pilih Perintah Uji.

    Kotak pesan akan muncul dan menampilkan pesan "TestCommand Inside TopLevelMenu.TestCommand.MenuItemCallback()".