CPen::CPen

CPen( );

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

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

Parametri

nPenStyle

Specifica lo stile della penna. Questo parametro nella prima versione del costruttore può essere uno dei seguenti valori:

PS_SOLID Crea una penna solida.
PS_DASH Crea una penna tratteggiata. Valido solo quando la larghezza della penna è unità 1 o meno, nel dispositivo.
PS_DOT Crea una penna con punti. Valido solo quando la larghezza della penna è unità 1 o meno, nel dispositivo.
PS_DASHDOT Crea una penna con alternanza di trattini e punti. Valido solo quando la larghezza della penna è unità 1 o meno, nel dispositivo.
PS_DASHDOTDOT Crea una penna con alternanza di trattini e doppi punti. Valido solo quando la larghezza della penna è unità 1 o meno, nel dispositivo.
PS_&NULLnbsp; Crea una penna null.
PS_I&NSIDEFRAMEnbsp; Crea una penna che disegna una linea all'interno della cornice di forme chiuse prodotta dalle funzioni di uscita Windows GDI che specificano un rettangolo di delimitazione (ad esempio, l'ellisse, rettangolo, RoundRect, Piee funzioni membro Chord ). Quando questo stile viene utilizzato con funzioni di uscita di Windows GDI che non specificano un rettangolo di delimitazione (ad esempio, la funzione membro LineTo ), l'area di disegno della penna non è limitato da un telaio.
La seconda versione del costruttore CPen specifica una combinazione del tipo, stile, testata e unire gli attributi. I valori da ogni categoria dovrebbero essere combinati utilizzando l'operatore OR bit per bit (|). Il tipo di penna può essere uno dei seguenti valori:
PS_GEOMETRIC Crea una penna geometrica.
PS_COSMETIC Crea una penna cosmetica.
La seconda versione del costruttore CPen aggiunge i seguenti stili di penna per nPenStyle:
PS_ALTER&NATEnbsp; Crea una penna che imposta ogni altri pixel. (Questo stile è applicabile solo per le penne cosmetici).
PS_USERSTYLE Crea una penna che utilizza una matrice di stile fornita dall'utente.
La testata può essere uno dei seguenti valori:
PS_E&NDCAP_ROUNDnbsp; Cappucci terminali sono rotonde.
PS_E&NDCAP_SQUAREnbsp; Cappucci terminali sono quadrati.
PS_E&NDCAP_FLATnbsp; Cappucci terminali sono piatti.
Il join può essere uno dei seguenti valori:
PS_JOI&N_BEVELnbsp; Join sono smussati.
PS_JOI&N_MITERnbsp; Join sono mitered quando sono entro il limite di corrente impostato per il :: SetMiterLimit funzione. Se il join supera questo limite, esso è smussato.
PS_JOI&N_ROUNDnbsp; Join sono rotondi.

nWidth

Specifica la larghezza della penna.

Per la prima versione del costruttore, se questo valore è 0, la larghezza in unità periferica è sempre 1 pixel, indipendentemente dalla modalità di mapping.
Per la seconda versione del costruttore, se nPenStyle è PS_GEOMETRIC, la larghezza è dato in unità logiche. Se nPenStyle è PS_COSMETIC, la larghezza deve essere impostata su 1.

crColor

Contiene un colore RGB per la penna.

pLogBrush

Punti a una struttura LOGBRUSH . Se nPenStyle è PS_COSMETIC, il membro lbColor della struttura LOGBRUSH specifica il colore della penna e il membro lbStyle della struttura LOGBRUSH deve essere impostato su BS_SOLID. Se nPenStyle è PS_GEOMETRIC, tutti i membri devono essere utilizzati per specificare gli attributi di pennello della penna.

nStyleCount

Specifica la lunghezza, in unità di Double Word, della matrice lpStyle . Questo valore deve essere zero se nPenStyle non è PS_USERSTYLE.

lpStyle

Punti a una matrice di valori Double Word. Il primo valore specifica la lunghezza del cruscotto prima in uno stile definito dall'utente, il secondo valore specifica la lunghezza del primo spazio e così via. Questo puntatore deve essere NULL se nPenStyle non è PS_USERSTYLE.

Osservazioni

Se si utilizza il costruttore senza argomenti, è necessario inizializzare l'oggetto CPen risultante con le funzioni membro di CreatePen, CreatePenIndirecto CreateStockObject . Se si utilizza il costruttore che accetta argomenti, nessun ulteriore inizializzazione è necessario. Il costruttore con argomenti può generare un'eccezione se vengono rilevati errori, mentre il costruttore senza argomenti riuscirà sempre.

Panoramica CPen |nbsp; Membri della classe | Gerarchia Chart

Vedere a&nchenbsp;CPen::CreatePen, CPen::CreatePenIndirect, CGdiObject::CreateStockObject

Index