Estrutura EXTCHKBOX (compstui.h)
A estrutura EXTCHKBOX é usada por aplicativos CPSUI (incluindo DLLs de interface da impressora) para especificar uma caixa de seleção 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, o CPSUI exibirá 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, o CPSUI exibirá cadeias de caracteres na ordem "SelectName pSeparator pCheckedName".
ECBF_CHECKNAME_ONLY_ENABLED
Se definido, o 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 clara na estrutura OPTITEM).
Se não estiver definido, o CPSUI sempre exibirá a cadeia de caracteres pCheckedName se a opção estiver marcada (ou seja, OPTIF_ECB_CHECKED será 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 contém um identificador de recurso de ícone.
ECBF_OVERLAY_ECBICON_IF_CHECKED
Se definido e se a caixa de seleção estiver marcada (ou seja, OPTIF_ECB_CHECKED estiver definida na estrutura OPTITEM), o CPSUI sobrepõe o ícone identificado pelo membro IconID do 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 do.
ECBF_OVERLAY_STOP_ICON
Se definido, o CPSUI sobrepõe o ícone IDI_CPSUI_STOP no ícone identificado pelo membro iconID do.
ECBF_OVERLAY_WARNING_ICON
Se definido, o CPSUI sobrepõe seu ícone de IDI_CPSUI_WARNING no ícone identificado pelo membro iconID do.
pTitle
Identificador de cadeia de caracteres, representando o título da caixa de seleção. 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, 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 de seleção é 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 por CPSUI, com prefixo IDI_CPSUI.
Um identificador de ícone. Se um identificador for especificado, ECBF_ICONID_AS_HICON deverá ser definido no membro sinalizadores.
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.
Observações
Uma caixa de seleção estendida é um tipo de caixa de seleção definida por CPSUI que pode ser associada a uma estrutura OPTITEM. Uma estrutura OPTITEM pode ter uma caixa de seleção estendida ou um botão de push estendido associado a ela.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | compstui.h (inclua Compstui.h) |