Partager via


CMFCToolBarImages, classe

Images d’une barre d’outils. La CMFCToolBarImages classe gère les images de barre d’outils chargées à partir de ressources d’application ou à partir de fichiers. Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

Syntaxe

class CMFCToolBarImages : public CObject

Membres

Constructeurs publics

Nom Description
CMFCToolBarImages ::CMFCToolBarImages Construit un objet CMFCToolBarImages.

Méthodes publiques

Nom Description
CMFCToolBarImages ::AdaptColors
CMFCToolBarImages ::AddIcon Ajoute une icône aux images de barre d’outils.
CMFCToolBarImages ::AddImage Ajoute une bitmap aux images de barre d’outils.
CMFCToolBarImages ::CleanUp
CMFCToolBarImages ::Clear Libère les ressources système qui ont été allouées à cet objet.
CMFCToolBarImages ::ConvertTo32Bits Convertit les bitmaps soulignées en images 32 bpp.
CMFCToolBarImages ::CopyImageToClipboard
CMFCToolBarImages ::CopyTo
CMFCToolBarImages ::CreateFromImageList Initialise les images de barre d’outils à partir d’une liste d’images ( classe CImageList).
CMFCToolBarImages ::CreateRegionFromImage
CMFCToolBarImages ::D eleteImage Supprime l’image qui a un index spécifié dans les images de barre d’outils si cet ensemble d’images de barre d’outils contient des images définies par l’utilisateur.
CMFCToolBarImages ::D raw Dessine une image de barre d’outils unique (bouton).
CMFCToolBarImages ::D rawEx
CMFCToolBarImages ::EnableRTL
CMFCToolBarImages ::EndDrawImage Libère les ressources système une fois qu’une image de barre d’outils est dessinée.
CMFCToolBarImages ::ExtractIcon Retourne l’icône qui a un index d’image spécifié à partir des images de la barre d’outils.
CMFCToolBarImages ::FillDitheredRect Remplit un rectangle à l’aide d’un pinceau qui a les couleurs d’arrière-plan de la barre d’outils.
CMFCToolBarImages ::GetAlwaysLight
CMFCToolBarImages ::GetBitsPerPixel Retourne la résolution actuelle des images soulignées.
CMFCToolBarImages ::GetCount Retourne le nombre d’images dans la barre d’outils.
CMFCToolBarImages ::GetDisabledImageAlpha Retourne la valeur du canal alpha utilisée pour les images désactivées.
CMFCToolBarImages ::GetFadedImageAlpha
CMFCToolBarImages ::GetImageSize Récupère la taille des images de barre d’outils stockées en mémoire (taille source) ou la taille des images de barre d’outils dessinées sur l’écran (taille de destination).
CMFCToolBarImages ::GetImageWell Retourne le handle à l’image bitmap qui contient toutes les images de barre d’outils.
CMFCToolBarImages ::GetImageWellLight
CMFCToolBarImages ::GetLastImageRect
CMFCToolBarImages ::GetLightPercentage
CMFCToolBarImages ::GetMapTo3DColors
CMFCToolBarImages ::GetMask
CMFCToolBarImages ::GetResourceOffset Retourne l’index d’image pour un ID de ressource spécifié.
CMFCToolBarImages ::GetScale Retourne le ratio d’échelle actuel des images soulignées.
CMFCToolBarImages ::GetTransparentColor
CMFCToolBarImages ::GrayImages Grise les images de barre d’outils pour les rendre désactivées.
CMFCToolBarImages ::Is32BitTransparencySupported Détermine si le système d’exploitation prend en charge la fusion alpha 32 bits.
CMFCToolBarImages ::IsPreMultiplyAutoCheck
CMFCToolBarImages ::IsRTL Détermine si la prise en charge de droite à gauche (RTL) est activée.
CMFCToolBarImages ::IsReadOnly Détermine si les images de barre d’outils sont en lecture seule.
CMFCToolBarImages ::IsScaled Indique si les images soulignées sont mises à l’échelle ou non.
CMFCToolBarImages ::IsUserImagesList Détermine si cet ensemble d’images de barre d’outils contient des images définies par l’utilisateur.
CMFCToolBarImages ::IsValid Détermine si cet ensemble d’images de barre d’outils contient une image de barre d’outils valide.
CMFCToolBarImages ::Load Charge des images de barre d’outils à partir de ressources système ou à partir d’un fichier.
CMFCToolBarImages ::LoadStr
CMFCToolBarImages ::MapFromSysColor
CMFCToolBarImages ::MapTo3dColors
CMFCToolBarImages ::MapToSysColor
CMFCToolBarImages ::MapToSysColorAlpha
CMFCToolBarImages ::Mirror Reflète horizontalement toutes les images de barre d’outils.
CMFCToolBarImages ::MirrorBitmap Reflète horizontalement une bitmap.
CMFCToolBarImages ::MirrorBitmapVert
CMFCToolBarImages ::MirrorVert
CMFCToolBarImages ::OnSysColorChange
CMFCToolBarImages ::P repareDrawImage Alloue les ressources requises pour dessiner une image de barre d’outils à une taille spécifiée.
CMFCToolBarImages ::Save Stocke les images de barre d’outils dans un fichier si cet ensemble d’images de barre d’outils contient des images définies par l’utilisateur.
CMFCToolBarImages ::SetAlwaysLight
CMFCToolBarImages ::SetDisabledImageAlpha Définit la valeur du canal alpha utilisée pour les images désactivées.
CMFCToolBarImages ::SetFadedImageAlpha
CMFCToolBarImages ::SetImageSize Définit la taille d’une image de barre d’outils (taille source).
CMFCToolBarImages ::SetLightPercentage
CMFCToolBarImages ::SetMapTo3DColors
CMFCToolBarImages ::SetPreMultiplyAutoCheck
CMFCToolBarImages ::SetSingleImage
CMFCToolBarImages ::SetTransparentColor Définit la couleur transparente des images de barre d’outils.
CMFCToolBarImages ::SmoothResize Redimensionne en douceur les images soulignées.
CMFCToolBarImages ::UpdateImage Met à jour une image de barre d’outils définie par l’utilisateur à partir d’une bitmap.

Méthodes protégées

Nom Description
CMFCToolBarImages ::P reMultiplyAlpha

Données membres

Nom Description
CMFCToolBarImages ::m_bDisableTrueColorAlpha TRUE si la fusion alpha truecolor (couleur 32 bits) est désactivée.

Notes

La bitmap complète des images de barre d’outils gérées par CMFCToolbarImages une ou plusieurs petites images de barre d’outils (boutons) d’une taille fixe.

Exemple

L’exemple suivant montre comment configurer un CMFCToolBarImages objet à l’aide de différentes méthodes dans la CMFCToolBarImages classe. L’exemple montre comment définir la taille de l’image de barre d’outils, charger une image et définir la couleur transparente de l’image. Cet extrait de code fait partie de l’exemple de démonstration Visual Studio.

CMFCToolBarImages m_Image;
m_Image.SetImageSize(CSize(32, 32));
m_Image.Load(IDR_START);
m_Image.SetTransparentColor(RGB(255, 0, 255));

Hiérarchie d'héritage

CObject

CMFCToolBarImages

Spécifications

En-tête : afxtoolbarimages.h

CMFCToolBarImages ::AdaptColors

void AdaptColors(
    COLORREF clrBase,
    COLORREF clrTone);

Paramètres

[in] clrBase
[in] clrTone

Notes

CMFCToolBarImages ::AddIcon

Ajoute une icône à la liste des images de barre d’outils.

int AddIcon(
    HICON hIcon,
    BOOL bAlphaBlend=FALSE);

Paramètres

hIcon
[in] Handle à ajouter à l’icône.

bAlphaBlend
[in] TRUE si cette icône est utilisée avec le mélange alpha ; sinon FALSE.

Valeur de retour

Index de base zéro de l’image de barre d’outils qui a été ajoutée si la méthode réussit ; sinon -1.

CMFCToolBarImages ::AddImage

Ajoute une bitmap aux images de barre d’outils.

int AddImage(
    HBITMAP hbmp,
    BOOL bSetBitPerPixel=FALSE);

int AddImage(
    const CMFCToolBarImages& imageList,
    int nIndex);

Paramètres

hbmp
[in] Handle de l’image bitmap à ajouter.

bSetBitPerPixel
[in] TRUE si l’objet CMFCToolBarImages utilise la profondeur de couleur (bits par pixel) de la nouvelle image ; FALSE si l’objet CMFCToolbarImages conserve la profondeur de couleur actuelle.

imageList
[in] Référence à un CMFCToolbarImages objet qui contient l’image à ajouter.

nIndex
[in] Index dans l’objet source CMFCToolbarImages de l’image à ajouter.

Valeur de retour

Nombre d’images de barre d’outils conservées par l’objet CMFCToolBarImages après l’ajout de la nouvelle bitmap ; -1 si l’opération a échoué.

CMFCToolBarImages ::CleanUp

static void __stdcall CleanUp();

Notes

CMFCToolBarImages ::Clear

Libère les ressources système allouées par l’objet CMFCToolbarImages .

void Clear();

CMFCToolBarImages ::CMFCToolBarImages

Construit un objet CMFCToolBarImages.

CMFCToolBarImages();

Notes

Construit un CMFCToolBarImages objet, initialise son moteur de rendu et définit la taille de l’image sur sa valeur par défaut 16 x 15 pixels. Utilisez CMFCToolBarImages ::SetImageSize pour modifier la taille de l’image avant d’ajouter des images.

CMFCToolBarImages ::CopyImageToClipboard

BOOL CopyImageToClipboard(int iImage);

Paramètres

[in] iImage

Valeur de retour

Notes

CMFCToolBarImages ::CopyTo

BOOL CopyTo(CMFCToolBarImages& imageList);

Paramètres

[in] imageList

Valeur de retour

Notes

CMFCToolBarImages ::CreateFromImageList

Initialise les images de barre d’outils à partir d’un objet de classe CImageList.

BOOL CreateFromImageList(const CImageList& imageList);

Paramètres

imageList
[in] Liste d’images à utiliser comme source pour les images de barre d’outils.

Valeur de retour

Retourne toujours TRUE.

Notes

Utilisez cette fonction pour initialiser rapidement la liste des images de barre d’outils à partir d’une liste d’images externes.

CMFCToolBarImages ::CreateRegionFromImage

static HRGN __stdcall CreateRegionFromImage(
    HBITMAP bmp,
    COLORREF clrTransparent);

Paramètres

[in] Bmp
[in] clrTransparent

Valeur de retour

Notes

CMFCToolBarImages ::D eleteImage

Supprime l’image définie par l’utilisateur qui a un index spécifié dans les images de barre d’outils.

BOOL DeleteImage(int iImage);

Paramètres

iImage
[in] Spécifie l’index de base zéro de l’image à supprimer.

Valeur de retour

TRUE si l’image a été supprimée avec succès ; FALSE si l’index d’image n’est pas valide, l’objet CMFCToolbarImages est temporaire, l’objet ne contient pas d’images définies par l’utilisateur CMFCToolbarImages ou si une autre erreur s’est produite.

CMFCToolBarImages ::D raw

Dessine une seule image de barre d’outils.

BOOL Draw(
    CDC* pDC,
    int x,
    int y,
    int iImageIndex,
    BOOL bHilite=FALSE,
    BOOL bDisabled=FALSE,
    BOOL bIndeterminate=FALSE,
    BOOL bShadow=FALSE,
    BOOL bInactive=FALSE,
    BYTE alphaSrc=255);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

x
[in] Coordonnée X du côté gauche du rectangle où l’image doit être dessinée.

y
[in] Coordonnée Y du haut du rectangle où l’image doit être dessinée.

iImageIndex
[in] Index de base zéro de l’image à afficher.

bHilite
[in] TRUE si l’image doit être mise en surbrillance ; sinon FALSE.

bDisabled
[in] TRUE si l’image doit être dessinée dans le style désactivé ; sinon FALSE.

bIndeterminer
[in] TRUE si l’image doit être dessinée dans le style d’état indéterminé ; sinon FALSE.

bShadow
[in] TRUE si l’image doit être dessinée avec une ombre portée ; sinon FALSE.

bInactive
[in] TRUE si l’image doit être dessinée dans le style d’état inactif ; sinon FALSE.

alphaSrc
[in] Valeur de canal alpha (opacité). La valeur 255 signifie que l’image est dessinée opaque. La valeur 0 signifie que l’image est dessinée transparente. Cette valeur est utilisée uniquement pour les images de couleur 32 bits et pour les images qui ont affiché un style de verre Windows Vista.

Valeur de retour

TRUE si l’image spécifiée a été affichée avec succès ; FALSE si l’index d’image n’était pas valide ou si une autre erreur s’est produite.

CMFCToolBarImages ::D rawEx

BOOL DrawEx(
    CDC* pDC,
    CRect rect,
    int iImageIndex,
    ImageAlignHorz horzAlign = ImageAlignHorzLeft,
    ImageAlignVert vertAlign = ImageAlignVertTop,
    CRect rectSrc = CRect(0, 0, 0, 0),
    BYTE alphaSrc = 255);

Paramètres

[in] pDC
[in] rect
[in] iImageIndex
[in] horzAlign
[in] vertAlign
[in] rectSrc
[in] alphaSrc

Valeur de retour

Notes

CMFCToolBarImages ::EnableRTL

static void __stdcall EnableRTL(BOOL bIsRTL = TRUE);

Paramètres

[in] bIsRTL

Notes

CMFCToolBarImages ::EndDrawImage

Libère les ressources système que CMFCToolBarImages ::P repareDrawImage allouées après avoir dessiné une image de barre d’outils en appelant CMFCToolBarImages ::D raw.

void EndDrawImage(CAfxDrawState& ds);

Paramètres

Ds
[in] Référence à l’objet CAfxDrawState passé à la PrepareDrawImage méthode.

CMFCToolBarImages ::ExtractIcon

Retourne l’icône qui a un index d’image spécifié à partir des images de la barre d’outils.

HICON ExtractIcon(int nIndex);

Paramètres

nIndex
[in] Index de base zéro dans la liste d’images à laquelle l’image à extraire en tant qu’icône se trouve.

Valeur de retour

Handle vers l’icône extraite ou NULL si nIndex est hors limites.

CMFCToolBarImages ::FillDitheredRect

Remplit un rectangle avec les couleurs d’arrière-plan de la barre d’outils.

static void FillDitheredRect(
    CDC* pDC,
    const CRect& rect);

Paramètres

pDC
[in] Pointeur vers un contexte d’appareil.

rect
[in] Coordonnées d’un rectangle à remplir.

Notes

Utilisez cette méthode pour remplir un rectangle avec une couleur qui correspond à la moyenne des couleurs système COLOR_BTNFACE et COLOR_BTNHIGHLIGHT. Si le système utilise 256 couleurs ou moins, le rectangle est rempli d’un motif dither de ces deux couleurs à la place.

CMFCToolBarImages ::GetAlwaysLight

BOOL GetAlwaysLight() const;

Valeur de retour

Notes

CMFCToolBarImages ::GetCount

Retourne le nombre d’images dans la liste des images de barre d’outils.

int GetCount() const;

Valeur de retour

Nombre d’images dans l’objet CMFCToolBarImages .

CMFCToolBarImages ::GetDisabledImageAlpha

Retourne la valeur de canal alpha (opacité) utilisée pour les images désactivées.

static BYTE GetDisabledImageAlpha();

Valeur de retour

Valeur actuelle du canal alpha.

Notes

Vous pouvez appeler CMFCToolBarImages ::SetDisabledImageAlpha pour modifier la valeur du canal alpha.

CMFCToolBarImages ::GetFadedImageAlpha

static BYTE __stdcall GetFadedImageAlpha();

Valeur de retour

Notes

CMFCToolBarImages ::GetImageSize

Récupère la taille des images de barre d’outils stockées en mémoire (taille source) ou la taille des images de barre d’outils dessinées sur l’écran (taille de destination).

SIZE GetImageSize(BOOL bDest=FALSE) const;

Paramètres

bDest
[in] TRUE pour récupérer la taille de destination ; FALSE pour récupérer la taille de l’image source.

Valeur de retour

Structure SIZE , qui spécifie la taille d’une image en pixels.

Notes

La taille de l’image source est la taille des images stockées dans l’objet CMFCToolbarImages . Vous pouvez appeler CMFCToolBarImages ::SetImageSize pour définir la taille de la source. La valeur par défaut est de 16 x 15 pixels.

Par défaut, la taille de l’image de destination est 0x0. Vous spécifiez la taille de destination lorsque vous appelez CMFCToolBarImages ::P repareDrawImage. La méthode CMFCToolBarImages ::EndDrawImage réinitialise la taille de destination à la valeur par défaut.

CMFCToolBarImages ::GetImageWell

Retourne le handle à l’image bitmap qui contient toutes les images de barre d’outils.

HBITMAP GetImageWell() const;

Valeur de retour

Handle vers une bitmap qui contient des images de barre d’outils.

Notes

Les images de barre d’outils sont stockées dans une ligne dans une seule bitmap connue sous le nom d’image. Pour rechercher une image de barre d’outils dans l’image, multipliez l’index de l’image par la largeur des images de barre d’outils (voir CMFCToolBarImages ::GetImageSize) pour obtenir le décalage horizontal de l’image à l’intérieur de l’image.

CMFCToolBarImages ::GetImageWellLight

HBITMAP GetImageWellLight() const;

Valeur de retour

Notes

CMFCToolBarImages ::GetLastImageRect

CRect GetLastImageRect() const;

Valeur de retour

Notes

CMFCToolBarImages ::GetLightPercentage

int GetLightPercentage() const;

Valeur de retour

Notes

CMFCToolBarImages ::GetMapTo3DColors

BOOL GetMapTo3DColors() const;

Valeur de retour

Notes

CMFCToolBarImages ::GetMask

HBITMAP GetMask(int iImage);

Paramètres

[in] iImage

Valeur de retour

Notes

CMFCToolBarImages ::GetResourceOffset

Retourne l’index d’image pour un ID de ressource spécifié.

int GetResourceOffset(UINT uiResId) const;

Paramètres

uiResId
[in] ID de ressource d’image.

Valeur de retour

Index d’image si la méthode a réussi ; -1 si l’image avec l’ID de ressource spécifié n’existe pas.

CMFCToolBarImages ::GetTransparentColor

COLORREF GetTransparentColor() const;

Valeur de retour

Notes

CMFCToolBarImages ::GrayImages

Grise les images de barre d’outils pour les rendre désactivées.

BOOL GrayImages(int nGrayImageLuminancePercentage);

Paramètres

nGrayImageLuminancePercentage
[in] Pourcentage de luminance.

Valeur de retour

TRUE si les images de la collection ont été grisées avec succès ; sinon FALSE.

Notes

Cette méthode modifie les images de barre d’outils en moyenne les composants rouge, vert et bleu de chaque pixel et en multipliant le résultat par nGrayImageLuminancePercentage divisé par 100. Si nGrayImageLuminancePercentage est égal à zéro ou négatif, la valeur par défaut de 130 est utilisée à la place.

Remarque

Si vous souhaitez annuler la modification, vous devez recharger les images à partir de la source. Pour ce faire, appelez CMFCToolBarImages ::Load ou CMFCToolBarImages ::UpdateImage (uniquement pour les images définies par l’utilisateur), ou en appelant CMFCToolBarImages ::Clear et en ajoutant à nouveau les images en appelant CMFCToolBarImages ::AddIcon ou CMFCToolBarImages ::AddImages.

CMFCToolBarImages ::Is32BitTransparencySupported

Spécifie si le système d’exploitation prend en charge la fusion alpha 32 bits.

static BOOL Is32BitTransparencySupported();

Valeur de retour

TRUE si le mélange alpha 32 bits est pris en charge ; sinon FALSE.

Notes

Utilisez cette méthode statique pour déterminer au moment de l’exécution si le système d’exploitation prend en charge la fusion alpha 32 bits. Cette fonctionnalité est prise en charge sur Windows 2000 et versions ultérieures.

CMFCToolBarImages ::IsPreMultiplyAutoCheck

BOOL IsPreMultiplyAutoCheck() const;

Valeur de retour

Notes

CMFCToolBarImages ::IsReadOnly

Spécifie si les images de barre d’outils sont en lecture seule.

BOOL IsReadOnly() const;

Valeur de retour

TRUE si les images de barre d’outils sont en lecture seule, sinon FALSE.

Notes

L’objet CMFCToolbarImages est en lecture seule lorsque la bitmap avec des images de barre d’outils a été chargée à partir d’un fichier en lecture seule ou lorsque la bitmap a été copiée à l’aide de la CMFCToolBarImages::CopyTemp méthode.

CMFCToolBarImages ::IsRTL

Spécifie si la prise en charge de droite à gauche (RTL) est activée.

static BOOL IsRTL();

Valeur de retour

TRUE si la prise en charge de RTL est activée ; sinon FALSE.

Notes

La prise en charge de RTL est utilisée lorsque l’application est localisée dans une langue qui est lue de droite à gauche, telle que l’arabe, l’hébreu, le persan ou l’Urdu.

CMFCToolBarImages ::IsUserImagesList

Spécifie si cet ensemble d’images de barre d’outils contient des images définies par l’utilisateur.

BOOL IsUserImagesList() const;

Valeur de retour

TRUE si l’objet contient des images de barre d’outils définies par l’utilisateur CMFCToolBarImages ; sinon FALSE.

CMFCToolBarImages ::IsValid

Indique si cet ensemble d’images de barre d’outils contient une image de barre d’outils valide.

BOOL IsValid() const;

Valeur de retour

TRUE si un CMFCToolBarImages objet est valide ; sinon FALSE.

Notes

L’objet CMFCToolBarImages n’est pas valide quand son handle vers une bitmap avec des images de barre d’outils a la valeur NULL.

CMFCToolBarImages ::Load

Charge des images de barre d’outils à partir de ressources système ou à partir d’un fichier.

BOOL Load(
    UINT uiResID,
    HINSTANCE hinstRes=NULL,
    BOOL bAdd=FALSE);

BOOL Load(
    LPCTSTR lpszBmpFileName,
    DWORD nMaxFileSize = 819200);

Paramètres

uiResID
[in] ID d’une ressource bitmap.

hinstRes
[in] Instance de la DLL de ressource.

bAdd
[in] TRUE pour ajouter la bitmap chargée à la bitmap existante, ou FALSE pour remplacer la bitmap existante.

lpszBmpFileName
[in] Chemin d’accès à un fichier disque à partir duquel charger la bitmap.

nMaxFileSize
[in] Nombre maximal d’octets dans le fichier bitmap ; ou 0 pour charger la bitmap, quelle que soit la taille du fichier. Si la taille du fichier dépasse cette taille maximale, la méthode retourne FALSE et ne charge pas la bitmap.

Valeur de retour

TRUE si la bitmap a été chargée avec succès ; sinon FALSE.

Notes

Si le fichier a l’attribut en lecture seule, la liste d’images est marquée en lecture seule.

CMFCToolBarImages ::LoadStr

BOOL LoadStr(
    LPCTSTR lpszResourceName,
    HINSTANCE hinstRes = NULL,
    BOOL bAdd = FALSE);

Paramètres

[in] lpszResourceName
[in] hinstRes
[in] bAdd

Valeur de retour

Notes

CMFCToolBarImages ::MapFromSysColor

static COLORREF __stdcall MapFromSysColor(
    COLORREF color,
    BOOL bUseRGBQUAD = TRUE);

Paramètres

[in] Couleur
[in] bUseRGBQUAD

Valeur de retour

Notes

CMFCToolBarImages ::MapTo3dColors

BOOL MapTo3dColors(
    BOOL bUseRGBQUAD = TRUE,
    COLORREF clrSrc = (COLORREF)-1,
    COLORREF clrDest = (COLORREF)-1);

Paramètres

[in] bUseRGBQUAD
[in] clrSrc
[in] clrDest

Valeur de retour

Notes

CMFCToolBarImages ::MapToSysColor

static COLORREF __stdcall MapToSysColor(
    COLORREF color,
    BOOL bUseRGBQUAD = TRUE);

Paramètres

[in] Couleur
[in] bUseRGBQUAD

Valeur de retour

Notes

CMFCToolBarImages ::MapToSysColorAlpha

static COLORREF __stdcall MapToSysColorAlpha(COLORREF color);

Paramètres

[in] Couleur

Valeur de retour

Notes

CMFCToolBarImages ::Mirror

Remplace les images de barre d’outils par leur image miroir horizontale.

BOOL Mirror();

Valeur de retour

TRUE si les images ont été correctement mises en miroir ; sinon FALSE.

Notes

Cette méthode est utilisée pour prendre en charge les systèmes d’écriture de droite à gauche.

CMFCToolBarImages ::MirrorBitmap

Remplace une bitmap par son image miroir horizontale.

static BOOL MirrorBitmap(
    HBITMAP& hbmp,
    int cxImage);

Paramètres

hbmp
[in, out] Handle de bitmap à mettre en miroir.

cxImage
[in] Largeur de l’image en pixels.

Valeur de retour

TRUE si l’image a été correctement mise en miroir ; sinon FALSE.

Notes

Cette fonction est utilisée pour prendre en charge les systèmes d’écriture de droite à gauche.

CMFCToolBarImages ::MirrorBitmapVert

static BOOL __stdcall MirrorBitmapVert(
    HBITMAP& hbmp,
    int cyImage);

Paramètres

[in] hbmp
[in] cyImage

Valeur de retour

Notes

CMFCToolBarImages ::MirrorVert

BOOL MirrorVert();

Valeur de retour

Notes

CMFCToolBarImages ::OnSysColorChange

void OnSysColorChange();

Notes

CMFCToolBarImages ::P reMultiplyAlpha

static BOOL __stdcall PreMultiplyAlpha(
    HBITMAP hbmp,
    BOOL bAutoCheckPremlt);

BOOL PreMultiplyAlpha(HBITMAP hbmp);

Paramètres

[in] hbmp
[in] bAutoCheckPremlt

Valeur de retour

Notes

CMFCToolBarImages ::m_bDisableTrueColorAlpha

TRUE si la fusion alpha truecolor (couleur 32 bits) est désactivée.

static BOOL m_bDisableTrueColorAlpha;

Notes

Définissez cette variable membre sur FALSE pour activer la fusion alphacolore truecolor pour les images de barre d’outils.

La valeur par défaut est TRUE pour la compatibilité descendante.

CMFCToolBarImages ::P repareDrawImage

Alloue les ressources requises pour dessiner une image de barre d’outils à une taille spécifiée.

BOOL PrepareDrawImage(
    CAfxDrawState& ds,
    CSize sizeImageDest=CSize(0,
    0)
    BOOL bFadeInactive=FALSE);

Paramètres

Ds
[in] Référence à la CAfxDrawState structure, qui stocke les ressources allouées entre les étapes de rendu d’image.

sizeImageDest
[in] Spécifie la taille d’une image de destination.

bFadeInactive
[in] TRUE si vous souhaitez que les images inactives soient dessinées à la mode.

Valeur de retour

TRUE si les ressources requises pour dessiner l’image de barre d’outils ont été allouées correctement, sinon FALSE.

Notes

Après avoir appelé cette méthode, vous pouvez appeler CMFCToolBarImages ::D raw n’importe quel nombre de fois. Une fois le dessin terminé, vous devez appeler CMFCToolBarImages ::EndDrawImage pour libérer les ressources allouées par PrepareDrawImage.

CMFCToolBarImages ::Save

Stocke les images de barre d’outils dans un fichier si cet ensemble d’images de barre d’outils contient des images définies par l’utilisateur.

BOOL Save(LPCTSTR lpszBmpFileName=NULL);

Paramètres

lpszBmpFileName
Chemin d’accès à un fichier de disque.

Valeur de retour

TRUE si les images de barre d’outils ont été enregistrées avec succès ; sinon FALSE.

Notes

Appelez cette méthode pour stocker les images définies par l’utilisateur dans un fichier de disque. Si lpszBmpFileName a la valeur NULL, la méthode stocke la bitmap dans le fichier à partir duquel la bitmap a été chargée par la méthode CMFCToolBarImages ::Load .

CMFCToolBarImages ::SetAlwaysLight

void SetAlwaysLight(BOOL bAlwaysLight = TRUE);

Paramètres

[in] bAlwaysLight

Notes

CMFCToolBarImages ::SetDisabledImageAlpha

Définit la valeur du canal alpha (opacité) utilisée pour les images désactivées.

static void SetDisabledImageAlpha(BYTE nValue);

Paramètres

nValue
[in] Nouvelle valeur du canal alpha.

Notes

Utilisez cette méthode pour définir une valeur alpha personnalisée pour les images désactivées. La valeur par défaut est 127, ce qui entraîne la semi-transparente des images de bouton désactivées. Si vous définissez une valeur de 0, les images désactivées sont complètement transparentes. Si vous définissez une valeur de 255, les images désactivées sont complètement opaques.

CMFCToolBarImages ::SetFadedImageAlpha

static void __stdcall SetFadedImageAlpha(BYTE nValue);

Paramètres

[in] nValue

Notes

CMFCToolBarImages ::SetImageSize

Définit la taille de chaque image de barre d’outils (taille source).

void SetImageSize(
    SIZE sizeImage,
    BOOL bUpdateCount=FALSE);

Paramètres

sizeImage
[in] Nouvelle taille des images de barre d’outils.

Notes

Par défaut, la taille de l’image de barre d’outils est de 16 x 15 pixels. Appelez cette méthode si vous souhaitez utiliser des images de barre d’outils d’une taille différente.

CMFCToolBarImages ::SetLightPercentage

void SetLightPercentage(int nValue);

Paramètres

[in] nValue

Notes

CMFCToolBarImages ::SetMapTo3DColors

void SetMapTo3DColors(BOOL bMapTo3DColors);

Paramètres

[in] bMapTo3DColors

Notes

CMFCToolBarImages ::SetPreMultiplyAutoCheck

void SetPreMultiplyAutoCheck(BOOL bAuto = TRUE);

Paramètres

[in] bAuto

Notes

CMFCToolBarImages ::SetSingleImage

void SetSingleImage();

Notes

CMFCToolBarImages ::SetTransparentColor

Définit la couleur transparente des images de barre d’outils.

COLORREF SetTransparentColor(COLORREF clrTransparent);

Paramètres

clrTransparent
[in] Valeur RVB.

Valeur de retour

Couleur transparente précédente.

Notes

Lorsque vous ou l’infrastructure appelez CMFCToolBarImages ::D raw, la méthode ne dessine aucun pixel qui correspond à la couleur spécifiée par clrTransparent.

CMFCToolBarImages ::UpdateImage

Met à jour une image de barre d’outils définie par l’utilisateur à partir d’une bitmap.

BOOL UpdateImage(
    int iImage,
    HBITMAP hbmp);

Paramètres

iImage
[in] Index de base zéro de l’image à mettre à jour.

hbmp
[in] Handle vers la bitmap à partir de laquelle mettre à jour l’image.

Valeur de retour

TRUE si l’image a été mise à jour avec succès ; FALSE si la liste d’images n’est pas définie par l’utilisateur ou temporaire.

CMFCToolBarImages ::ConvertTo32Bits

Convertit les bitmaps soulignées en images 32 bpp.

BOOL ConvertTo32Bits(COLORREF clrTransparent = (COLORREF)-1);

Paramètres

clrTransparent
Spécifie la couleur transparente des bitmaps soulignées.

Notes

CMFCToolBarImages ::GetBitsPerPixel

Retourne la résolution actuelle des images soulignées.

int GetBitsPerPixel() const;

Valeur de retour

Valeur entière représentant la résolution actuelle des images soulignées, en bits par pixel (bpp).

Notes

CMFCToolBarImages ::GetScale

Retourne le rapport d’échelle actuel des images soulignées.

double GetScale() const;

Valeur de retour

Valeur représentant le ratio d’échelle actuel.

Notes

CMFCToolBarImages ::IsScaled

Indique si les images soulignées sont mises à l’échelle ou non.

BOOL IsScaled () const;

Valeur de retour

TRUE si les images soulignées sont mises à l’échelle ; sinon FALSE.

Notes

CMFCToolBarImages ::SmoothResize

Redimensionne en douceur les images soulignées.

BOOL SmoothResize(double dblImageScale);

Paramètres

dblImageScale
Rapport d’échelle.

Valeur de retour

TRUE si le redimensionnement réussit ; sinon FALSE.

Notes

Voir aussi

Graphique hiérarchique
Classes
CObject, classe
CMFCToolBar, classe
CMFCToolBarButton, classe