IUIImageFromBitmap::CreateImage, méthode (uiribbon.h)
Crée un objet IUIImage à partir d’une image bitmap.
Syntaxe
HRESULT CreateImage(
[in] HBITMAP bitmap,
[in] UI_OWNERSHIP options,
[out] IUIImage **image
);
Paramètres
[in] bitmap
Type : HBITMAP
Handle de la bitmap qui contient l’image.
[in] options
Type : UI_OWNERSHIP
Conditions de propriété dans lesquelles une image est créée.
| Valeur | Signification |
|---|---|
| UI_OWNERSHIP_TRANSFER | Si UI_OWNERSHIP_TRANSFER est spécifié comme valeur d’options, l’infrastructure ribbon possède le handle de l’image bitmap (HBITMAP) via l’objet IUIImage et le libère lorsque l’infrastructure n’en a plus besoin.
Note Cette option empêche l’application hôte du ruban de référencer en toute sécurité le même HBITMAP ailleurs dans l’interface utilisateur de l’application.
|
| UI_OWNERSHIP_COPY | Si UI_OWNERSHIP_COPY est spécifié comme valeur d’options, l’application hôte possède le HBITMAP et peut référencer le même HBITMAP pour une utilisation ailleurs dans l’interface utilisateur.
Note Cette option place la responsabilité de la publication du HBITMAP sur l’application hôte.
|
[out] image
Type : IUIImage**
Lorsque cette méthode retourne, contient l’adresse d’une variable de pointeur qui reçoit l’objet IUIImage .
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Cette méthode de fabrique est utile lorsqu’une application génère dynamiquement une ressource d’image et souhaite transmettre le nouveau HBITMAP au ruban, par exemple, en chargeant un graphique réseau portable (PNG) via le composant WIC (Windows Imaging Component) ou en utilisant CreateDIBSection pour créer une image pour un nouveau style dans une galerie de styles.
Cette méthode est également utile pour les applications qui nécessitent une image bitmap préexistante qui n’a pas été rendue obsolète par le ruban, par exemple, une bande d’image de barre d’outils héritée.
Spécifiez UI_OWNERSHIP_COPY comme valeur pour les options si le ruban est implémenté dans une application existante et que des modifications de code minimales sont requises. Cette méthode utilise de la mémoire supplémentaire pour l’image supplémentaire.
Spécifiez UI_OWNERSHIP_TRANSFER comme valeur pour les options afin de réduire l’utilisation de la mémoire.
Configuration requise
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | uiribbon.h |
| DLL | Mshtml.dll |