estrutura BUTTON_SPLITINFO (commctrl.h)

Artigo
03/05/2025

Contém informações que definem um botão de divisão (estilosBS_SPLITBUTTON e 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	tamanho é 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:TAMANHO do

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

Observações

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 ativas e pressionadas.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
cabeçalho	commctrl.h

Consulte também

Visão geral dos botões de

Compartilhar via