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