Classe CMFCToolBarImages

Immagini su una barra degli strumenti. La CMFCToolBarImages classe gestisce le immagini della barra degli strumenti caricate dalle risorse dell'applicazione o dai file. Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

Sintassi

class CMFCToolBarImages : public CObject

Membri

Costruttori pubblici

Nome Descrizione
CMFCToolBarImages::CMFCToolBarImages Costruisce un oggetto CMFCToolBarImages.

Metodi pubblici

Nome Descrizione
CMFCToolBarImages::AdaptColors
CMFCToolBarImages::AddIcon Aggiunge un'icona alle immagini della barra degli strumenti.
CMFCToolBarImages::AddImage Aggiunge una bitmap alle immagini della barra degli strumenti.
CMFCToolBarImages::CleanUp
CMFCToolBarImages::Clear Libera le risorse di sistema allocate a questo oggetto.
CMFCToolBarImages::ConvertTo32Bits Converte le bitmap sottolineate in 32 immagini bpp.
CMFCToolBarImages::CopyImageToClipboard
CMFCToolBarImages::CopyTo
CMFCToolBarImages::CreateFromImageList Inizializza le immagini della barra degli strumenti da un elenco di immagini ( classe CImageList).
CMFCToolBarImages::CreateRegionFromImage
CMFCToolBarImages::D eleteImage Elimina l'immagine con un indice specificato dalle immagini della barra degli strumenti se questo set di immagini della barra degli strumenti contiene immagini definite dall'utente.
CMFCToolBarImages::D raw Disegna una singola immagine della barra degli strumenti (pulsante).
CMFCToolBarImages::D rawEx
CMFCToolBarImages::EnableRTL
CMFCToolBarImages::EndDrawImage Libera le risorse di sistema dopo che viene disegnata un'immagine della barra degli strumenti.
CMFCToolBarImages::ExtractIcon Restituisce l'icona con un indice di immagine specificato dalle immagini della barra degli strumenti.
CMFCToolBarImages::FillDitheredRect Riempie un rettangolo utilizzando un pennello con i colori di sfondo della barra degli strumenti.
CMFCToolBarImages::GetAlwaysLight
CMFCToolBarImages::GetBitsPerPixel Restituisce la risoluzione corrente delle immagini sottolineate.
CMFCToolBarImages::GetCount Restituisce il numero di immagini sulla barra degli strumenti.
CMFCToolBarImages::GetDisabledImageAlpha Restituisce il valore del canale alfa utilizzato per le immagini disabilitate.
CMFCToolBarImages::GetFadedImageAlpha
CMFCToolBarImages::GetImageSize Recupera le dimensioni delle immagini della barra degli strumenti archiviate in memoria (dimensioni di origine) o le dimensioni delle immagini della barra degli strumenti disegnate sullo schermo (dimensioni di destinazione).
CMFCToolBarImages::GetImageWell Restituisce l'handle alla bitmap che contiene tutte le immagini della barra degli strumenti.
CMFCToolBarImages::GetImageWellLight
CMFCToolBarImages::GetLastImageRect
CMFCToolBarImages::GetLightPercentage
CMFCToolBarImages::GetMapTo3DColors
CMFCToolBarImages::GetMask
CMFCToolBarImages::GetResourceOffset Restituisce l'indice dell'immagine per un ID risorsa specificato.
CMFCToolBarImages::GetScale Restituisce il rapporto di scala corrente delle immagini sottolineate.
CMFCToolBarImages::GetTransparentColor
CMFCToolBarImages::GrayImages Grigia le immagini della barra degli strumenti per renderle disabilitate.
CMFCToolBarImages::Is32BitTransparencySupported Determina se il sistema operativo supporta la fusione alfa a 32 bit.
CMFCToolBarImages::IsPreMultiplyAutoCheck
CMFCToolBarImages::IsRTL Determina se il supporto da destra a sinistra (RTL) è abilitato.
CMFCToolBarImages::IsReadOnly Determina se le immagini della barra degli strumenti sono di sola lettura.
CMFCToolBarImages::IsScaled Indica se le immagini sottolineate vengono ridimensionate o meno.
CMFCToolBarImages::IsUserImagesList Determina se questo set di immagini della barra degli strumenti contiene immagini definite dall'utente.
CMFCToolBarImages::IsValid Determina se questo set di immagini della barra degli strumenti contiene un'immagine valida della barra degli strumenti.
CMFCToolBarImages::Load Carica le immagini della barra degli strumenti dalle risorse di sistema o da un file.
CMFCToolBarImages::LoadStr
CMFCToolBarImages::MapFromSysColor
CMFCToolBarImages::MapTo3dColors
CMFCToolBarImages::MapToSysColor
CMFCToolBarImages::MapToSysColorAlpha
CMFCToolBarImages::Mirror Rispecchia orizzontalmente tutte le immagini della barra degli strumenti.
CMFCToolBarImages::MirrorBitmap Rispecchia orizzontalmente una bitmap.
CMFCToolBarImages::MirrorBitmapVert
CMFCToolBarImages::MirrorVert
CMFCToolBarImages::OnSysColorChange
CMFCToolBarImages::P repareDrawImage Alloca le risorse necessarie per disegnare un'immagine della barra degli strumenti a una dimensione specificata.
CMFCToolBarImages::Save Archivia le immagini della barra degli strumenti in un file se questo set di immagini della barra degli strumenti contiene immagini definite dall'utente.
CMFCToolBarImages::SetAlwaysLight
CMFCToolBarImages::SetDisabledImageAlpha Imposta il valore del canale alfa utilizzato per le immagini disabilitate.
CMFCToolBarImages::SetFadedImageAlpha
CMFCToolBarImages::SetImageSize Imposta le dimensioni di un'immagine della barra degli strumenti (dimensione di origine).
CMFCToolBarImages::SetLightPercentage
CMFCToolBarImages::SetMapTo3DColors
CMFCToolBarImages::SetPreMultiplyAutoCheck
CMFCToolBarImages::SetSingleImage
CMFCToolBarImages::SetTransparentColor Imposta il colore trasparente delle immagini della barra degli strumenti.
CMFCToolBarImages::SmoothResize Ridimensiona senza problemi le immagini sottolineate.
CMFCToolBarImages::UpdateImage Aggiorna un'immagine della barra degli strumenti definita dall'utente da una bitmap.

Metodi protetti

Nome Descrizione
CMFCToolBarImages::P reMultiplyAlpha

Membri dei dati

Nome Descrizione
CMFCToolBarImages::m_bDisableTrueColorAlpha TRUE se la fusione alfacolore true (colore a 32 bit) è disabilitata.

Osservazioni:

La bitmap completa delle immagini della barra degli strumenti gestite da è costituita da CMFCToolbarImages una o più immagini della barra degli strumenti di piccole dimensioni (pulsanti) di dimensioni fisse.

Esempio

Nell'esempio seguente viene illustrato come configurare un CMFCToolBarImages oggetto usando vari metodi nella CMFCToolBarImages classe . L'esempio mostra come impostare le dimensioni dell'immagine della barra degli strumenti, caricare un'immagine e impostare il colore trasparente dell'immagine. Questo frammento di codice fa parte dell'esempio demo di Visual Studio.

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

Gerarchia di ereditarietà

CObject

CMFCToolBarImages

Requisiti

Intestazione: afxtoolbarimages.h

CMFCToolBarImages::AdaptColors

void AdaptColors(
    COLORREF clrBase,
    COLORREF clrTone);

Parametri

[in] clrBase
[in] clrTone

Osservazioni:

CMFCToolBarImages::AddIcon

Aggiunge un'icona all'elenco di immagini della barra degli strumenti.

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

Parametri

hIcon
[in] Handle all'icona da aggiungere.

bAlphaBlend
[in] TRUE se questa icona viene utilizzata con la fusione alfa; in caso contrario FALSE.

Valore restituito

Indice in base zero dell'immagine della barra degli strumenti aggiunta se il metodo ha esito positivo; in caso contrario -1.

CMFCToolBarImages::AddImage

Aggiunge una bitmap alle immagini della barra degli strumenti.

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

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

Parametri

hbmp
[in] Handle della bitmap da aggiungere.

bSetBitPerPixel
[in] TRUE se l'oggetto CMFCToolBarImages utilizza la profondità del colore (bit per pixel) della nuova immagine; FALSE se l'oggetto CMFCToolbarImages mantiene la profondità del colore corrente.

imageList
[in] Riferimento a un CMFCToolbarImages oggetto contenente l'immagine da aggiungere.

nIndex
[in] Indice nell'oggetto di origine CMFCToolbarImages dell'immagine da aggiungere.

Valore restituito

Numero di immagini della barra degli strumenti conservate dall'oggetto dopo l'aggiunta CMFCToolBarImages della nuova bitmap. -1 se l'operazione non è riuscita.

CMFCToolBarImages::CleanUp

static void __stdcall CleanUp();

Osservazioni:

CMFCToolBarImages::Clear

Libera le risorse di sistema allocate dall'oggetto CMFCToolbarImages .

void Clear();

CMFCToolBarImages::CMFCToolBarImages

Costruisce un oggetto CMFCToolBarImages.

CMFCToolBarImages();

Osservazioni:

Costruisce un CMFCToolBarImages oggetto, inizializza il motore di rendering e imposta le dimensioni dell'immagine sul valore predefinito 16x15 pixel. Usare CMFCToolBarImages::SetImageSize per modificare le dimensioni dell'immagine prima di aggiungere immagini.

CMFCToolBarImages::CopyImageToClipboard

BOOL CopyImageToClipboard(int iImage);

Parametri

[in] iImage

Valore restituito

Osservazioni:

CMFCToolBarImages::CopyTo

BOOL CopyTo(CMFCToolBarImages& imageList);

Parametri

[in] imageList

Valore restituito

Osservazioni:

CMFCToolBarImages::CreateFromImageList

Inizializza le immagini della barra degli strumenti da un oggetto Classe CImageList.

BOOL CreateFromImageList(const CImageList& imageList);

Parametri

imageList
[in] Elenco di immagini da usare come origine per le immagini della barra degli strumenti.

Valore restituito

Restituisce sempre TRUE.

Osservazioni:

Usare questa funzione per inizializzare rapidamente l'elenco di immagini della barra degli strumenti da un elenco di immagini esterne.

CMFCToolBarImages::CreateRegionFromImage

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

Parametri

[in] Bmp
[in] clrTransparent

Valore restituito

Osservazioni:

CMFCToolBarImages::D eleteImage

Elimina l'immagine definita dall'utente con un indice specificato dalle immagini della barra degli strumenti.

BOOL DeleteImage(int iImage);

Parametri

iImage
[in] Specifica l'indice in base zero dell'immagine da eliminare.

Valore restituito

TRUE se l'immagine è stata eliminata correttamente; FALSE se l'indice dell'immagine non è valido, l'oggetto CMFCToolbarImages è temporaneo, l'oggetto CMFCToolbarImages non contiene immagini definite dall'utente o se si è verificato un altro errore.

CMFCToolBarImages::D raw

Disegna una singola immagine della barra degli strumenti.

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);

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

x
[in] Coordinata X del lato sinistro del rettangolo in cui deve essere disegnata l'immagine.

y
[in] Coordinata Y della parte superiore del rettangolo in cui deve essere disegnata l'immagine.

iImageIndex
[in] Indice in base zero dell'immagine da visualizzare.

bHilite
[in] TRUE se l'immagine deve essere evidenziata; in caso contrario FALSE.

bDisabled
[in] TRUE se l'immagine deve essere disegnata nello stile disabilitato; in caso contrario FALSE.

bIndeterminate
[in] TRUE se l'immagine deve essere disegnata nello stile di stato indeterminato; in caso contrario FALSE.

bShadow
[in] TRUE se l'immagine deve essere disegnata con un'ombreggiatura; in caso contrario FALSE.

bInactive
[in] TRUE se l'immagine deve essere disegnata nello stile di stato inattivo; in caso contrario FALSE.

alphaSrc
[in] Valore del canale alfa (opacità). Il valore 255 indica che l'immagine viene disegnata opaca. Il valore 0 indica che l'immagine viene disegnata trasparente. Questo valore viene usato solo per le immagini a colori a 32 bit e per le immagini che visualizzano uno stile di vetro di Windows Vista.

Valore restituito

TRUE se l'immagine specificata è stata visualizzata correttamente; FALSE se l'indice dell'immagine non è valido o si è verificato un altro errore.

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);

Parametri

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

Valore restituito

Osservazioni:

CMFCToolBarImages::EnableRTL

static void __stdcall EnableRTL(BOOL bIsRTL = TRUE);

Parametri

[in] bIsRTL

Osservazioni:

CMFCToolBarImages::EndDrawImage

Libera le risorse di sistema allocate da CMFCToolBarImages::P repareDrawImage dopo aver disegnato un'immagine della barra degli strumenti chiamando CMFCToolBarImages::D raw.

void EndDrawImage(CAfxDrawState& ds);

Parametri

Ds
[in] Riferimento all'oggetto CAfxDrawState passato al PrepareDrawImage metodo .

CMFCToolBarImages::ExtractIcon

Restituisce l'icona con un indice di immagine specificato dalle immagini della barra degli strumenti.

HICON ExtractIcon(int nIndex);

Parametri

nIndex
[in] Indice in base zero nell'elenco di immagini in corrispondenza del quale si trova l'immagine da estrarre come icona.

Valore restituito

Handle per l'icona estratta o NULL se nIndex non è compreso nell'intervallo.

CMFCToolBarImages::FillDitheredRect

Riempie un rettangolo con i colori di sfondo della barra degli strumenti.

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

Parametri

pDC
[in] Puntatore a un contesto di dispositivo.

rect
[in] Coordinate di un rettangolo da riempire.

Osservazioni:

Utilizzare questo metodo per riempire un rettangolo con un colore che corrisponde alla media dei colori di sistema COLOR_BTNFACE e COLOR_BTNHIGHLIGHT. Se il sistema usa 256 o meno colori, il rettangolo verrà riempito con un motivo dithering di questi due colori.

CMFCToolBarImages::GetAlwaysLight

BOOL GetAlwaysLight() const;

Valore restituito

Osservazioni:

CMFCToolBarImages::GetCount

Restituisce il numero di immagini nell'elenco delle immagini della barra degli strumenti.

int GetCount() const;

Valore restituito

Numero di immagini nell'oggetto CMFCToolBarImages .

CMFCToolBarImages::GetDisabledImageAlpha

Restituisce il valore del canale alfa (opacità) utilizzato per le immagini disabilitate.

static BYTE GetDisabledImageAlpha();

Valore restituito

Valore corrente del canale alfa.

Osservazioni:

È possibile chiamare CMFCToolBarImages::SetDisabledImageAlpha per modificare il valore del canale alfa.

CMFCToolBarImages::GetFadedImageAlpha

static BYTE __stdcall GetFadedImageAlpha();

Valore restituito

Osservazioni:

CMFCToolBarImages::GetImageSize

Recupera le dimensioni delle immagini della barra degli strumenti archiviate in memoria (dimensioni di origine) o le dimensioni delle immagini della barra degli strumenti disegnate sullo schermo (dimensioni di destinazione).

SIZE GetImageSize(BOOL bDest=FALSE) const;

Parametri

bDest
[in] TRUE per recuperare le dimensioni di destinazione; FALSE per recuperare le dimensioni dell'immagine di origine.

Valore restituito

Struttura SIZE , che specifica le dimensioni di un'immagine in pixel.

Osservazioni:

Le dimensioni dell'immagine di origine sono le dimensioni delle immagini archiviate nell'oggetto CMFCToolbarImages . È possibile chiamare CMFCToolBarImages::SetImageSize per impostare le dimensioni di origine. Il valore predefinito è 16x15 pixel.

Per impostazione predefinita, le dimensioni dell'immagine di destinazione sono 0x0. Specificare le dimensioni di destinazione quando si chiama CMFCToolBarImages::P repareDrawImage. Il metodo CMFCToolBarImages::EndDrawImage reimposta le dimensioni di destinazione sul valore predefinito.

CMFCToolBarImages::GetImageWell

Restituisce l'handle alla bitmap che contiene tutte le immagini della barra degli strumenti.

HBITMAP GetImageWell() const;

Valore restituito

Handle di una bitmap che contiene immagini della barra degli strumenti.

Osservazioni:

Le immagini della barra degli strumenti vengono archiviate in una riga in una singola bitmap nota come immagine. Per trovare un'immagine della barra degli strumenti nell'immagine, moltiplicare l'indice dell'immagine in base alla larghezza delle immagini della barra degli strumenti (vedere CMFCToolBarImages::GetImageSize) per ottenere l'offset orizzontale dell'immagine all'interno dell'immagine.

CMFCToolBarImages::GetImageWellLight

HBITMAP GetImageWellLight() const;

Valore restituito

Osservazioni:

CMFCToolBarImages::GetLastImageRect

CRect GetLastImageRect() const;

Valore restituito

Osservazioni:

CMFCToolBarImages::GetLightPercentage

int GetLightPercentage() const;

Valore restituito

Osservazioni:

CMFCToolBarImages::GetMapTo3DColors

BOOL GetMapTo3DColors() const;

Valore restituito

Osservazioni:

CMFCToolBarImages::GetMask

HBITMAP GetMask(int iImage);

Parametri

[in] iImage

Valore restituito

Osservazioni:

CMFCToolBarImages::GetResourceOffset

Restituisce l'indice dell'immagine per un ID risorsa specificato.

int GetResourceOffset(UINT uiResId) const;

Parametri

uiResId
[in] ID risorsa immagine.

Valore restituito

Indice dell'immagine se il metodo ha avuto esito positivo; -1 se l'immagine con l'ID risorsa specificato non esiste.

CMFCToolBarImages::GetTransparentColor

COLORREF GetTransparentColor() const;

Valore restituito

Osservazioni:

CMFCToolBarImages::GrayImages

Grigia le immagini della barra degli strumenti per renderle disabilitate.

BOOL GrayImages(int nGrayImageLuminancePercentage);

Parametri

nGrayImageLuminancePercentage
[in] Percentuale di luminanza.

Valore restituito

TRUE se le immagini nella raccolta sono state disattivate correttamente; in caso contrario FALSE.

Osservazioni:

Questo metodo modifica le immagini della barra degli strumenti mediando i componenti rosso, verde e blu di ogni pixel e moltiplicando il risultato per nGrayImageLuminancePercentage diviso per 100. Se nGrayImageLuminancePercentage è zero o negativo, viene invece usato il valore predefinito 130.

Nota

Se si vuole annullare la modifica, è necessario ricaricare le immagini dall'origine. A tale scopo, chiamare CMFCToolBarImages::Load o CMFCToolBarImages::UpdateImage (solo per immagini definite dall'utente) o chiamando CMFCToolBarImages::Clear e aggiungendo di nuovo le immagini chiamando CMFCToolBarImages::AddIcon o CMFCToolBarImages::AddImages::AddImage.

CMFCToolBarImages::Is32BitTransparencySupported

Specifica se il sistema operativo supporta la fusione alfa a 32 bit.

static BOOL Is32BitTransparencySupported();

Valore restituito

TRUE se la fusione alfa a 32 bit è supportata; in caso contrario FALSE.

Osservazioni:

Utilizzare questo metodo statico per determinare in fase di esecuzione se il sistema operativo supporta la fusione alfa a 32 bit. Questa funzionalità è supportata in Windows 2000 e versioni successive.

CMFCToolBarImages::IsPreMultiplyAutoCheck

BOOL IsPreMultiplyAutoCheck() const;

Valore restituito

Osservazioni:

CMFCToolBarImages::IsReadOnly

Specifica se le immagini della barra degli strumenti sono di sola lettura.

BOOL IsReadOnly() const;

Valore restituito

TRUE se le immagini della barra degli strumenti sono di sola lettura, in caso contrario FALSE.

Osservazioni:

L'oggetto CMFCToolbarImages è di sola lettura quando la bitmap con immagini della barra degli strumenti è stata caricata da un file di sola lettura o quando la bitmap è stata copiata usando il CMFCToolBarImages::CopyTemp metodo .

CMFCToolBarImages::IsRTL

Specifica se il supporto da destra a sinistra (RTL) è abilitato.

static BOOL IsRTL();

Valore restituito

TRUE se il supporto RTL è abilitato; in caso contrario FALSE.

Osservazioni:

Il supporto RTL viene usato quando l'applicazione viene localizzata in una lingua letta da destra a sinistra, ad esempio arabo, ebraico, persiano o Urdu.

CMFCToolBarImages::IsUserImagesList

Specifica se questo set di immagini della barra degli strumenti contiene immagini definite dall'utente.

BOOL IsUserImagesList() const;

Valore restituito

TRUE se l'oggetto CMFCToolBarImages contiene immagini della barra degli strumenti definite dall'utente; in caso contrario, FALSE.

CMFCToolBarImages::IsValid

Indica se questo set di immagini della barra degli strumenti contiene un'immagine valida della barra degli strumenti.

BOOL IsValid() const;

Valore restituito

TRUE se un CMFCToolBarImages oggetto è valido; in caso contrario, FALSE.

Osservazioni:

L'oggetto CMFCToolBarImages non è valido quando il relativo handle in una bitmap con immagini della barra degli strumenti è NULL.

CMFCToolBarImages::Load

Carica le immagini della barra degli strumenti dalle risorse di sistema o da un file.

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

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

Parametri

uiResID
[in] ID di una risorsa bitmap.

hinstRes
[in] Istanza della DLL della risorsa.

bAdd
[in] TRUE per aggiungere la bitmap caricata alla bitmap esistente o FALSE per sostituire la bitmap esistente.

lpszBmpFileName
[in] Percorso di un file su disco da cui caricare la bitmap.

nMaxFileSize
[in] Numero massimo di byte nel file bitmap; o 0 per caricare la bitmap indipendentemente dalle dimensioni del file. Se le dimensioni del file superano questa dimensione massima, il metodo restituisce FALSE e non carica la bitmap.

Valore restituito

TRUE se la bitmap è stata caricata correttamente; in caso contrario FALSE.

Osservazioni:

Se il file ha l'attributo di sola lettura, l'elenco di immagini viene contrassegnato come di sola lettura.

CMFCToolBarImages::LoadStr

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

Parametri

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

Valore restituito

Osservazioni:

CMFCToolBarImages::MapFromSysColor

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

Parametri

[in] Colore
[in] bUseRGBQUAD

Valore restituito

Osservazioni:

CMFCToolBarImages::MapTo3dColors

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

Parametri

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

Valore restituito

Osservazioni:

CMFCToolBarImages::MapToSysColor

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

Parametri

[in] Colore
[in] bUseRGBQUAD

Valore restituito

Osservazioni:

CMFCToolBarImages::MapToSysColorAlpha

static COLORREF __stdcall MapToSysColorAlpha(COLORREF color);

Parametri

[in] Colore

Valore restituito

Osservazioni:

CMFCToolBarImages::Mirror

Sostituisce le immagini della barra degli strumenti con l'immagine dello specchio orizzontale.

BOOL Mirror();

Valore restituito

TRUE se le immagini sono state rispecchiate correttamente; in caso contrario FALSE.

Osservazioni:

Questo metodo viene usato per supportare sistemi di scrittura da destra a sinistra.

CMFCToolBarImages::MirrorBitmap

Sostituisce una bitmap con l'immagine mirror orizzontale.

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

Parametri

hbmp
[in, out] Handle da bitmap a mirroring.

cxImage
[in] Larghezza dell'immagine in pixel.

Valore restituito

TRUE se l'immagine è stata eseguita correttamente con il mirroring; in caso contrario FALSE.

Osservazioni:

Questa funzione viene usata per supportare sistemi di scrittura da destra a sinistra.

CMFCToolBarImages::MirrorBitmapVert

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

Parametri

[in] hbmp
[in] cyImage

Valore restituito

Osservazioni:

CMFCToolBarImages::MirrorVert

BOOL MirrorVert();

Valore restituito

Osservazioni:

CMFCToolBarImages::OnSysColorChange

void OnSysColorChange();

Osservazioni:

CMFCToolBarImages::P reMultiplyAlpha

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

BOOL PreMultiplyAlpha(HBITMAP hbmp);

Parametri

[in] hbmp
[in] bAutoCheckPremlt

Valore restituito

Osservazioni:

CMFCToolBarImages::m_bDisableTrueColorAlpha

TRUE se la fusione alfacolore true (colore a 32 bit) è disabilitata.

static BOOL m_bDisableTrueColorAlpha;

Osservazioni:

Impostare questa variabile membro su FALSE per abilitare la fusione alfacolore true per le immagini della barra degli strumenti.

Il valore predefinito è TRUE per la compatibilità con le versioni precedenti.

CMFCToolBarImages::P repareDrawImage

Alloca le risorse necessarie per disegnare un'immagine della barra degli strumenti a una dimensione specificata.

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

Parametri

Ds
[in] Riferimento alla CAfxDrawState struttura, che archivia le risorse allocate tra le fasi di rendering delle immagini.

sizeImageDest
[in] Specifica le dimensioni di un'immagine di destinazione.

bFadeInactive
[in] TRUE se si desidera che le immagini inattive vengano disegnate sbiadite.

Valore restituito

TRUE se le risorse necessarie per disegnare l'immagine della barra degli strumenti sono state allocate correttamente, in caso contrario FALSE.

Osservazioni:

Dopo aver chiamato questo metodo, è possibile chiamare CMFCToolBarImages::D raw un numero qualsiasi di volte. Al termine del disegno, è necessario chiamare CMFCToolBarImages::EndDrawImage per rilasciare le risorse allocate da PrepareDrawImage.

CMFCToolBarImages::Save

Archivia le immagini della barra degli strumenti in un file se questo set di immagini della barra degli strumenti contiene immagini definite dall'utente.

BOOL Save(LPCTSTR lpszBmpFileName=NULL);

Parametri

lpszBmpFileName
Percorso di un file su disco.

Valore restituito

TRUE se le immagini della barra degli strumenti sono state salvate correttamente; in caso contrario FALSE.

Osservazioni:

Chiamare questo metodo per archiviare le immagini definite dall'utente in un file su disco. Se lpszBmpFileName è NULL, il metodo archivia la bitmap nel file da cui è stata caricata la bitmap dal metodo CMFCToolBarImages::Load .

CMFCToolBarImages::SetAlwaysLight

void SetAlwaysLight(BOOL bAlwaysLight = TRUE);

Parametri

[in] bAlwaysLight

Osservazioni:

CMFCToolBarImages::SetDisabledImageAlpha

Imposta il valore del canale alfa (opacità) utilizzato per le immagini disabilitate.

static void SetDisabledImageAlpha(BYTE nValue);

Parametri

nValue
[in] Nuovo valore del canale alfa.

Osservazioni:

Usare questo metodo per impostare un valore alfa personalizzato per le immagini disabilitate. Il valore predefinito è 127, che causa la semitrasparente delle immagini del pulsante disabilitate. Se imposti un valore pari a 0, le immagini disabilitate saranno completamente trasparenti. Se imposti un valore pari a 255, le immagini disabilitate saranno completamente opache.

CMFCToolBarImages::SetFadedImageAlpha

static void __stdcall SetFadedImageAlpha(BYTE nValue);

Parametri

[in] nValue

Osservazioni:

CMFCToolBarImages::SetImageSize

Imposta le dimensioni di ogni immagine della barra degli strumenti (dimensione di origine).

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

Parametri

sizeImage
[in] Nuove dimensioni delle immagini della barra degli strumenti.

Osservazioni:

Per impostazione predefinita, le dimensioni dell'immagine della barra degli strumenti sono 16x15 pixel. Chiama questo metodo se vuoi usare immagini della barra degli strumenti di dimensioni diverse.

CMFCToolBarImages::SetLightPercentage

void SetLightPercentage(int nValue);

Parametri

[in] nValue

Osservazioni:

CMFCToolBarImages::SetMapTo3DColors

void SetMapTo3DColors(BOOL bMapTo3DColors);

Parametri

[in] bMapTo3DColors

Osservazioni:

CMFCToolBarImages::SetPreMultiplyAutoCheck

void SetPreMultiplyAutoCheck(BOOL bAuto = TRUE);

Parametri

[in] bAuto

Osservazioni:

CMFCToolBarImages::SetSingleImage

void SetSingleImage();

Osservazioni:

CMFCToolBarImages::SetTransparentColor

Imposta il colore trasparente delle immagini della barra degli strumenti.

COLORREF SetTransparentColor(COLORREF clrTransparent);

Parametri

clrTransparent
[in] Valore RGB.

Valore restituito

Colore trasparente precedente.

Osservazioni:

Quando si o il framework chiama CMFCToolBarImages::D raw, il metodo non disegna alcun pixel corrispondente al colore specificato da clrTransparent.

CMFCToolBarImages::UpdateImage

Aggiorna un'immagine della barra degli strumenti definita dall'utente da una bitmap.

BOOL UpdateImage(
    int iImage,
    HBITMAP hbmp);

Parametri

iImage
[in] Indice in base zero dell'immagine da aggiornare.

hbmp
[in] Handle per la bitmap da cui aggiornare l'immagine.

Valore restituito

TRUE se l'immagine è stata aggiornata correttamente; FALSE se l'elenco di immagini non è definito dall'utente o temporaneo.

CMFCToolBarImages::ConvertTo32Bits

Converte le bitmap sottolineate in 32 immagini bpp.

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

Parametri

clrTransparent
Specifica il colore trasparente delle bitmap sottolineate.

Osservazioni:

CMFCToolBarImages::GetBitsPerPixel

Restituisce la risoluzione corrente delle immagini sottolineate.

int GetBitsPerPixel() const;

Valore restituito

Valore intero che rappresenta la risoluzione corrente delle immagini sottolineate, in bit per pixel (bpp).

Osservazioni:

CMFCToolBarImages::GetScale

Restituisce il rapporto di scala corrente delle immagini sottolineate.

double GetScale() const;

Valore restituito

Valore che rappresenta il rapporto di scala corrente.

Osservazioni:

CMFCToolBarImages::IsScaled

Indica se le immagini sottolineate vengono ridimensionate o meno.

BOOL IsScaled () const;

Valore restituito

TRUE se le immagini sottolineate vengono ridimensionate; in caso contrario FALSE.

Osservazioni:

CMFCToolBarImages::SmoothResize

Ridimensiona senza problemi le immagini sottolineate.

BOOL SmoothResize(double dblImageScale);

Parametri

dblImageScale
Rapporto di scala.

Valore restituito

TRUE se il ridimensionamento ha esito positivo; in caso contrario FALSE.

Osservazioni:

Vedi anche

Grafico della gerarchia
Classi
Classe CObject
Classe CMFCToolBar
Classe CMFCToolBarButton