CPen::CreatePen

BOOL CreatePen ( int nPenStyle, int nWidth właściwości, COLORREF crColor );

BOOL CreatePen ( int nPenStyle, int nWidth właściwości, const LOGBRUSH * pLogBrush, int nStyleCount = 0, Stała DWORD * lpStyle = NULL );

Wartość zwracany

Nonzero lub uchwyt logiczne pióra, jeśli kończy się pomyślnie; inny sposób 0.

Parametry

nPenStyle

Określa styl pióra. Aby uzyskać listę możliwych wartości Zobacz parametr nPenStyle w konstruktorze CPen.

nWidth właściwości

Określa szerokość pióra.

• Pierwsza wersja CreatePenJeśli ta wartość jest równa 0, szerokość w jednostkach urządzenia jest zawsze 1 piksel, niezależnie od trybu mapowania.
  
  
• Drugą wersję CreatePenJeżeli nPenStyle jest PS_GEOMETRIC, szerokość jest podana w jednostek logicznych. Jeśli nPenStyle jest PS_COSMETIC, szerokość musi być ustawiony na 1.

crColor

Zawiera kolory RGB, pióra.

pLogBrush

Punkty do LOGBRUSH struktury. Jeśli nPenStyle jest PS_COSMETIC, członka lbColor struktury LOGBRUSH określa kolor pióra i członek lbStyle struktury LOGBRUSH musi być ustawiony na BS_SOLID. Jeśli nPenStyle jest PS_GEOMETRIC, wszyscy członkowie muszą być używane do określania atrybutów pędzla pióra.

nStyleCount

Określa długość, liczbę jednostek, tablicy lpStyle . Wartość ta musi być od zera, jeśli nPenStyle nie jest PS_USERSTYLE.

lpStyle

Punkty do tablicy liczbę wartości. Pierwsza wartość określa długość pierwszy myślnik w stylu zdefiniowane przez użytkownika, druga wartość określa długość pierwszej spacji i tak dalej. Ten wskaźnik może być NULL , jeśli nPenStyle nie jest PS_USERSTYLE.

Uwagi

Pierwsza wersja CreatePen inicjuje pióro z określonego stylu, szerokość i kolor. Pióro można następnie wybrać bieżące pióro w dowolnym kontekście urządzenia.

Piór, które mają szerokość większą niż 1 piksel zawsze powinien mieć styl PS_NULL, PS_SOLIDlub PS_INSIDEFRAME.

Jeśli pióro ma styl PS_INSIDEFRAME i koloru, która nie jest zgodna z koloru w tabeli kolorów logiczne, pióro jest narysowany kolor symulowany. Styl PS_SOLID pióro nie może służyć do tworzenia pióro z kolor symulowany. Styl PS_INSIDEFRAME jest identyczna z PS_SOLID , jeżeli szerokość pióra jest mniejsza niż lub równa 1.

Druga wersja CreatePen inicjuje logiczne pióro kosmetycznych lub geometrycznych, zawierającą określony styl, szerokość i Pędzel atrybutów. Szerokość pióra kosmetycznych jest zawsze 1; szerokość pióra geometrycznej jest zawsze określona w jednostkach świata. Po aplikacja tworzy logiczne pióra, to wybierz wybranego pióra do kontekstu urządzenia, przez wywołanie CDC::SelectObject funkcji. Pióro jest zaznaczony do kontekstu urządzenia, można używać do rysowania linii i krzywych.

• Jeśli nPenStyle jest PS_COSMETIC i PS_USERSTYLE, wpisów w tablicy lpStyle określić długości z myślniki i spacje w jednostek stylów. Jednostek stylów jest zdefiniowany przez urządzenie, w którym Pióro służy do rysowania linii.
  
  
• Jeśli nPenStyle jest PS_GEOMETRIC i PS_USERSTYLE, wpisów w tablicy lpStyle określić długości z myślniki i spacje w jednostkach logicznych.
  
  
• Jeśli nPenStyle jest PS_ALTERNATE, jednostek stylów jest ignorowany, a każdy piksel jest ustawiony.

Jeżeli aplikacji wymaga już danego pióro, należy wywołać funkcję Państwa CGdiObject::DeleteObject lub zniszczenie obiektu CPen , aby zasób jest już w użyciu. Aplikacja nie powinien usuwać pióra, gdy pióro jest zaznaczone w kontekście urządzenia.

Omówienie CPen |nbsp; Klasa członków | Wykres hierarchii

Zobacz też CPen::CreatePenIndirect, CPen::CPen, CGdiObject::DeleteObject, LOGBRUSH