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 );

Valore restituito

Nonzero o l'handle di una penna logica, in caso di successo; in caso contrario 0.

Parametri

nPenStyle

Specifica lo stile per la penna. Per un elenco dei valori possibili, vedere il parametro nPenStyle nel costruttore CPen.

nWidth

Specifica la larghezza della penna.

• Per la prima versione di CreatePen, se questo valore è 0, la larghezza in unità periferica è sempre 1 pixel, indipendentemente dalla modalità di mapping.
  
  
• Per la seconda versione di CreatePen, 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

Punta a un LOGBRUSH struttura. 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

La prima versione di CreatePen Inizializza una penna con lo stile specificato, la larghezza e il colore. La penna può essere successivamente selezionata come la penna corrente per ogni contesto di periferica.

Penne che hanno una larghezza maggiore di 1 pixel dovrebbero sempre avere stile PS_NULL, PS_SOLIDo PS_INSIDEFRAME.

Se una penna ha lo stile PS_INSIDEFRAME e un colore che non corrisponde a un colore nella tabella colori logico, la penna viene disegnata con un colore dithering. Lo stile della penna PS_SOLID non può essere utilizzato per creare una penna con un colore dithering. Lo stile PS_INSIDEFRAME è identico a PS_SOLID se la larghezza della penna è minore o uguale a 1.

La seconda versione del CreatePen Inizializza una penna geometrica o cosmetica logica che ha specificato lo stile, la larghezza e pennello attributi. La larghezza di una penna cosmetica è sempre 1; la larghezza di una penna geometrica è sempre specificata in unità del mondo. Dopo un'applicazione crea una penna logica, è possibile selezionare tale penna in un contesto di periferica chiamando il CDC::SelectObject funzione. Dopo aver selezionata una penna in un contesto di periferica, può essere utilizzato per disegnare linee e curve.

• Se nPenStyle è PS_COSMETIC e PS_USERSTYLE, le voci della matrice lpStyle specificano lunghezze di trattini e spazi in unità di stile. Un'unità di stile è definita dal dispositivo in cui viene utilizzata la penna per disegnare una linea.
  
  
• Se nPenStyle è PS_GEOMETRIC e PS_USERSTYLE, le voci della matrice lpStyle specificano lunghezze di trattini e spazi in unità logiche.
  
  
• Se nPenStyle è PS_ALTERNATE, l'unità di stile viene ignorato e altri ogni pixel è impostato.

Quando un'applicazione non richiede non più di una determinata penna, si dovrebbe chiamare la funzione membro CGdiObject::DeleteObject o distruggere l'oggetto CPen in modo che la risorsa non è più in uso. Un'applicazione non eliminare una penna penna selezionato in un contesto di periferica.

Panoramica CPen |nbsp; Membri della classe | Gerarchia Chart

Vedere a&nchenbsp;CPen::CreatePenIndirect, CPen::CPen, CGdiObject::DeleteObject, LOGBRUSH