Compartilhar via


CButton::SetSplitStyle

Defina o estilo de controle de botão split atual.

BOOL SetSplitStyle(
     UINT uSplitStyle
);

Parâmetros

Parâmetro

Descrição

[in] uSplitStyle

Um combinação bit a bit de estilo de botão split. Para obter mais informações, consulte o membro de uSplitStyle estrutura de BUTTON_SPLITINFO .

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.

Os estilos de botão split especificam o alinhamento, o extensor, e o formato gráfico com que o desenha um ícone de botão split. Para obter mais informações, consulte o membro de uSplitStyle estrutura de BUTTON_SPLITINFO .

Este método inicializa o membro de mask de uma estrutura de BUTTON_SPLITINFO com o sinalizador de BCSIF_STYLE e o membro de uSplitStyle com o parâmetro de uSplitStyle e em seguida, envia que estrutura na mensagem de BCM_GETSPLITINFO 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 Requisitos de compilação para 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 a seguir define o estilo da seta suspensa de botão split. O estilo de BCSS_ALIGNLEFT exibe a seta no lado esquerdo do botão, e estilo de BCSS_STRETCH retém as proporções de seta suspensa quando você redimensiona o botão.

 /* 
    Set the style of the split button drop-down arrow: Display the 
    arrow on the left and retain the arrow's proportions when resizing 
    the control.
    */
    bRC = m_splitButton.SetSplitStyle( BCSS_ALIGNLEFT | BCSS_STRETCH );

Consulte também

Referência

Classe CButton

Gráfico da hierarquia

CButton::GetSplitStyle

CButton::GetSplitInfo

BCM_SETSPLITINFO