estrutura BUTTON_SPLITINFO (commctrl.h)

  • Artigo

Contém informações que definem um botão de divisão (BS_SPLITBUTTON e estilos de BS_DEFSPLITBUTTON ). Usado com as mensagens BCM_GETSPLITINFO e BCM_SETSPLITINFO .

Sintaxe

typedef struct tagBUTTON_SPLITINFO {
  UINT       mask;
  HIMAGELIST himlGlyph;
  UINT       uSplitStyle;
  SIZE       size;
} BUTTON_SPLITINFO, *PBUTTON_SPLITINFO;

Membros

mask

Tipo: UINT

Um conjunto de sinalizadores que especificam quais membros dessa estrutura contêm dados a serem definidos ou quais membros estão sendo solicitados. Defina esse membro como um ou mais dos sinalizadores a seguir.

Valor Significado
BCSIF_GLYPH
 himlGlyph é válido.
BCSIF_IMAGE
 himlGlyph é válido. Use quando uSplitStyle estiver definido como BCSS_IMAGE.
BCSIF_SIZE
 size é válido.
BCSIF_STYLE
 uSplitStyle é válido.

himlGlyph

Tipo: HIMAGELIST

Um identificador para a lista de imagens. O provedor mantém a propriedade da lista de imagens e, em última análise, é responsável por sua eliminação.

uSplitStyle

Tipo: UINT

O estilo do botão de divisão. O valor deve ser um ou mais dos sinalizadores a seguir.

Valor Significado
BCSS_ALIGNLEFT
 Alinhe a imagem ou o glifo horizontalmente com a margem esquerda.
BCSS_IMAGE
 Desenhe uma imagem de ícone como o glifo.
BCSS_NOSPLIT
 Sem divisão.
BCSS_STRETCH
 Glifo elástico, mas tente manter a taxa de proporção.

size

Tipo: SIZE

Uma estrutura SIZE que especifica o tamanho do glifo em himlGlyph.

Comentários

O glifo é a imagem que aparece na parte do botão que ativa a lista suspensa. Por padrão, esse é um triângulo invertido. Várias imagens podem ser adicionadas à lista de imagens para fornecer diferentes glifos para diferentes estados do botão, como quente e pressionado.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho commctrl.h

Confira também

Visão geral dos botões