CButton::SetSplitInfo
Especifica os parâmetros que determinam como o Windows desenha o controle de botão de divisão corrente.
BOOL SetSplitInfo(
PBUTTON_SPLITINFO pInfo
);
Parâmetros
Parâmetro |
Descrição |
|---|---|
[in] pInfo |
Ponteiro para um BUTTON_SPLITINFO estrutura que define o controle de botão de divisão corrente. |
Valor de retorno
true Se esse método for bem-sucedida; caso contrário, false.
Comentários
Use esse método somente com controles cujo estilo de botão é BS_SPLITBUTTON ou BS_DEFSPLITBUTTON.
Esse método envia o BCM_SETSPLITINFO mensagem, que é descrita no Windows SDK.
Requisitos
Cabeçalho: afxwin.h
Este método é suportado no Windows Vista e mais recente.
Requisitos adicionais para este método são descritos em compilação Requisitos para controles comuns do Windows Vista.
Exemplo
O exemplo de código a seguir define a variável, m_splitButton, que é usado para acessar programaticamente o controle de botão de divisão.
public:
// Variable to access programatically defined command link control.
CButton m_cmdLink;
// Variable to access programatically defined split button control.
CButton m_splitButton;
O exemplo de código a seguir altera o glifo é usado para na seta de lista suspensa do botão de divisão.O exemplo substitui por um glifo de triângulo apontando para cima para o glifo de triângulo apontando para baixo do padrão.O glifo exibido depende do caractere que você especificar na himlGlyph membro de BUTTON_SPLITINFO estrutura. O glifo de triângulo apontando para baixo é especificado por um caractere ' 6 'e o glifo de triângulo apontando para cima é especificado por um caractere ' 5'.Para comparação, consulte o método de conveniência, CButton::SetSplitGlyph.
/*
The drop-down arrow glyph is a function of the specified character.
The default "down" drop-down arrow glyph is specified by a
character '6'. Set the "up" arrow glyph, which is a character '5'.
See the convenience method, SetSplitGlyph(), for comparison.
*/
BUTTON_SPLITINFO bsInfo = {0};
bsInfo.mask = BCSIF_GLYPH;
TCHAR chGlyph = _T('5'); // "up" arrow glyph
bsInfo.himlGlyph = (HIMAGELIST)chGlyph;
bRC = m_splitButton.SetSplitInfo( &bsInfo );