Condividi tramite

Aggiungere icone ai comandi di menu

  • Articolo

I comandi possono essere visualizzati sia nei menu che nelle barre degli strumenti. Nelle barre degli strumenti è comune che un comando venga visualizzato con solo un'icona (per risparmiare spazio) mentre nei menu viene in genere visualizzato un comando con un'icona e un testo.

Le icone hanno una larghezza di 16 pixel di 16 pixel e possono essere una profondità di colore a 8 bit (256 colori) o una profondità di colore a 32 bit (colore reale). Le icone dei colori a 32 bit sono preferite. Le icone vengono in genere disposte in una singola riga orizzontale in una singola bitmap, anche se sono consentite più bitmap. Questa bitmap viene dichiarata nel file vsct insieme alle singole icone disponibili nella bitmap. Per altri dettagli, vedere le informazioni di riferimento per l'elemento Bitmaps.

Aggiungere un'icona a un comando

La procedura seguente presuppone che sia presente un progetto VSPackage esistente con un comando di menu. Per informazioni su come eseguire questa operazione, vedere Creare un'estensione con un comando di menu.

  1. Creare una bitmap con una profondità di colore di 32 bit. Un'icona è sempre 16 x 16, quindi questa bitmap deve essere alta 16 pixel e un multiplo di 16 pixel di larghezza.

    Ogni icona viene posizionata sulla bitmap accanto all'altra in una singola riga. Usare il canale alfa per indicare posizioni di trasparenza in ogni icona.

    Se si usa una profondità di colore a 8 bit, usare magenta, RGB(255,0,255), come trasparenza. Tuttavia, le icone dei colori a 32 bit sono preferite.

  2. Copiare il file icona nella directory Risorse nel progetto VSPackage. Nella Esplora soluzioni aggiungere l'icona al progetto. (Selezionare Risorse e nel menu di scelta rapida fare clic su Aggiungi, quindi su Elemento esistente e selezionare il file icona.

  3. Aprire il file vsct nell'editor.

  4. Aggiungere un GuidSymbol elemento con un nome testIcon. Creare un GUID (Strumenti>Crea GUID, quindi selezionare Formato registro e fare clic su Copia) e incollarlo nell'attributo .value Il risultato deve avere un aspetto simile al seguente:

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

  5. Aggiungere un oggetto <IDSymbol> per l'icona. L'attributo name è l'ID dell'icona e indica la value sua posizione sulla striscia, se presente. Se è presente una sola icona, aggiungere 1. Il risultato deve avere un aspetto simile al seguente:

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

  6. Creare un oggetto <Bitmap> nella <Bitmaps> sezione all'interno <Commands> della sezione del file vsct per rappresentare la bitmap contenente le icone.

    • Impostare il guid valore sul nome dell'elemento <GuidSymbol> creato nel passaggio precedente.

    • Impostare il href valore sul percorso relativo del file bitmap (in questo caso Resources\<icon file name>.

    • Impostare il usedList valore su IDSymbol creato in precedenza. Questo attributo specifica un elenco delimitato da virgole delle icone da usare nel pacchetto VSPackage. Le icone non presenti nell'elenco sono escluse dalla compilazione dei moduli.

      Il blocco Bitmap dovrebbe essere simile al seguente:

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

  7. Nell'elemento esistente <Button> impostare l'elemento Icon sui valori GUIDSymbol e IDSymbol creati in precedenza. Ecco un esempio di elemento Button con questi valori:

    <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. Testare l'icona. Compilare il progetto e avviare il debug. Nell'istanza sperimentale trovare il comando . Dovrebbe visualizzare l'icona aggiunta.

Contenuto correlato