OPTPARAM-Struktur (compstui.h)

Artikel
02/22/2024

Ein Array von OPTPARAM-Strukturen wird von CPSUI-Anwendungen (einschließlich Druckerschnittstellen-DLLs) verwendet, um alle Parameterwerte zu beschreiben, die einer Eigenschaftenblattoption zugeordnet sind. Die Adresse des Arrays ist in einer OPTTYPE-Struktur enthalten.

Syntax

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

Member

cbSize

Größe der OPTPARAM-Struktur in Bytes.

Flags

Optionale Bitflags, die die Eigenschaften des Parameters ändern. Die folgenden Flags können in beliebiger Kombination festgelegt werden:

OPTPF_DISABLED

Wenn festgelegt, kann der Parameter nicht vom Benutzer ausgewählt werden. Kann mit den folgenden Optionstypen verwendet werden:

OPTPF_HIDE

Wenn festgelegt, wird der Parameter nicht in der Treeview angezeigt. Kann mit den folgenden Optionstypen verwendet werden:

TVOT_3STATES

TVOT_COMBOBOX

TVOT_LISTBOX

OPTPF_ICONID_AS_HICON

Wenn festgelegt, enthält das IconID-Element ein Symbolhandle.

Falls nicht festgelegt, enthält das IconID-Element einen Symbolressourcenbezeichner.

OPTPF_OVERLAY_NO_ICON

Falls festgelegt, überlagert CPSUI sein IDI_CPSUI_NO-Symbol mit dem symbol, das durch das IconID-Element identifiziert wird.

OPTPF_OVERLAY_STOP_ICON

Falls festgelegt, überlagert CPSUI das IDI_CPSUI_STOP-Symbol auf das symbol, das durch das IconID-Element identifiziert wird.

OPTPF_OVERLAY_WARNING_ICON

Falls festgelegt, überlagert CPSUI sein IDI_CPSUI_WARNING-Symbol mit dem symbol, das durch das IconID-Element identifiziert wird.

OPTPF_USE_HDLGTEMPLATE

Wenn festgelegt, enthält lParam ein Vorlagenhandle.

Wenn nicht festgelegt, enthält lParam einen Vorlagenressourcenbezeichner.

(Wird nur verwendet, wenn Style PUSHBUTTON_TYPE_DLGPROC ist.)

Style

Drucktastenstil, der nur für den TVOT_PUSHBUTTON Optionstyp verwendet wird.

pData

Zeiger auf den Wert des Parameters. Die Verwendung dieses Members hängt vom CPSUI-Optionstyp ab.

IconID

Gibt in der Regel das Symbol an, das dem Optionsparameter zugeordnet werden soll, wird aber manchmal für andere Zwecke verwendet. Die Verwendung dieses Members hängt vom CPSUI-Optionstyp ab.

lParam

Die Verwendung dieses Members hängt vom CPSUI-Optionstyp ab.

dwReserved[2]

Reserviert, muss mit 0 initialisiert werden.

Hinweise

Wenn das OPTPF_HIDE-Flag in allen OPTPARAM-Strukturen festgelegt ist, die einer Option zugeordnet sind, blendet CPSUI die gesamte Option aus.

Anforderungen

Anforderung	Wert
Header	compstui.h (einschließlich Compstui.h)

Freigeben über