Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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
Um identificador para o controle de botão.
Valor de retorno
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 |