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 | Horizontalement miroir toutes les images de barre d’outils. |
| CMFCToolBarImages ::MirrorBitmap | Horizontalement miroir 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 | Mises à 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
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 de miroir horizontale.
BOOL Mirror();
Valeur de retour
TRUE si les images ont été correctement miroir ed ; 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 de miroir horizontale.
static BOOL MirrorBitmap(
HBITMAP& hbmp,
int cxImage);
Paramètres
hbmp
[in, out] Handle de bitmap pour miroir.
cxImage
[in] Largeur de l’image en pixels.
Valeur de retour
TRUE si l’image a été correctement miroir ed ; 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
Mises à 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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour