Compartilhar via

Estrutura OPTPARAM (compstui.h)

  • Artigo

Uma matriz de estruturas OPTPARAM é usada por aplicativos CPSUI (incluindo DLLs de interface de impressora) para descrever todos os valores de parâmetro associados a uma opção de folha de propriedades. O endereço da matriz está incluído em uma estrutura OPTTYPE .

Sintaxe

typedef struct _OPTPARAM {
  WORD      cbSize;
  BYTE      Flags;
  BYTE      Style;
  LPTSTR    pData;
  ULONG_PTR IconID;
  LPARAM    lParam;
  ULONG_PTR dwReserved[2];
} OPTPARAM, *POPTPARAM;

Membros

cbSize

Tamanho, em bytes, da estrutura OPTPARAM .

Flags

Sinalizadores de bit opcionais que modificam as características do parâmetro. Os seguintes sinalizadores podem ser definidos em qualquer combinação:

OPTPF_DISABLED

Se definido, o parâmetro não será selecionável pelo usuário. Pode ser usado com os seguintes tipos de opção:

TVOT_2STATES

TVOT_3STATES

TVOT_COMBOBOX

TVOT_LISTBOX

OPTPF_HIDE

Se definido, o parâmetro não será exibido no modo de exibição de árvore. Pode ser usado com os seguintes tipos de opção:

TVOT_3STATES

TVOT_COMBOBOX

TVOT_LISTBOX

OPTPF_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.

OPTPF_OVERLAY_NO_ICON

Se definido, o CPSUI sobrepõe seu ícone de IDI_CPSUI_NO no ícone identificado pelo membro IconID .

OPTPF_OVERLAY_STOP_ICON

Se definido, o CPSUI sobrepõe o ícone IDI_CPSUI_STOP no ícone identificado pelo membro IconID .

OPTPF_OVERLAY_WARNING_ICON

Se definido, o CPSUI sobrepõe seu ícone de IDI_CPSUI_WARNING no ícone identificado pelo membro IconID .

OPTPF_USE_HDLGTEMPLATE

Se definido, lParam conterá um identificador de modelo.

Se não estiver definido, lParam conterá um identificador de recurso de modelo.

(Usado somente se Style for PUSHBUTTON_TYPE_DLGPROC.)

Style

Estilo de botão de push, usado apenas para o tipo de opção TVOT_PUSHBUTTON .

pData

Ponteiro para o valor do parâmetro. O uso desse membro depende do tipo de opção CPSUI.

IconID

Geralmente identifica o ícone a ser associado ao parâmetro de opção, mas às vezes é usado para outras finalidades. O uso desse membro depende do tipo de opção CPSUI.

lParam

O uso desse membro depende do tipo de opção CPSUI.

dwReserved[2]

Reservado, deve ser inicializado como zero.

Comentários

Se o sinalizador OPTPF_HIDE estiver definido em todas as estruturas OPTPARAM associadas a uma opção, CPSUI ocultará toda a opção.

Requisitos

Requisito Valor
Cabeçalho compstui.h (inclua Compstui.h)