CButton::SetSplitInfo
Especifica os parâmetros que determinam como o desenha o controle de botão split atual.
BOOL SetSplitInfo(
PBUTTON_SPLITINFO pInfo
);
Parâmetros
Parâmetro |
Descrição |
---|---|
[in] pInfo |
Ponteiro a estrutura de BUTTON_SPLITINFO que define o controle de botão split atual. |
Valor de retorno
true se este método é com êxito; caso contrário, false.
Comentários
Use este método somente com controles cujo estilo do botão é BS_SPLITBUTTON ou BS_DEFSPLITBUTTON.
Este método envia a mensagem de BCM_SETSPLITINFO , que é descrita em Windows SDK.
Requisitos
Cabeçalho: afxwin.h
Este método é suportado em Windows Vista e posteriormente.
Os requisitos adicionais para o método são descritos em Criar requisitos de controles comuns do Windows Vista.
Exemplo
O exemplo de código a seguir define a variável, m_splitButton, que é usada para acessar o controle por meio de botão split.
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 altera o glifo que é usado para a seta suspensa de botão split.O exemplo substitui um glifo acima- de triângulo apontando para o glifo para baixo apontando padrão de triângulo.O glifo que é exibida depende de caracteres que você especificar em himlGlyph membro de estrutura de BUTTON_SPLITINFO .O glifo apontando para baixo de triângulo é especificado por um caractere “6 " e o glifo acima- apontando de triângulo é especificado por um caractere “5 ".Para comparação, consulte o método conveniente, 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 );