Graphics::SetSmoothingMode-Methode (gdiplusgraphics.h)

Artikel
08/24/2023

Die Graphics::SetSmoothingMode-Methode legt die Renderingqualität des Graphics-Objekts fest.

Syntax

Status SetSmoothingMode(
  [in] SmoothingMode smoothingMode
);

Parameter

[in] smoothingMode

Typ: SmoothingMode

Element der SmoothingMode-Enumeration , das angibt, ob glätten (Antialiasing) auf Linien und Kurven angewendet wird.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Verwenden Sie zum Abrufen der Renderingqualität für Text die Graphics::GetTextRenderingHint-Methode . Je höher die Qualität des Glättungsmodus, desto langsamer ist die Leistung.

Beispiele

Im folgenden Beispiel wird der Glättungsmodus auf zwei verschiedene Werte festgelegt und eine Ellipse ausgefüllt, um jeden Modus zu veranschaulichen.

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

   // Set the smoothing mode to SmoothingModeHighSpeed, and fill an ellipse.
   graphics.SetSmoothingMode(SmoothingModeHighSpeed);
   graphics.FillEllipse(&SolidBrush(Color(255, 0, 0, 0)), 0, 0, 200, 100);

   // Set the smoothing mode to SmoothingModeHighQuality, and fill an ellipse.
   graphics.SetSmoothingMode(SmoothingModeHighQuality);
   graphics.FillEllipse(&SolidBrush(Color(255, 0, 0, 0)), 200, 0, 200, 100);
}

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	gdiplusgraphics.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll