CPen::CPen

CPen( );

CPen ( int nPenStyle, int nWidth właściwości, COLORREF crColor );
rzut ( CResourceException );

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

Parametry

nPenStyle

Określa styl pióra. Ten parametr w pierwszej wersji konstruktora może mieć jedną z następujących wartości:

• PS_SOLID   Tworzy stałe pióro.
  
  
• PS_DASH   Tworzy kreskowane pióra. Prawidłowy tylko w przypadku, gdy szerokość pióra jest 1 lub mniej, w urządzeniu jednostek.
  
  
• PS_DOT   Tworzy kropkowane pióra. Prawidłowy tylko w przypadku, gdy szerokość pióra jest 1 lub mniej, w urządzeniu jednostek.
  
  
• PS_DASHDOT   Tworzy pióro z naprzemiennych kresek i kropek. Prawidłowy tylko w przypadku, gdy szerokość pióra jest 1 lub mniej, w urządzeniu jednostek.
  
  
• PS_DASHDOTDOT   Tworzy pióro z naprzemiennych kresek i podwójne kropek. Prawidłowy tylko w przypadku, gdy szerokość pióra jest 1 lub mniej, w urządzeniu jednostek.
  
  
• PS_&NULLnbsp;  Tworzy puste pióro.
  
  
• PS_I&NSIDEFRAMEnbsp;  Tworzy Pióro rysuje linię wewnątrz ramki kształtów zamkniętych produkowane przez funkcje wyjście Windows GDI, które określają prostokąta obwiedni (na przykład, Elipsa, prostokąt, RoundRect, kołowyi funkcje składowe Chord ). Gdy ten styl jest używana w funkcji wyjście Windows GDI, które należy określać prostokąta obwiedni (na przykład funkcji składowej LineTo ), obszaru rysowania pióra nie jest ograniczone przez ramkę.

  Druga wersja konstruktora CPen określa kombinację typu, styl, zakończenie i atrybuty sprzężenia. Wartości z każdej kategorii powinny zostać połączone za pomocą operatora OR logiczną (|). Typ pióra może mieć jedną z następujących wartości:

• PS_GEOMETRIC   Tworzy geometryczne pióro.
  
  
• PS_COSMETIC   Tworzy kosmetycznych pióro.

  Druga wersja konstruktora CPen dodaje następujące style pióro nPenStyle:

• PS_ALTER&NATEnbsp;  Tworzy pióra, która ustawia w każdym pikselu. (Ten styl jest stosowane tylko dla kosmetycznych pióra).
  
  
• PS_USERSTYLE   Tworzy pióra, korzystającej z tablicy style dostarczone przez użytkownika.

  Zakończenie może mieć jedną z następujących wartości:

• PS_E&NDCAP_ROUNDnbsp;  Pokryw są okrągłe.
  
  
• PS_E&NDCAP_SQUAREnbsp;  Pokryw są kwadratowe.
  
  
• PS_E&NDCAP_FLATnbsp;  Pokryw są płaskie.

  Sprzężenie może mieć jedną z następujących wartości:

• PS_JOI&N_BEVELnbsp;  Sprzężenia są ukośne.
  
  
• PS_JOI&N_MITERnbsp;  Sprzężenia są mitered, jeżeli są one w bieżącym określonym przez :: SetMiterLimit funkcji. Jeśli sprzężenie przekracza ten limit, jest ukośne.
  
  
• PS_JOI&N_ROUNDnbsp;  Sprzężenia są okrągłe.

nWidth właściwości

Określa szerokość pióra.

• Pierwsza wersja konstruktora Jeśli ta wartość jest równa 0, szerokość w jednostkach urządzenia jest zawsze 1 piksel, niezależnie od trybu mapowania.
  
  
• Drugą wersję konstruktora Jeż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 struktury LOGBRUSH . 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

Użycie konstruktora bez argumentów, musisz zainicjować wynikowy obiekt CPen z funkcjami Państwa CreatePen, CreatePenIndirectlub CreateStockObject . Jeśli używasz konstruktora, używającej argumentami, nie dalsze inicjowania jest niezbędne. Konstruktor z argumentami mogą Zgłoś wyjątek, jeśli występują błędy, natomiast konstruktora bez argumentów zawsze kończy się pomyślnie.

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

Zobacz też CPen::CreatePen, CPen::CreatePenIndirect, CGdiObject::CreateStockObject