IFont::SetHdc-Methode (ocidl.h)

Stellt einen Gerätekontext für die Schriftart bereit, die den logischen Zuordnungsmodus beschreibt.

Syntax

HRESULT SetHdc(
  [in] HDC hDC
);

Parameter

[in] hDC

Ein Handle für den Gerätekontext, in dem die Schriftart ausgewählt werden soll.

Rückgabewert

Die Methode unterstützt den Standardrückgabewert E_INVALIDARG sowie die folgenden Werte.

Rückgabecode BESCHREIBUNG
S_OK
Die Schriftart wurde erfolgreich ausgewählt.
E_NOTIMPL
Die Schriftartauswahl wird über dieses Schriftartobjekt nicht unterstützt.

Hinweise

Der logische Zuordnungsmodus wirkt sich auf die interne Berechnung der Punktgröße der Schriftart aus, sodass die Schriftart bereits ordnungsgemäß auf den Gerätekontext skaliert wird, wenn der Aufrufer durch Aufrufen von IFont::get_hFont nach einem Schriftarthandle fragt.

Hinweise für Anrufer

Der Aufrufer behält den Besitz dieses Gerätekontexts, der für die Lebensdauer des Schriftartobjekts gültig bleiben muss. Daher sollte der übergebene Gerätekontext ein Speichergerätekontext (aus der Funktion CreateCompatibleDC) und kein Bildschirmgerätekontext (aus CreateDC, GetDC oder BeginPaint) sein, da Bildschirmgerätekontexte eine begrenzte Systemressource sind.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

IFont