Structure EXTLOGPEN (wingdi.h)

La structure EXTLOGPEN définit le stylet, la largeur et les attributs de pinceau d’un stylet étendu. Cette structure est utilisée par la fonction GetObject lorsqu’elle récupère une description d’un stylet créé lors d’une application appelée fonction ExtCreatePen .

Syntaxe

typedef struct tagEXTLOGPEN {
  DWORD     elpPenStyle;
  DWORD     elpWidth;
  UINT      elpBrushStyle;
  COLORREF  elpColor;
  ULONG_PTR elpHatch;
  DWORD     elpNumEntries;
  DWORD     elpStyleEntry[1];
} EXTLOGPEN, *PEXTLOGPEN, *NPEXTLOGPEN, *LPEXTLOGPEN;

Membres

elpPenStyle

Combinaison de type de stylet, de style, de stylet de fin et de style de jointure. Les valeurs de chaque catégorie peuvent être récupérées à l’aide d’un opérateur AND au niveau du bit avec le masque approprié.

Le membre elpPenStyle masqué avec PS_TYPE_MASK a l’une des valeurs de type de stylet suivantes.

Le membre elpPenStyle masqué avec PS_STYLE_MASK a l’une des valeurs de stylet suivantes :

La catégorie suivante s’applique uniquement aux PS_GEOMETRIC stylets. Le membre elpPenStyle masqué avec PS_ENDCAP_MASK a l’une des valeurs de limite de fin suivantes.

La catégorie suivante s’applique uniquement aux PS_GEOMETRIC stylets. Le membre elpPenStyle masqué avec PS_JOIN_MASK a l’une des valeurs de jointure suivantes.

elpWidth

Largeur du stylet. Si le membre elpPenStyle est PS_GEOMETRIC, cette valeur correspond à la largeur de la ligne en unités logiques. Sinon, les lignes sont cosmétiques et cette valeur est 1, ce qui indique une ligne d’une largeur d’un pixel.

elpBrushStyle

Style de pinceau du stylet. La valeur du membre elpBrushStyle peut être l’une des suivantes.

elpColor

Si elpBrushStyle est BS_SOLID ou BS_HATCHED, elpColor spécifie la couleur dans laquelle le stylet doit être dessiné. Par BS_HATCHED, les fonctions SetBkMode et SetBkColor déterminent la couleur d’arrière-plan.

Si elpBrushStyle est BS_HOLLOW ou BS_PATTERN, elpColor est ignoré.

Si elpBrushStyle est BS_DIBPATTERN ou BS_DIBPATTERNPT, le mot d’ordre inférieur elpColor spécifie si le membre bmiColors de la structure BITMAPINFO contient des valeurs RVB explicites ou des index dans la palette logique actuellement réalisée. La valeur elpColor doit être l’une des valeurs suivantes.

La macro RVB est utilisée pour générer une structure COLORREF .

elpHatch

Si elpBrushStyle est BS_PATTERN, elpHatch est un handle de la bitmap qui définit le modèle.

Si elpBrushStyle est BS_SOLID ou BS_HOLLOW, elpHatch est ignoré.

Si elpBrushStyle est BS_DIBPATTERN, le membre elpHatch est un handle pour une DIB emballée. Pour obtenir ce handle, une application appelle la fonction GlobalAlloc avec GMEM_MOVEABLE (ou LocalAlloc avec LMEM_MOVEABLE) pour allouer un bloc de mémoire, puis remplit la mémoire avec la DIB empaquetée. Une DIB empaquetée se compose d’une structure BITMAPINFO immédiatement suivie du tableau d’octets qui définissent les pixels de l’image bitmap.

Si elpBrushStyle est BS_DIBPATTERNPT, le membre elpHatch est un pointeur vers une DIB empaquetée. Le pointeur dérive du bloc de mémoire créé par LocalAlloc avec LMEM_FIXED défini ou par GlobalAlloc avec GMEM_FIXED défini, ou il s’agit du pointeur retourné par un appel comme LocalLock (handle_to_the_dib). Une DIB empaquetée se compose d’une structure BITMAPINFO immédiatement suivie du tableau d’octets qui définissent les pixels de la bitmap.

Si elpBrushStyle est BS_HATCHED, le membre elpHatch spécifie l’orientation des lignes utilisées pour créer la trappe. Il peut avoir l’une des valeurs suivantes.

elpNumEntries

Nombre d’entrées dans le tableau de styles dans le membre elpStyleEntry . Cette valeur est égale à zéro si elpPenStyle ne spécifie pas PS_USERSTYLE.

elpStyleEntry[1]

Tableau de styles fourni par l’utilisateur. Le tableau est spécifié avec une longueur finie, mais il est utilisé comme s’il se répétait indéfiniment. La première entrée du tableau spécifie la longueur du premier tiret. La deuxième entrée spécifie la longueur du premier intervalle. Par la suite, les longueurs de tirets et les espaces alternent.

Si elpWidth spécifie des lignes géométriques, les longueurs sont en unités logiques. Sinon, les lignes sont cosmétiques et les longueurs sont en unités d’appareil.

Configuration requise

Voir aussi

BITMAPINFO

COLORREF

ExtCreatePen

Getobject

Structures du stylet

Vue d’ensemble des stylos

RGB

SetBkColor

SetBkMode