Share via

Méthode IFont ::Clone (ocidl.h)

  • Article

Crée un objet de police en double avec un état identique à la police actuelle.

Syntaxe

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

Paramètres

[out] ppFont

Adresse de la variable pointeur IFont qui reçoit le pointeur d’interface vers le nouvel objet de police. L’appelant doit appeler IFont ::Release lorsque ce nouvel objet de police n’est plus nécessaire.

Valeur retournée

La méthode prend en charge les valeurs de retour standard E_UNEXPECTED et E_OUTOFMEMORY, ainsi que les valeurs suivantes.

Code de retour Description
S_OK
 Le nouvel objet de police a été créé avec succès.
E_NOTIMPL
 Cet objet de police ne prend pas en charge le clonage.
E_POINTER
 L’adresse dans ppfont n’est pas valide. Par exemple, il peut s’agir de NULL.

Remarques

Remarques aux appelants

Le nouvel objet de police est entièrement indépendant du premier. L’appelant est chargé de libérer ce nouvel objet quand il n’est plus nécessaire. Cette méthode n’affecte pas le nombre de références de la police en cours de clonage.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête ocidl.h

Voir aussi

IFont