Menü komutlarına simge ekleme

Komutlar hem menülerde hem de araç çubuklarında görüntülenebilir. Araç çubuklarında, bir komutun yalnızca bir simgeyle görüntülenmesi (alandan tasarruf etmek için) ve menülerde bir komutun genellikle hem simge hem de metinle birlikte görüntülenmesi yaygın bir durumdur.

Simgeler 16 piksel genişliğinde ve 16 piksel yüksekliğindedir ve 8 bit renk derinliği (256 renk) veya 32 bit renk derinliği (gerçek renk) olabilir. 32 bit renk simgeleri tercih edilir. Birden çok bit eşlem kullanılmasına izin verilse de simgeler genellikle tek bir bit eşlem içinde tek bir yatay satırda düzenlenir. Bu bit eşlem, bit eşlem içinde kullanılabilen tek tek simgelerle birlikte .vsct dosyasında bildirilir. Daha fazla ayrıntı için Bitmaps öğesinin başvurusuna bakın.

Komuta simge ekleme

Aşağıdaki yordamda, menü komutuyla var olan bir VSPackage projeniz olduğu varsayılır. Bunun nasıl yapılacağını öğrenmek için bkz . Menü komutuyla uzantı oluşturma.

  1. Renk derinliği 32 bit olan bir bit eşlem oluşturun. Simge her zaman 16 x 16 olduğundan bu bit eşlem 16 piksel yüksekliğinde ve 16 piksel genişliğinde bir kat olmalıdır.

    Her simge, tek bir satırda yan yana bit eşlem üzerine yerleştirilir. Her simgedeki saydamlık yerlerini belirtmek için alfa kanalını kullanın.

    8 bit renk derinliği kullanıyorsanız saydamlık olarak eflatun , RGB(255,0,255)kullanın. Ancak 32 bit renk simgeleri tercih edilir.

  2. Simge dosyasını VSPackage projenizdeki Kaynaklar dizinine kopyalayın. Çözüm Gezgini simgeyi projeye ekleyin. (Seç Kaynaklar'a tıklayın ve bağlam menüsünde Ekle'ye ve ardından Mevcut Öğe'ye tıklayın ve simge dosyanızı seçin.)

  3. Düzenleyicide .vsct dosyasını açın.

  4. GuidSymbol testIcon adlı bir öğe ekleyin. BIR GUID oluşturun (Araçlar>GUID Oluşturun, ardından Kayıt Defteri Biçimi'ni seçin ve Kopyala'ya tıklayın) ve özniteliğine yapıştırın.value Sonuç şu şekilde görünmelidir:

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

  5. Simge için bir <IDSymbol> ekleyin. name özniteliği simgenin kimliğidir ve value varsa şerit üzerindeki konumunu gösterir. Yalnızca bir simge varsa 1 ekleyin. Sonuç şu şekilde görünmelidir:

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

  6. Simgeleri içeren <Commands> <Bitmaps> bit eşlemi temsil etmek için .vsct dosyasının bölümündeki bölümünde bir <Bitmap> oluşturun.

    • Değeri, guid önceki adımda oluşturduğunuz öğenin adına <GuidSymbol> ayarlayın.

    • href Değeri bit eşlem dosyasının göreli yoluna (bu örnekte Kaynaklar\<simge dosya adı>) ayarlayın.

    • usedList Değeri daha önce oluşturduğunuz IDSymbol olarak ayarlayın. Bu öznitelik, VSPackage'da kullanılacak simgelerin virgülle ayrılmış listesini belirtir. Listede olmayan simgeler, form derlemesi hariç tutulur.

      Bit Eşlem bloğu şöyle görünmelidir:

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

  7. Mevcut <Button> öğede, öğesini daha önce oluşturduğunuz GUIDSymbol ve IDSymbol değerlerine ayarlayın Icon . Aşağıda bu değerlere sahip bir Button öğesi örneği verilmiştir:

    <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. Simgenizi test edin. Projeyi derleyin ve hata ayıklamaya başlayın. Deneysel örnekte komutunu bulun. Eklediğiniz simgeyi göstermelidir.

İlgili içerik

  • Last updated on