CPen::CPen

CPen( );

CPen ( int nPenStyle, int nWidth, COLORREF crColor );
jeter ( CResourceException );

CPen ( int nPenStyle, int nWidth, const LOGBRUSH * pLogBrush, int nStyleCount = 0, const DWORD * lpStyle = NULL );
jeter ( CResourceException );

Paramètres

nPenStyle

Spécifie le style de plume. Ce paramètre dans la première version du constructeur peut être l'une des valeurs suivantes:

PS_SOLID ; Crée un stylet solid.
PS_DASH ; Crée un stylet en pointillés. Valide uniquement lorsque la largeur de la plume est de 1 ou moins, dans le dispositif d'unités.
PS_DOT ; Crée un stylet en pointillés. Valide uniquement lorsque la largeur de la plume est de 1 ou moins, dans le dispositif d'unités.
PS_DASHDOT ; Crée un stylet avec alternance de points et tirets. Valide uniquement lorsque la largeur de la plume est de 1 ou moins, dans le dispositif d'unités.
PS_DASHDOTDOT ; Crée un stylet avec alternance des tirets et des points en doubles. Valide uniquement lorsque la largeur de la plume est de 1 ou moins, dans le dispositif d'unités.
PS_&NULLnbsp ; Crée un stylet null.
PS_I&NSIDEFRAMEnbsp ; Crée un stylet qui dessine une ligne à l'intérieur du cadre des formes fermées produites par les fonctions de sortie de Windows GDI qui spécifient un rectangle englobant (par exemple, l'Ellipse, Rectangle, RoundRect, Pieet fonctions membres de corde ). Lorsque ce style est utilisé avec les fonctions de sortie de Windows GDI qui ne spécifient pas un rectangle englobant (par exemple, la fonction LineTo membre), la zone de dessin de la plume n'est pas limitée par un cadre.
La deuxième version du CPen constructeur spécifie une combinaison de type, style, capuchon et attributs de jointure. Les valeurs de chaque catégorie doivent être combinés à l'aide de l'opérateur de bits OR (|). Le type de stylo peut être l'une des valeurs suivantes:
PS_GEOMETRIC ; Crée un stylet géométrique.
PS_COSMETIC ; Crée un stylet cosmétique.
La deuxième version du constructeur CPen ajoute les styles suivants de la plume pour nPenStyle:
PS_ALTER&NATEnbsp ; Crée un stylet qui définit tous les autres pixels. (Ce style est applicable seulement pour les crayons cosmétiques).
PS_USERSTYLE ; Crée un stylet qui utilise un tableau de style fourni par l'utilisateur.
Le bouchon peut être l'une des valeurs suivantes:
PS_E&NDCAP_ROUNDnbsp ; Bouchons d'extrémité sont rondes.
PS_E&NDCAP_SQUAREnbsp ; Bouchons d'extrémité sont carrés.
PS_E&NDCAP_FLATnbsp ; Bouchons d'extrémité sont plates.
La jointure peut être l'une des valeurs suivantes:
PS_JOI&N_BEVELnbsp ; Les jointures sont en biseau.
PS_JOI&N_MITERnbsp ; Les jointures sont mitered quand ils sont dans l'actuelle limite définie par la :: SetMiterLimit fonction. Si la jointure dépasse cette limite, il est en relief.
PS_JOI&N_ROUNDnbsp ; Les jointures sont rondes.

nLargeur

Spécifie la largeur de la plume.

Pour la première version du constructeur, si cette valeur est 0, la largeur en unités de périphérique est toujours 1 pixel, indépendamment de la mode de mappage.
Pour la deuxième version du constructeur, 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

Pointe vers une structure LOGBRUSH . 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

Si vous utilisez le constructeur sans arguments, vous devez initialiser l'objet CPen avec les fonctions de membre de CreatePen, CreatePenIndirectou CreateStockObject . Si vous utilisez le constructeur qui prend les arguments, aucune initialisation supplémentaire n'est nécessaire. Le constructeur avec arguments peut lever une exception si des erreurs sont rencontrées, alors que le constructeur sans arguments réussira toujours.

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

Voir aussi ;CPen::CreatePen, CPen::CreatePenIndirect, CGdiObject::CreateStockObject

Index