Méthode IShellImageData ::ReplaceFrame (shimgdata.h)

Article
03/06/2024

Remplace le cadre actuel par une nouvelle image.

Syntaxe

HRESULT ReplaceFrame(
  [in] Image *pImg
);

Paramètres

[in] pImg

Type : Image*

Adresse de la nouvelle image.

Valeur retournée

Type : HRESULT

Retourne toujours S_OK.

Remarques

Vous devez également appeler IShellImageData ::D iscardEdit pour vous assurer que les propriétés modifiées de l’image d’origine ne sont pas conservées.

Dans le cas d’une image multiframe, telle qu’un fichier .gif, le cadre actuel est remplacé. Dans le cas d’images non multiframes telles qu’un fichier .jpg, l’image entière est remplacée.

Le remplacement d’une image dans un fichier .gif animé fait que l’animation de ce fichier n’est plus fonctionnelle. Le remplacement d’une image dans un fichier TIFF (Tagged Image File Format) peut entraîner la perte de pages de ce fichier, en particulier si l’image du cadre TIFF n’a pas la même taille que l’image d’origine. Si possible, vous devez toujours remplacer l’image d’un cadre TIFF par un TIFF de la même taille.

L’implémentation IShellImageData prend la propriété de l’image nommée dans pImg et l’appelant ne doit pas essayer de l’utiliser après l’appel de IShellImageData ::ReplaceFrame.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shimgdata.h
DLL	Shell32.dll

Partager via