Struttura OPTPARAM (compstui.h)

Articolo
03/08/2023

Una matrice di strutture OPTPARAM viene utilizzata dalle applicazioni CPSUI (incluse le DLL dell'interfaccia della stampante) per descrivere tutti i valori dei parametri associati a un'opzione della finestra delle proprietà. L'indirizzo della matrice è incluso in una struttura OPTTYPE .

Sintassi

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

Members

cbSize

Dimensioni, in byte, della struttura OPTPARAM .

Flags

Flag di bit facoltativi che modificano le caratteristiche del parametro. I flag seguenti possono essere impostati in qualsiasi combinazione:

OPTPF_DISABLED

Se impostato, il parametro non è selezionabile dall'utente. Può essere usato con i tipi di opzione seguenti:

OPTPF_HIDE

Se impostato, il parametro non viene visualizzato nella visualizzazione albero. Può essere usato con i tipi di opzione seguenti:

TVOT_3STATES

TVOT_COMBOBOX

TVOT_LISTBOX

OPTPF_ICONID_AS_HICON

Se impostato, il membro IconID contiene un handle di icona.

Se non è impostato, il membro IconID contiene un identificatore di risorsa icona.

OPTPF_OVERLAY_NO_ICON

Se impostato, CPSUI sovrappone l'icona IDI_CPSUI_NO all'icona identificata dal membro IconID .

OPTPF_OVERLAY_STOP_ICON

Se impostato, CPSUI sovrappone l'icona IDI_CPSUI_STOP all'icona identificata dal membro IconID .

OPTPF_OVERLAY_WARNING_ICON

Se impostato, CPSUI sovrappone l'icona IDI_CPSUI_WARNING all'icona identificata dal membro IconID .

OPTPF_USE_HDLGTEMPLATE

Se impostato, lParam contiene un handle di modello.

Se non impostato, lParam contiene un identificatore di risorsa modello.

Viene usato solo se Style è PUSHBUTTON_TYPE_DLGPROC.

Style

Stile pulsante premuto, utilizzato solo per il tipo di opzione TVOT_PUSHBUTTON .

pData

Puntatore al valore del parametro. L'uso di questo membro dipende dal tipo di opzione CPSUI.

IconID

In genere identifica l'icona da associare al parametro di opzione, ma talvolta viene usata per altri scopi. L'uso di questo membro dipende dal tipo di opzione CPSUI.

lParam

L'uso di questo membro dipende dal tipo di opzione CPSUI.

dwReserved[2]

Riservato, deve essere inizializzato su zero.

Commenti

Se il flag OPTPF_HIDE è impostato in tutte le strutture OPTPARAM associate a un'opzione, CPSUI nasconde l'intera opzione.

Requisiti

Requisito	Valore
Intestazione	compstui.h (include Compstui.h)