Region::GetRegionScansCount-Methode (gdiplusheaders.h)
Die Region::GetRegionScansCount-Methode ruft die Anzahl der Rechtecke ab, die sich dieser Region annähern. Der Bereich wird von einer angegebenen Matrix transformiert, bevor die Rechtecke berechnet werden.
Syntax
UINT GetRegionScansCount(
[in] const Matrix *matrix
);
Parameter
[in] matrix
Typ: const Matrix*
Zeiger auf eine Matrix, die zum Transformieren der Region verwendet wird.
Rückgabewert
Typ: UINT
Diese Methode gibt eine ganze Zahl zurück, die die Anzahl der Rechtecke angibt, die dieser Region entsprechen.
Hinweise
Die Region::GetRegionScansCount-Methode kann vor der GetRegionScans-Methode verwendet werden, um die Anzahl der Rechtecke zu bestimmen. Anschließend können Sie einen Puffer mit der richtigen Größe zuordnen, um die Rechtecke zu speichern, die mit der GetRegionScans-Methode abgerufen werden.
Beispiele
Im folgenden Beispiel wird eine Region aus einem Pfad erstellt und eine Gruppe von Rechtecken abgerufen, die der Region annähern. Der Code zeichnet dann die einzelnen Rechtecke.
VOID Example_GetRegionScansCount(HDC hdc)
{
Graphics graphics(hdc);
SolidBrush solidBrush(Color(255, 255, 0, 0));
Pen pen(Color(255, 0, 0, 0));
GraphicsPath path;
Matrix matrix;
RectF* rects = NULL;
INT count = 0;
// Create a region from a path.
path.AddEllipse(10, 10, 50, 300);
Region pathRegion(&path);
graphics.FillRegion(&solidBrush, &pathRegion);
// Get the rectangles.
graphics.GetTransform(&matrix);
count = pathRegion.GetRegionScansCount(&matrix);
rects = (RectF*)malloc(count*sizeof(RectF));
pathRegion.GetRegionScans(&matrix, rects, &count);
// Draw the rectangles.
for(INT j = 0; j < count; ++j)
graphics.DrawRectangle(&pen, rects[j]);
free(rects);
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP, Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | gdiplusheaders.h (include Gdiplus.h) |
| Bibliothek | Gdiplus.lib |
| DLL | Gdiplus.dll |