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

Weitere Informationen

Matrix

Rect

Region

Region::GetRegionScans-Methoden