IFont::Clone-Methode (ocidl.h)

  • Artikel

Erstellt ein dupliziertes Schriftartobjekt mit einem Zustand, der mit der aktuellen Schriftart identisch ist.

Syntax

HRESULT Clone(
  [out] IFont **ppFont
);

Parameter

[out] ppFont

Adresse der IFont-Zeigervariable, die den Schnittstellenzeiger auf das neue Schriftartobjekt empfängt . Der Aufrufer muss IFont::Release aufrufen, wenn dieses neue Schriftartobjekt nicht mehr benötigt wird.

Rückgabewert

Die Methode unterstützt die Standardrückgabewerte E_UNEXPECTED und E_OUTOFMEMORY sowie die folgenden Werte.

Rückgabecode BESCHREIBUNG
S_OK
 Das neue Schriftartobjekt wurde erfolgreich erstellt.
E_NOTIMPL
 Dieses Schriftartobjekt unterstützt das Klonen nicht.
E_POINTER
 Die Adresse in ppfont ist ungültig. Es kann z. B. NULL sein.

Hinweise

Hinweise für Anrufer

Das neue Schriftobjekt ist völlig unabhängig vom ersten. Der Aufrufer ist dafür verantwortlich, dieses neue Objekt freizugeben, wenn es nicht mehr benötigt wird. Diese Methode wirkt sich nicht auf die Verweisanzahl der geklonten Schriftart aus.

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