Structure OPTTYPE (compstui.h)

Article
02/26/2024

La structure OPTTYPE est utilisée par les applications CPSUI (y compris les DLL d’interface d’imprimante) pour décrire le type et d’autres caractéristiques d’une option de feuille de propriétés, si l’option est spécifiée par une structure OPTITEM .

Syntaxe

typedef struct _OPTTYPE {
  WORD      cbSize;
  BYTE      Type;
  BYTE      Flags;
  WORD      Count;
  WORD      BegCtrlID;
  POPTPARAM pOptParam;
  WORD      Style;
  WORD      wReserved[3];
  ULONG_PTR dwReserved[3];
} OPTTYPE, *POPTTYPE;

Membres

cbSize

Taille, en octets, de la structure OPTTYPE .

Type

Spécifie le type d’option CPSUI.

Flags

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

OPTTF_NOSPACE_BEFORE_POSTFIX

CPSUI ne doit pas ajouter d’espace entre la chaîne spécifiée par la chaîne pName de la structure OPTITEM et la chaîne pData de la structure OPTPARAM lors de l’affichage de l’option.

Valide uniquement si le type d’option est ou TVOT_SCROLLBAR ou TVOT_TRACKBAR.

OPTTF_TYPE_DISABLED

Toutes les structures OPTPARAM sur lesquelles les points pOptParam sont désactivés, afin qu’aucune des valeurs de paramètre ne soit sélectionnable par l’utilisateur.

Count

Spécifie le nombre de structures OPTPARAM vers lesquelles pOptParam pointe. La valeur de ce membre dépend du type d’option CPSUI.

BegCtrlID

Si pDlgPage dans COMPROPSHEETUI identifie une page fournie par CPSUI, ou si DlgTemplateID dans DLGPAGE identifie un modèle fourni par CPSUI, BegCtrlID n’est pas utilisé.

Sinon, BegCtrlID doit contenir le premier d’un ensemble numéroté séquentiellement d’identificateurs de contrôle Windows. L’utilisation de l’identificateur de contrôle dépend du type d’option CPSUI.

pOptParam

Pointeur vers un tableau de structures OPTPARAM décrivant les valeurs de paramètre qu’un utilisateur peut sélectionner pour l’option.

Style

Spécifie les indicateurs qui peuvent être utilisés pour modifier les caractéristiques d’affichage de l’option. Les indicateurs qui peuvent être spécifiés dépendent du type d’option CPSUI.

wReserved[3]

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

dwReserved[3]