Como: adicionar ícones para comandos nas barras de ferramentas
Comandos podem aparecer em menus e barras de ferramentas. Nas barras de ferramentas, é comum para um comando seja exibido com apenas um ícone (para economizar espaço) ao mesmo tempo nos menus em que um comando normalmente aparece com um ícone e o texto.
Ícones têm 16 pixels de largura por 16 pixels de altura e podem ser uma profundidade de cores de 8 bits (256 cores) ou a profundidade de cores de 32 bits (true color). ícones de cores de 32 bits são preferidos. Ícones geralmente são organizados em uma única linha horizontal em um único bitmap, embora vários bitmaps são permitidos. Esse bitmap é declarado no arquivo .vsct juntamente com os ícones individuais disponíveis no bitmap. Consulte a referência para o Elemento de bitmaps para obter mais detalhes.
Adicionar um ícone para um comando
Para adicionar um ícone para um comando
Crie um bitmap com uma profundidade de cores de 32 bits. Um ícone é sempre um múltiplo de 16 pixels de largura e de 16 x 16 para que este bitmap deve ser 16 pixels de altura.
Cada ícone é colocado no bitmap lado a lado em uma única linha. Use o canal alfa para indicar os locais de transparência em cada ícone.
Se você usar uma profundidade de cores de 8 bits, use o magenta, RGB(255,0,255), como a transparência. No entanto, os ícones de cores de 32 bits são preferidos.
Abra o arquivo de .vsct no editor.
No Elemento de símbolos, encontrar o Elemento de GuidSymbol que contém as entradas existentes do bitmap. Por padrão, ele é denominado guidImages.
O exemplo a seguir mostra o padrão <GuidSymbol> elemento gerado pelo modelo de pacote de Visual Studio.
<GuidSymbol name="guidImages" value="{7f2b0178-a581-424f-933f-f6da41774269}"> <IDSymbol name="bmpPic1" value="1" /> <IDSymbol name="bmpPic2" value="2" /> <IDSymbol name="bmpPicSearch" value="3" /> <IDSymbol name="bmpPicX" value="4" /> <IDSymbol name="bmpPicArrows" value="5" /> </GuidSymbol>Adicionar um Elemento de IDSymbol para cada ícone em seu bitmap. O name atributo é a identificação do ícone e o value indica sua posição em strip.
Criar um Elemento de bitmap na <Bitmaps> seção do arquivo .vsct para representar o bitmap que contém os ícones.
Definir o guid valor com o nome do <GuidSymbol> o elemento que contém suas declarações de bitmap.
Definir o href de atributo para o caminho relativo do arquivo de bitmap, ou definir a resID de atributo para um recurso de número inteiro, definido em outros lugares no pacote, que se refere a bitmaps desejado.
Você pode melhorar o desempenho, definindo a usedList de atributo a uma lista delimitada por vírgulas dos ícones para ser usado no VSPackage. Ícones não consta na que lista serão excluídos de compilação do formulário. Você deve especificar um usedList se usando um resID em vez de um href.
O exemplo a seguir mostra a entrada padrão criada pelo modelo de pacote.
<Bitmap guid="guidImages" href="Resources\Images_32bit.bmp" usedList="bmpPic1, bmpPic2, bmpPicSearch, bmpPicX, bmpPicArrows" />Criar um Elemento button na Elemento de botões ou use uma entrada existente.
Dentro o <Button> elemento, adicionar um Elemento de ícone e defina seu guid e id a GUID:ID de um dos ícones no seu bitmap de atributos.
Se desejado, adicione um dos seguintes sinalizadores para a definição do botão como um Elemento de sinalizador de comando:
IconAndText: O ícone e o texto do botão são exibidas no menu e barra de ferramentas.
Pict: Apenas o ícone do comando é mostrado em uma barra de ferramentas, enquanto somente o texto do comando é mostrado em um menu. Se um ícone não for especificado, um espaço em branco é mostrado uma barra de ferramentas.
TextOnly: apenas o texto do comando é mostrado em um menu ou uma barra de ferramentas. O <Icon> elemento será ignorado.
Para obter mais informações sobre sinalizadores de comando, consulte <CommandFlag> Documentação do elemento.
Consulte também
Conceitos
Referência de esquema XML VSCT