CPen::CreatePen

BOOL CreatePen ( int nPenStyle, int nWidth, COLORREF crColor );

BOOL CreatePen ( int nPenStyle, int nWidth, const LOGBRUSH * pLogBrush, int nStyleCount = 0, const DWORD * lpStyle = NULL );

Valeur de retour

Nonzero, ou la poignée de plume logique, en cas de succès ; sinon 0.

Paramètres

nPenStyle

Spécifie le style de la plume. Pour une liste des valeurs possibles, consultez le paramètre nPenStyle dans le constructeur du CPen.

nLargeur

Spécifie la largeur de la plume.

• Pour la première version de CreatePen, si cette valeur est 0, la largeur en unités de périphérique est toujours 1 pixel, indépendamment du mode de cartographie.
  
  
• Pour la deuxième version de CreatePen, si nPenStyle est PS_GEOMETRIC, la largeur est donnée en unités logiques. Si nPenStyle est PS_COSMETIC, la largeur doit être définie à 1.

crColor

Contient une couleur RVB pour le stylet.

pLogBrush

Points à un LOGBRUSH structure. Si nPenStyle est PS_COSMETIC, le membre lbColor de la structure LOGBRUSH spécifie la couleur de la plume et le membre lbStyle de la structure LOGBRUSH doit être défini sur BS_SOLID. Si nPenStyle est PS_GEOMETRIC, tous les membres doivent être utilisés pour spécifier les attributs de la brosse de la plume.

nStyleCount

Spécifie la longueur, en unités double mot du tableau lpStyle . Cette valeur doit être zéro, si nPenStyle n'est pas PS_USERSTYLE.

lpStyle

Pointe vers un tableau de valeurs double mot. La première valeur spécifie la longueur de la première dash dans un style défini par l'utilisateur, la seconde valeur spécifie la longueur de l'espace première et ainsi de suite. Ce pointeur doit être NULL si nPenStyle n'est pas PS_USERSTYLE.

Remarques

La première version de CreatePen Initialise un stylo avec le style spécifié, la largeur et la couleur. La plume peut être sélectionnée par la suite comme le stylet actuel pour n'importe quel contexte de périphérique.

Stylos qui ont une largeur de plus de 1 pixel devraient toujours être en style de la PS_NULL, PS_SOLIDou PS_INSIDEFRAME.

Si un stylo a le style PS_INSIDEFRAME et une couleur qui ne correspond pas à une couleur dans la table des couleurs logique, la plume est dessinée avec une couleur dégradée. Le style de plume PS_SOLID ne peut servir à créer un stylo avec une couleur dégradée. Le style PS_INSIDEFRAME est identique à PS_SOLID , si la largeur de la plume est inférieure ou égale à 1.

La deuxième version du CreatePen Initialise un crayon cosmétique ou géométrique logique qui a le style, la largeur et brossez les attributs. La largeur d'un crayon cosmétique est toujours 1 ; la largeur de plume géométrique est toujours spécifiée en unités universelles. Après une application crée un stylo logique, il peut choisir ce stylo dans un contexte de périphérique en appelant le CDC::SelectObject fonction. Après sélection d'un stylo dans un contexte de périphérique, il peut être utilisé pour dessiner des lignes et des courbes.

• Si nPenStyle est PS_COSMETIC et PS_USERSTYLE, les entrées dans le tableau lpStyle spécifient les longueurs des tirets et des espaces dans les unités de style. Une unité de style est définie par le dispositif dans lequel le stylet est utilisé pour dessiner une ligne.
  
  
• Si nPenStyle est PS_GEOMETRIC et PS_USERSTYLE, les entrées dans le tableau lpStyle spécifient les longueurs des tirets et des espaces dans les unités logiques.
  
  
• Si nPenStyle est PS_ALTERNATE, l'unité de style est ignorée et autre chaque pixel est définie.

Lorsqu'une demande n'est plus un stylo donné, il doit appeler la fonction membre CGdiObject::DeleteObject ou détruire l'objet CPen donc la ressource n'est plus en usage. Une application doit supprimer pas un stylet lorsque le stylet est sélectionné dans un contexte de périphérique.

CPen aperçu |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CPen::CreatePenIndirect, CPen::CPen, CGdiObject::DeleteObject, LOGBRUSH