STRUCTURE OPTPARAM (compstui.h)

Article
02/06/2025

Un tableau de structures OPTPARAM est utilisé par les applications CPSUI (y compris les DLL d’interface d’imprimante) pour décrire toutes les valeurs de paramètre associées à une option de feuille de propriétés . L’adresse du tableau est incluse dans une structure OPTTYPE.

Syntaxe

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

Membres

cbSize

Taille, en octets, de la structure OPTPARAM.

Flags

Indicateurs de bits facultatifs qui modifient les caractéristiques du paramètre. Les indicateurs suivants peuvent être définis dans n’importe quelle combinaison :

OPTPF_DISABLED

Si cette option est définie, le paramètre n’est pas sélectionnable par l’utilisateur. Peut être utilisé avec les types d’options suivants :

OPTPF_HIDE

Si la valeur est définie, le paramètre n’est pas affiché dans l’arborescence. Peut être utilisé avec les types d’options suivants :

TVOT_3STATES

TVOT_COMBOBOX

TVOT_LISTBOX

OPTPF_ICONID_AS_HICON

Si la valeur est définie, le IconID membre contient un handle d’icône.

Si ce n’est pas le cas, le IconID membre contient un identificateur de ressource d’icône.

OPTPF_OVERLAY_NO_ICON

Si elle est définie, CPSUI superpose son icône de IDI_CPSUI_NO sur l’icône identifiée par le IconID membre.

OPTPF_OVERLAY_STOP_ICON

Si cette option est définie, CPSUI superpose l’icône de IDI_CPSUI_STOP sur l’icône identifiée par le IconID membre.

OPTPF_OVERLAY_WARNING_ICON

Si cette option est définie, CPSUI superpose son icône de IDI_CPSUI_WARNING sur l’icône identifiée par le IconID membre.

OPTPF_USE_HDLGTEMPLATE

Si elle est définie, lParam contient un handle de modèle.

S’il n’est pas défini, lParam contient un identificateur de ressource de modèle.

(Utilisé uniquement si style est PUSHBUTTON_TYPE_DLGPROC.)

Style

Style de bouton Push, utilisé uniquement pour le type d’option TVOT_PUSHBUTTON.

pData

Pointeur vers la valeur du paramètre. L’utilisation de ce membre dépend du type d’option CPSUI.

IconID

Identifie généralement l’icône à associer au paramètre d’option, mais est parfois utilisée à d’autres fins. L’utilisation de ce membre dépend du type d’option CPSUI.

lParam

L’utilisation de ce membre dépend du type d’option CPSUI.

dwReserved[2]

Réservé, doit être initialisé à zéro.

Remarques

Si l’indicateur OPTPF_HIDE est défini dans toutes les structures OPTPARAM associées à une option, CPSUI masque l’option entière.

Exigences

Exigence	Valeur
d’en-tête	compstui.h (include Compstui.h)

Partager via