Bagikan melalui

Menambahkan ikon ke perintah menu

  • Artikel

Perintah dapat muncul pada menu dan bilah alat. Pada toolbar, perintah umum ditampilkan hanya dengan ikon (untuk menghemat ruang) saat menu perintah biasanya muncul dengan ikon dan teks.

Ikon memiliki lebar 16 piksel dengan tinggi 16 piksel dan dapat berupa kedalaman warna 8-bit (256 warna) atau kedalaman warna 32-bit (warna benar). Ikon warna 32-bit lebih disukai. Ikon biasanya disusun dalam satu baris horizontal dalam satu bitmap, meskipun beberapa bitmap diizinkan. Bitmap ini dideklarasikan dalam file .vsct bersama dengan ikon individual yang tersedia di bitmap. Lihat referensi untuk elemen Bitmaps untuk detail selengkapnya.

Menambahkan ikon ke perintah

Prosedur berikut mengasumsikan bahwa Anda memiliki proyek VSPackage yang ada dengan perintah menu. Untuk mengetahui cara melakukannya, lihat Membuat ekstensi dengan perintah menu.

  1. Buat bitmap dengan kedalaman warna 32-bit. Ikon selalu 16 x 16 sehingga bitmap ini harus tinggi 16 piksel dan kelipatan lebar 16 piksel.

    Setiap ikon ditempatkan pada bitmap di samping satu sama lain dalam satu baris. Gunakan saluran alfa untuk menunjukkan tempat transparansi di setiap ikon.

    Jika Anda menggunakan kedalaman warna 8-bit, gunakan magenta, RGB(255,0,255), sebagai transparansi. Namun, ikon warna 32-bit lebih disukai.

  2. Salin file ikon ke direktori Sumber Daya di proyek VSPackage Anda. Di Penjelajah Solusi, tambahkan ikon ke proyek. (Pilih Sumber daya, dan pada menu konteks klik Tambahkan, lalu Item yang Ada, dan pilih file ikon Anda.)

  3. Buka file .vsct di editor.

  4. GuidSymbol Tambahkan elemen dengan nama testIcon. Buat GUID (Alat>Buat GUID, lalu pilih Format Registri dan klik Salin) dan tempelkan ke value atribut . Hasilnya akan terlihat seperti ini:

    <!-- Create your own GUID -->
<GuidSymbol name="testIcon" value="{00000000-0000-0000-0000-0000}">

  5. <IDSymbol> Tambahkan untuk ikon . Atribut name adalah ID ikon, dan value menunjukkan posisinya pada strip, jika ada. Jika hanya ada satu ikon, tambahkan 1. Hasilnya akan terlihat seperti ini:

    <!-- Create your own GUID -->
<GuidSymbol name="testIcon" value="{00000000-0000-0000-0000-0000}">
    <IDSymbol name="testIcon1" value="1" />
</GuidSymbol>

  6. <Bitmap> Buat di bagian <Bitmaps> dalam <Commands> bagian file .vsct untuk mewakili bitmap yang berisi ikon.

    • Atur guid nilai ke nama elemen yang <GuidSymbol> Anda buat di langkah sebelumnya.

    • Atur href nilai ke jalur relatif file bitmap (dalam hal ini Sumber Daya\<nama> file ikon.

    • Atur usedList nilai ke IDSymbol yang Anda buat sebelumnya. Atribut ini menentukan daftar ikon yang dibatasi koma yang akan digunakan dalam VSPackage. Ikon yang tidak ada dalam daftar dikecualikan kompilasi formulir.

      Blok Bitmap akan terlihat seperti ini:

      <Bitmap guid="testIcon" href="Resources\<icon file name>" usedList="testIcon1"/>

  7. Dalam elemen yang ada <Button> , atur Icon elemen ke nilai GUIDSymbol dan IDSymbol yang Anda buat sebelumnya. Berikut adalah contoh elemen Tombol dengan nilai-nilai tersebut:

    <Button guid="guidAddIconCmdSet" id="cmdidMyCommand" priority="0x0100" type="Button">
    <Parent guid="guidAddIconCmdSet" id="MyMenuGroup" />
    <Icon guid="testIcon" id="testIcon1" />
    <Strings>
        <ButtonText>My Command name</ButtonText>
    </Strings>
</Button>

  8. Uji ikon Anda. Bangun proyek dan mulai penelusuran kesalahan. Dalam instans eksperimental, temukan perintah . Ini akan menampilkan ikon yang Anda tambahkan.

Konten terkait