Region::GetHRGN-Methode (gdiplusheaders.h)

  • Artikel

Die Region::GetHRGN-Methode erstellt eine Windows Graphics Device Interface (GDI)-Region aus dieser Region.

Syntax

HRGN GetHRGN(
  [in] const Graphics *g
);

Parameter

[in] g

Typ: const Graphics*

Zeiger auf ein Graphics-Objekt , das die Welt- und Seitentransformationen enthält, die zum Berechnen der Gerätekoordinaten dieser Region erforderlich sind.

Rückgabewert

Typ: HRGN

Diese Methode gibt ein Windows-Handle an eine GDI-Region zurück, die aus dieser Region erstellt wird.

Hinweise

Es liegt in der Verantwortung des Aufrufers, die GDI-Funktion DeleteObject aufzurufen, um die GDI-Region frei zu geben, wenn sie nicht mehr benötigt wird.

Beispiele

Im folgenden Beispiel wird eine GDI+-Region aus einem Pfad erstellt und dann die GDI+-Region verwendet, um eine GDI-Region zu erstellen. Der Code verwendet dann eine GDI-Funktion, um die GDI-Region anzuzeigen.

VOID Example_GetHRGN(HDC hdc)
{
   Graphics graphics(hdc);

    Point points[] = {
      Point(110, 20),
      Point(120, 30),
      Point(100, 60),
      Point(120, 70),
      Point(150, 60),
      Point(140, 10)};

   GraphicsPath path;
   path.AddClosedCurve(points, 6);

    // Create a region from a path.
    Region pathRegion(&path);

   // Get a handle to a GDI region.
   HRGN hRegion;
   hRegion = pathRegion.GetHRGN(&graphics);

   // Use GDI to display the region.
   HBRUSH hBrush = CreateSolidBrush(RGB(255, 0, 0));
   FillRgn(hdc, hRegion, hBrush);

   DeleteObject(hBrush);
   DeleteObject(hRegion);
}

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

DeleteObject

Grafiken

Rect

Region