Compartilhar via


Button_GetState macro (windowsx.h)

Recupera o estado de um botão ou caixa de seleção. Você pode usar essa macro ou enviar a mensagem BM_GETSTATE explicitamente.

Sintaxe

LRESULT Button_GetState(
   HWND hwndCtl
);

Parâmetros

hwndCtl

Tipo: HWND

Um identificador para o controle de botão.

Valor de retorno

Tipo: LRESULT

O valor retornado especifica o estado atual do botão. É uma combinação dos seguintes valores:

Código de retorno Descrição
BST_CHECKED O botão está marcado.
BST_DROPDOWNPUSHED Windows Vista. O botão está no estado suspenso. Aplica-se somente se o botão tiver o estilo TBSTYLE_DROPDOWN.
BST_FOCUS O botão tem o foco do teclado.
BST_HOT O botão está quente; ou seja, o mouse está passando o mouse sobre ele.
BST_INDETERMINATE O estado do botão é indeterminado. Aplica-se somente se o botão tiver o estilo BS_3STATE ou BS_AUTO3STATE.
BST_PUSHED O botão está sendo mostrado no estado pressionado.
BST_UNCHECKED Nenhum estado especial. Equivalente a 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

Consulte também

Button_GetCheck

Button_SetState

de referência de