OPTPARAM-Struktur (compstui.h)

Artikel
02/06/2025

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;

Angehörige

cbSize

Größe der OPTPARAM- Struktur in Bytes.

Flags

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

OPTPF_DISABLED

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

OPTPF_HIDE

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

TVOT_3STATES

TVOT_COMBOBOX

TVOT_LISTBOX

OPTPF_ICONID_AS_HICON

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

Wenn nicht festgelegt, enthält das IconID- Mitglied einen Symbolressourcenbezeichner.

OPTPF_OVERLAY_NO_ICON

Wenn festgelegt, überlagert CPSUI das IDI_CPSUI_NO Symbol auf das Symbol, das durch das IconID Mitglied identifiziert wird.

OPTPF_OVERLAY_STOP_ICON

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

OPTPF_OVERLAY_WARNING_ICON

Wenn festgelegt, überlagert CPSUI das IDI_CPSUI_WARNING-Symbol auf das symbol, das durch das IconID Mitglied identifiziert wird.

OPTPF_USE_HDLGTEMPLATE

Wenn festgelegt, enthält lParam- ein Vorlagenhandle.

Wenn nicht festgelegt, enthält lParam- einen Vorlagenressourcenbezeichner.

(Wird nur verwendet, wenn Formatvorlagen- PUSHBUTTON_TYPE_DLGPROC ist.)

Style

Die Formatvorlage für Knopfdruck wird nur für den Optionstyp TVOT_PUSHBUTTON verwendet.

pData

Zeiger auf den Wert des Parameters. Die Verwendung dieses Elements hängt vom CPSUI-Optionstypab.

IconID

Identifiziert in der Regel das Symbol, das dem Optionsparameter zugeordnet werden soll, wird jedoch manchmal für andere Zwecke verwendet. Die Verwendung dieses Elements hängt vom CPSUI-Optionstypab.

lParam

Die Verwendung dieses Elements hängt vom CPSUI-Optionstypab.

dwReserved[2]

Reserviert, muss auf Null initialisiert werden.

Bemerkungen

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 (include Compstui.h)

Freigeben über