Region::GetHRGN-Methode (gdiplusheaders.h)
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 |