Estrutura EXTCHKBOX (compstui.h)
A estrutura EXTCHKBOX é usada por aplicativos CPSUI (incluindo DLLs de interface da impressora) para especificar uma caixa de marcar estendida, que pode ser adicionada a uma opção de página de folha de propriedades.
Sintaxe
typedef struct _EXTCHKBOX {
WORD cbSize;
WORD Flags;
LPTSTR pTitle;
LPTSTR pSeparator;
LPTSTR pCheckedName;
ULONG_PTR IconID;
WORD wReserved[4];
ULONG_PTR dwReserved[2];
} EXTCHKBOX, *PEXTCHKBOX;
Membros
cbSize
Tamanho, em bytes, da estrutura EXTCHKBOX .
Flags
Sinalizadores de bits, que podem ser um dos seguintes:
ECBF_CHECKNAME_AT_FRONT
Se definido, CPSUI exibe cadeias de caracteres na ordem "pCheckedName pSeparator SelectName", em que SelectName é a cadeia de caracteres associada ao valor selecionado da opção.
Se não estiver definido, CPSUI exibirá cadeias de caracteres na ordem "SelectName pSeparator pCheckedName".
ECBF_CHECKNAME_ONLY_ENABLED
Se definido, CPSUI exibirá a cadeia de caracteres pCheckedName somente se a opção estiver marcada e habilitada (ou seja, OPTIF_ECB_CHECKED estiver definida e OPTIF_DISABLED estiver claro na estrutura OPTITEM ).
Se não estiver definido, CPSUI sempre exibirá a cadeia de caracteres pCheckedName se a opção estiver marcada (ou seja, OPTIF_ECB_CHECKED estiver definida na estrutura OPTITEM ), mesmo que a opção esteja desabilitada.
ECBF_ICONID_AS_HICON
Se definido, o membro IconID contém um identificador de ícone.
Se não estiver definido, o membro IconID conterá um identificador de recurso de ícone.
ECBF_OVERLAY_ECBICON_IF_CHECKED
Se definido e se a caixa marcar estiver marcada (ou seja, OPTIF_ECB_CHECKED estiver definida na estrutura OPTITEM), o CPSUI sobrepõe o ícone identificado pelo membro IconID no ícone associado ao item de opção.
ECBF_OVERLAY_NO_ICON
Se definido, o CPSUI sobrepõe seu ícone de IDI_CPSUI_NO no ícone identificado pelo membro IconID .
ECBF_OVERLAY_STOP_ICON
Se definido, o CPSUI sobrepõe o ícone IDI_CPSUI_STOP no ícone identificado pelo membro IconID .
ECBF_OVERLAY_WARNING_ICON
Se definido, o CPSUI sobrepõe seu ícone de IDI_CPSUI_WARNING no ícone identificado pelo membro IconID .
pTitle
Identificador de cadeia de caracteres, representando o título da caixa marcar. Isso pode ser um ponteiro de 32 bits para uma cadeia de caracteres terminada em NULL ou pode ser um identificador de recurso de cadeia de caracteres de 16 bits com HIWORD definido como zero.
pSeparator
Identificador de cadeia de caracteres, representando um caractere separador a ser exibido entre a cadeia de caracteres de nome marcada e a cadeia de caracteres de opção selecionada Isso pode ser um ponteiro de 32 bits para uma cadeia de caracteres terminada em NULL ou pode ser um identificador de recurso de cadeia de caracteres de 16 bits com HIWORD definido como zero.
pCheckedName
Identificador de cadeia de caracteres, representando o texto a ser exibido quando a caixa marcar é marcada. Isso pode ser um ponteiro de 32 bits para uma cadeia de caracteres terminada em NULL ou pode ser um identificador de recurso de cadeia de caracteres de 16 bits com HIWORD definido como zero.
IconID
Um dos seguintes identificadores de ícone:
Um identificador de recurso de ícone. Isso pode ser definido pelo aplicativo ou pode ser um dos identificadores de recurso de ícone fornecidos pelo CPSUI IDI_CPSUI prefixado.
Um identificador de ícone. Se um identificador for especificado, ECBF_ICONID_AS_HICON deverá ser definido no membro Flags .
Se esse valor for zero, um ícone não será exibido.
wReserved[4]
Reservado, deve ser inicializado como zero.
dwReserved[2]
Reservado, deve ser inicializado como zero.
Comentários
Uma caixa de marcar estendida é um tipo de marcar definido por CPSUI que pode ser associado a uma estrutura OPTITEM. Uma estrutura OPTITEM pode ter uma caixa de marcar estendida ou um botão de push estendido associado a ela.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | compstui.h (inclua Compstui.h) |