CRgn::CreatePolyPolygonRgn

Artykuł
02/27/2013

Tworzy regionu składającą się z szeregu zamkniętych wielokątów.

BOOL CreatePolyPolygonRgn(
   LPPOINT lpPoints,
   LPINT lpPolyCounts,
   int nCount,
   int nPolyFillMode 
);

Parametry

lpPoints
Punkty do tablicy punkt struktur lub tablica CPoint obiektów, które definiuje wierzchołki wielokątów.Każdego wielokąta musi jawnie zamknięty, ponieważ system nie zamknąć je automatycznie.Wielokąty są określane sukcesywnie.Punkt struktura ma następującą postać:

typedef struct tagPOINT {

int x;

int y;

} POINT;
lpPolyCounts
Punkty do tablicy liczb całkowitych.Pierwsza liczba całkowita określa liczbę wierzchołków w pierwszym Wielokąt w lpPoints tablicy, drugi całkowitą określa liczbę wierzchołki wielokąta drugi itd.
nCount
Określa całkowitą liczbę liczby całkowite w lpPolyCounts tablicy.
nPolyFillMode
Określa tryb Wielokąt wypełniania.Ta wartość może być albo alternatywne lub UZWOJENIE.

Wartość zwracana

Niezerowa, jeśli operacja powiodła się; 0 inaczej.

Uwagi

Wynikowy regionu są przechowywane w CRgn obiektu.

Wielokąty może być odłączony lub może zachodzić na.

Rozmiar regionu jest ograniczona do 32 767 przez 32 767 logiczne jednostki lub 64 K pamięci, jest mniejsze.

Gdy tryb Wielokąt wypełniania jest alternatywne, system wypełnia obszar między stron nieparzystych i parzystych Wielokąt w każdym wierszu skanowania.Oznacza to, że system wypełnia obszar, między pierwszym i drugim po stronie, między trzecim i czwartym stronie itd.

Gdy tryb Wielokąt wypełniania jest UZWOJENIE, system używa kierunek Sporządzono rysunek do ustalenia, czy wypełnianie obszaru.Każdego segmentu linii wielokąta jest rysowane zegara lub wskazówek zegara.Ilekroć umowną linią wyznaczoną z obszaru na zewnątrz rysunek przechodzi ruchem linia, licznik jest zwiększany.Gdy linia przechodzi przez segment linii zegara, licznik jest zmniejszany.Obszar jest wypełniany, jeśli liczba jest niezerowy, gdy wiersz osiągnie poza rysunek.

Gdy aplikacja zakończy regionu utworzonych za pomocą CreatePolyPolygonRgn funkcji, to należy wybrać region out kontekstu urządzenia i wykorzystania CGDIObject::DeleteObject Członkowskich funkcji go usunąć.