Estrutura EXTCHKBOX (compstui.h)

  • Artigo

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)

Confira também

EXTPUSH