Compartilhar via


Button_GetCheck macro (windowsx.h)

Obtém o estado de seleção de um botão de opção ou caixa de seleção. Você pode usar essa macro ou enviar a mensagem BM_GETCHECK explicitamente.

Sintaxe

LRESULT Button_GetCheck(
   HWND hwndCtl
);

Parâmetros

hwndCtl

Tipo: HWND

Um identificador para o controle de botão.

Valor de retorno

Tipo: LRESULT

O valor retornado de um botão criado com o estilo BS_AUTOCHECKBOX, BS_AUTORADIOBUTTON, BS_AUTO3STATE, BS_CHECKBOX, BS_RADIOBUTTONou BS_3STATE pode ser um dos seguintes:

Código de retorno Descrição
BST_CHECKED O botão está marcado.
BST_INDETERMINATE O botão está esmaecido, indicando um estado indeterminado (aplica-se somente se o botão tiver o estilo BS_3STATE ou BS_AUTO3STATE).
BST_UNCHECKED O botão está limpo.

Observações

Se o botão tiver um estilo diferente daqueles listados, o valor retornado será zero.

Requisitos

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