winuser.h
CheckDlgButton
La función CheckDlgButton cambia el estado de activación (check state) de un control button.
Sintaxis
BOOL CheckDlgButton(
HWND hDlg, // manipulador del cuadro de diálogo
int nIDButton, // identificador del contol button
UINT uCheck // estado de activación (check state)
);
Parámetros:
hDlg: identifica el cuadro de diálogo que contiene el control botón.
nIDButton: identifica el botón a modificar.
uCheck: especifica el estado de activación del botón. Este parámetro puede tomar uno de los siguientes valores:
| Valor | Significado |
|---|---|
| BST_CHECKED | Cambia el estado del botón a marcado. |
| BST_INDETERMINATE | Cambia el estado del botón a gris, indica un estado indeterminado. Usar este valor sólo su el botón tiene el estilo BS_3STATE o BS_AUTO3STATE. |
| BST_UNCHECKED | Cambia el estado del botón a no marcado. |
Valor de retorno
Si la función tiene éxito, el valor de retorno es distinto de cero.
Si falla, el valor de retorno es cero. Para conseguir más información, se puede llamar a GetLastError.
Observaciones
La función CheckDlgButton envía un mensaje BM_SETCHECK al control botón especificado del cuadro de diálogo indicado.