CMFCToolBarImages – třída

Článek
08/04/2024

Obrázky na panelu nástrojů Třída CMFCToolBarImages spravuje obrázky panelů nástrojů načtené z prostředků aplikace nebo ze souborů. Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.

Syntaxe

class CMFCToolBarImages : public CObject

Členové

Veřejné konstruktory

Název	Popis
CMFCToolBarImages::CMFCToolBarImages	`CMFCToolBarImages` Vytvoří objekt.

Veřejné metody

Název	Popis
CMFCToolBarImages::AdaptColors
CMFCToolBarImages::AddIcon	Přidá na obrázky panelu nástrojů ikonu.
CMFCToolBarImages::AddImage	Přidá rastrový obrázek na obrázky panelu nástrojů.
CMFCToolBarImages::CleanUp
CMFCToolBarImages::Clear	Uvolní systémové prostředky přidělené tomuto objektu.
CMFCToolBarImages::ConvertTo32Bits	Převede podtržené rastrové obrázky na 32 obrázků bpp.
CMFCToolBarImages::CopyImageToClipboard
CMFCToolBarImages::CopyTo
CMFCToolBarImages::CreateFromImageList	Inicializuje obrázky panelu nástrojů ze seznamu obrázků ( CImageList – třída).
CMFCToolBarImages::CreateRegionFromImage
CMFCToolBarImages::D eleteImage	Odstraní obrázek, který má zadaný index z obrázků panelu nástrojů, pokud tato sada obrázků panelu nástrojů obsahuje uživatelem definované obrázky.
CMFCToolBarImages::D raw	Nakreslí jeden obrázek panelu nástrojů (tlačítko).
CMFCToolBarImages::D rawEx
CMFCToolBarImages::EnableRTL
CMFCToolBarImages::EndDrawImage	Uvolní systémové prostředky po vykreslení obrázku panelu nástrojů.
CMFCToolBarImages::ExtractIcon	Vrátí ikonu, která má zadaný index obrázku z obrázků na panelu nástrojů.
CMFCToolBarImages::FillDitheredRect	Vyplní obdélník pomocí štětce, který má barvy pozadí panelu nástrojů.
CMFCToolBarImages::GetAlwaysLight
CMFCToolBarImages::GetBitsPerPixel	Vrátí aktuální rozlišení podtržených obrázků.
CMFCToolBarImages::GetCount	Vrátí počet obrázků na panelu nástrojů.
CMFCToolBarImages::GetDisabledImageAlpha	Vrátí hodnotu alfa kanálu, která se používá pro zakázané obrázky.
CMFCToolBarImages::GetFadedImageAlpha
CMFCToolBarImages::GetImageSize	Načte buď velikost obrázků panelu nástrojů uložených v paměti (velikost zdroje), nebo velikost obrázků panelu nástrojů nakreslených na obrazovce (cílová velikost).
CMFCToolBarImages::GetImageWell	Vrátí úchyt rastrového obrázku, který obsahuje všechny obrázky panelu nástrojů.
CMFCToolBarImages::GetImageWellLight
CMFCToolBarImages::GetLastImageRect
CMFCToolBarImages::GetLightPercentage
CMFCToolBarImages::GetMapTo3DColors
CMFCToolBarImages::GetMask
CMFCToolBarImages::GetResourceOffset	Vrátí index image pro zadané ID prostředku.
CMFCToolBarImages::GetScale	Vrátí aktuální poměr měřítka podtržených obrázků.
CMFCToolBarImages::GetTransparentColor
CMFCToolBarImages::GrayImages	Obrázky panelu nástrojů se zobrazí šedě, aby vypadaly zakázané.
CMFCToolBarImages::Is32BitTransparencySupported	Určuje, zda operační systém podporuje 32bitové alfa blending.
CMFCToolBarImages::IsPreMultiplyAutoCheck
CMFCToolBarImages::IsRTL	Určuje, jestli je povolená podpora zprava doleva (RTL).
CMFCToolBarImages::IsReadOnly	Určuje, zda jsou obrázky panelu nástrojů jen pro čtení.
CMFCToolBarImages::IsScaled	Určuje, jestli jsou podtržené obrázky škálované nebo ne.
CMFCToolBarImages::IsUserImagesList	Určuje, zda tato sada obrázků na panelu nástrojů obsahuje uživatelem definované obrázky.
CMFCToolBarImages::IsValid	Určuje, zda tato sada obrázků na panelu nástrojů obsahuje platný obrázek panelu nástrojů.
CMFCToolBarImages::Load	Načte obrázky panelů nástrojů ze systémových prostředků nebo ze souboru.
CMFCToolBarImages::LoadStr
CMFCToolBarImages::MapFromSysColor
CMFCToolBarImages::MapTo3dColors
CMFCToolBarImages::MapToSysColor
CMFCToolBarImages::MapToSysColorAlpha
CMFCToolBarImages::Zrcadlo	Vodorovně zrcadlí všechny obrázky panelu nástrojů.
CMFCToolBarImages::MirrorBitmap	Vodorovně zrcadlí rastrový obrázek.
CMFCToolBarImages::MirrorBitmapVert
CMFCToolBarImages::MirrorVert
CMFCToolBarImages::OnSysColorChange
CMFCToolBarImages::P repareDrawImage	Přidělí prostředky potřebné k vykreslení obrázku panelu nástrojů s zadanou velikostí.
CMFCToolBarImages::Save	Uloží obrázky panelu nástrojů do souboru, pokud tato sada obrázků na panelu nástrojů obsahuje uživatelem definované obrázky.
CMFCToolBarImages::SetAlwaysLight
CMFCToolBarImages::SetDisabledImageAlpha	Nastaví hodnotu alfa kanálu, která se používá pro zakázané obrázky.
CMFCToolBarImages::SetFadedImageAlpha
CMFCToolBarImages::SetImageSize	Nastaví velikost obrázku panelu nástrojů (velikost zdroje).
CMFCToolBarImages::SetLightPercentage
CMFCToolBarImages::SetMapTo3DColors
CMFCToolBarImages::SetPreMultiplyAutoCheck
CMFCToolBarImages::SetSingleImage
CMFCToolBarImages::SetTransparentColor	Nastaví průhlednou barvu obrázků panelu nástrojů.
CMFCToolBarImages::SmoothResize	Hladce změní velikost podtržených obrázků.
CMFCToolBarImages::UpdateImage	Aktualizuje obrázek panelu nástrojů definovaný uživatelem z rastrového obrázku.

Chráněné metody

Název	Popis
CMFCToolBarImages::P reMultiplyAlpha

Datové členy

Název	Popis
CMFCToolBarImages::m_bDisableTrueColorAlpha	TRUE, pokud je zakázána kombinace alfa truecolor (32bitová barva).

Poznámky

Úplný rastrový obrázek obrázků na panelu nástrojů spravovaných CMFCToolbarImages pomocí jednoho nebo více malých obrázků panelu nástrojů (tlačítek) s pevnou velikostí.

Příklad

Následující příklad ukazuje, jak nakonfigurovat CMFCToolBarImages objekt pomocí různých metod ve CMFCToolBarImages třídě. Příklad ukazuje, jak nastavit velikost obrázku panelu nástrojů, načíst obrázek a nastavit průhlednou barvu obrázku. Tento fragment kódu je součástí ukázky sady Visual Studio Demo.

CMFCToolBarImages m_Image;

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

Hierarchie dědičnosti

Objekt CObject

CMFCToolBarImages

Požadavky

Hlavička: afxtoolbarimages.h

CMFCToolBarImages::AdaptColors

void AdaptColors(
    COLORREF clrBase,
    COLORREF clrTone);

Parametry

[v] clrBase
[v] clrTone

Poznámky

CMFCToolBarImages::AddIcon

Přidá ikonu do seznamu obrázků na panelu nástrojů.

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

Parametry

hIcon
[v] Popisovač ikony, která se má přidat.

bAlphaBlend
[v] TRUE, pokud se tato ikona používá s alfa prolnutí; jinak NEPRAVDA.

Návratová hodnota

Nulový index obrázku panelu nástrojů, který byl přidán, pokud je metoda úspěšná; jinak -1.

CMFCToolBarImages::AddImage

Přidá rastrový obrázek na obrázky panelu nástrojů.

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

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

Parametry

hbmp
[v] Popisovač rastrového obrázku, který chcete přidat.

bSetBitPerPixel
[v] TRUE, pokud CMFCToolBarImages objekt používá hloubku barvy (bity na pixel) nového obrázku; NEPRAVDA, pokud CMFCToolbarImages objekt zachová aktuální hloubku barvy.

imageList
[v] Odkaz na CMFCToolbarImages objekt, který obsahuje obrázek, který chcete přidat.

nIndex
[v] Index ve zdrojovém CMFCToolbarImages objektu obrázku, který chcete přidat.

Návratová hodnota

Počet obrázků panelu nástrojů, které CMFCToolBarImages objekt udržuje po úspěšném přidání nového rastrového obrázku; -1, pokud operace selhala.

CMFCToolBarImages::CleanUp

static void __stdcall CleanUp();

Poznámky

CMFCToolBarImages::Clear

Uvolní systémové prostředky, které CMFCToolbarImages objekt přidělen.

void Clear();

CMFCToolBarImages::CMFCToolBarImages

CMFCToolBarImages Vytvoří objekt.

CMFCToolBarImages();

Poznámky

CMFCToolBarImages Vytvoří objekt, inicializuje jeho vykreslovací modul a nastaví velikost obrázku na výchozí hodnotu 16 × 15 pixelů. Před přidáním obrázků změňte velikost obrázku pomocí CMFCToolBarImages::SetImageSize .

CMFCToolBarImages::CopyImageToClipboard

BOOL CopyImageToClipboard(int iImage);

Parametry

[v] iImage

Návratová hodnota

Poznámky

CMFCToolBarImages::CopyTo

BOOL CopyTo(CMFCToolBarImages& imageList);

Parametry

[v] imageList

Návratová hodnota

Poznámky

CMFCToolBarImages::CreateFromImageList

Inicializuje obrázky panelu nástrojů z CImageList Class objektu.

BOOL CreateFromImageList(const CImageList& imageList);

Parametry

imageList
[v] Seznam obrázků, který se má použít jako zdroj pro obrázky na panelu nástrojů.

Návratová hodnota

Vždy vrátí hodnotu PRAVDA.

Poznámky

Pomocí této funkce můžete rychle inicializovat seznam obrázků na panelu nástrojů ze seznamu externích obrázků.

CMFCToolBarImages::CreateRegionFromImage

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

Parametry

[v] Bmp
[v] clrTransparent

Návratová hodnota

Poznámky

CMFCToolBarImages::D eleteImage

Odstraní uživatelem definovaný obrázek, který má zadaný index z obrázků panelu nástrojů.

BOOL DeleteImage(int iImage);

Parametry

iImage
[v] Určuje index založený na nule image, který se má odstranit.

Návratová hodnota

TRUE, pokud byla image úspěšně odstraněna; NEPRAVDA, pokud je index obrázku neplatný, CMFCToolbarImages objekt je dočasný, CMFCToolbarImages objekt neobsahuje uživatelem definované obrázky nebo pokud došlo k nějaké jiné chybě.

CMFCToolBarImages::D raw

Nakreslí jeden obrázek panelu nástrojů.

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

Parametry

pDC
[v] Ukazatel na kontext zařízení.

x
[v] Souřadnice X levé strany obdélníku, kde má být obrázek nakreslen.

y
[v] Souřadnice Y horní části obdélníku, kde se má obrázek nakreslit.

iImageIndex
[v] Index obrázku založený na nule, který se má zobrazit.

bHilite
[v] TRUE, pokud má být obrázek zvýrazněn; jinak NEPRAVDA.

bDisabled
[v] TRUE, pokud má být obrázek kreslen v zakázaném stylu; jinak NEPRAVDA.

bIndeterminate
[v] TRUE, pokud je obrázek nakreslen v neurčitém stavu stylu; jinak NEPRAVDA.

bShadow
[v] TRUE, pokud má být obrázek nakreslen s stínem; jinak NEPRAVDA.

bInactive
[v] TRUE, pokud je obrázek nakreslen ve stylu neaktivního stavu; jinak NEPRAVDA.

alphaSrc
[v] Hodnota alfa kanálu (neprůhlednost). Hodnota 255 znamená, že obrázek je nakreslený neprůhlhlý. Hodnota 0 znamená, že obrázek je průhledný. Tato hodnota se používá pouze pro 32bitové barevné obrázky a pro obrázky, které zobrazily styl skla systému Windows Vista.

Návratová hodnota

TRUE, pokud byl zadaný obrázek úspěšně zobrazen; NEPRAVDA, pokud byl index obrázku neplatný nebo došlo k jiné chybě.

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

Parametry

[v] pDC
[v] Rect
[v] iImageIndex
[v] horzAlign
[v] vertAlign
[v] rectSrc
[v] alphaSrc

Návratová hodnota

Poznámky

CMFCToolBarImages::EnableRTL

static void __stdcall EnableRTL(BOOL bIsRTL = TRUE);

Parametry

[v] bIsRTL

Poznámky

CMFCToolBarImages::EndDrawImage

Uvolní systémové prostředky, které CMFCToolBarImages::P repareDrawImage přidělený po nakreslení obrázku panelu nástrojů voláním CMFCToolBarImages::D raw.

void EndDrawImage(CAfxDrawState& ds);

Parametry

Ds
[v] Odkaz na CAfxDrawState objekt, který byl předán metodě PrepareDrawImage .

CMFCToolBarImages::ExtractIcon

Vrátí ikonu, která má zadaný index obrázku z obrázků na panelu nástrojů.

HICON ExtractIcon(int nIndex);

Parametry

nIndex
[v] Index založený na nule v seznamu obrázků, ve kterém se obrázek extrahuje jako ikona.

Návratová hodnota

Popisovač extrahované ikony nebo NULL, pokud nIndex je mimo rozsah.

CMFCToolBarImages::FillDitheredRect

Vyplní obdélník barvami pozadí panelu nástrojů.

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

Parametry

pDC
[v] Ukazatel na kontext zařízení.

Rect
[v] Souřadnice obdélníku, který se má vyplnit.

Poznámky

Tato metoda slouží k vyplnění obdélníku barvou, která je průměrem systémových barev COLOR_BTNFACE a COLOR_BTNHIGHLIGHT. Pokud systém používá 256 nebo méně barev, bude obdélník vyplněný dithered vzorem těchto dvou barev.

CMFCToolBarImages::GetAlwaysLight

BOOL GetAlwaysLight() const;

Návratová hodnota

Poznámky

CMFCToolBarImages::GetCount

Vrátí počet obrázků v seznamu obrázků na panelu nástrojů.

int GetCount() const;

Návratová hodnota

Počet obrázků v objektu CMFCToolBarImages .

CMFCToolBarImages::GetDisabledImageAlpha

Vrátí hodnotu alfa kanálu (neprůhlednost), která se používá pro zakázané obrázky.

static BYTE GetDisabledImageAlpha();

Návratová hodnota

Aktuální hodnota alfa kanálu.

Poznámky

Můžete volat CMFCToolBarImages::SetDisabledImageAlpha změnit hodnotu alfa kanálu.

CMFCToolBarImages::GetFadedImageAlpha

static BYTE __stdcall GetFadedImageAlpha();

Návratová hodnota

Poznámky

CMFCToolBarImages::GetImageSize

Načte buď velikost obrázků panelu nástrojů uložených v paměti (velikost zdroje), nebo velikost obrázků panelu nástrojů nakreslených na obrazovce (cílová velikost).

SIZE GetImageSize(BOOL bDest=FALSE) const;

Parametry

bDest
[v] TRUE pro načtení cílové velikosti; NEPRAVDA pro načtení velikosti zdrojové image.

Návratová hodnota

Struktura SIZE , která určuje velikost obrázku v pixelech.

Poznámky

Velikost zdrojové image je velikost obrázků, které jsou uloženy v CMFCToolbarImages objektu. Můžete volat CMFCToolBarImages::SetImageSize nastavit velikost zdroje. Výchozí hodnota je 16x15 pixelů.

Ve výchozím nastavení je velikost cílové image 0x0. Velikost cíle zadáte při volání CMFCToolBarImages::P repareDrawImage. CMFCToolBarImages ::EndDrawImage metoda resetuje cílovou velikost na výchozí hodnotu.

CMFCToolBarImages::GetImageWell

Vrátí úchyt rastrového obrázku, který obsahuje všechny obrázky panelu nástrojů.

HBITMAP GetImageWell() const;

Návratová hodnota

Úchyt rastrového obrázku, který obsahuje obrázky panelu nástrojů.

Poznámky

Obrázky panelu nástrojů jsou uloženy v řádku v jednom rastrovém obrázku, který se označuje jako obrázek dobře. Pokud chcete najít obrázek panelu nástrojů v kontejneru obrázků, vynásobte index obrázku šířkou obrázků panelu nástrojů (viz CMFCToolBarImages::GetImageSize) a získejte vodorovný posun obrázku uvnitř kontejneru obrázku.

CMFCToolBarImages::GetImageWellLight

HBITMAP GetImageWellLight() const;

Návratová hodnota

Poznámky

CMFCToolBarImages::GetLastImageRect

CRect GetLastImageRect() const;

Návratová hodnota

Poznámky

CMFCToolBarImages::GetLightPercentage

int GetLightPercentage() const;

Návratová hodnota

Poznámky

CMFCToolBarImages::GetMapTo3DColors

BOOL GetMapTo3DColors() const;

Návratová hodnota

Poznámky

CMFCToolBarImages::GetMask

HBITMAP GetMask(int iImage);

Parametry

[v] iImage

Návratová hodnota

Poznámky

CMFCToolBarImages::GetResourceOffset

Vrátí index image pro zadané ID prostředku.

int GetResourceOffset(UINT uiResId) const;

Parametry

uiResId
[v] ID prostředku image.

Návratová hodnota

Index obrázku, pokud byla metoda úspěšná; -1, pokud image se zadaným ID prostředku neexistuje.

CMFCToolBarImages::GetTransparentColor

COLORREF GetTransparentColor() const;

Návratová hodnota

Poznámky

CMFCToolBarImages::GrayImages

Obrázky panelu nástrojů se zobrazí šedě, aby vypadaly zakázané.

BOOL GrayImages(int nGrayImageLuminancePercentage);

Parametry

nGrayImageLuminancePercentage
[v] Procento světelnosti.

Návratová hodnota

TRUE, pokud obrázky v kolekci byly úspěšně šedé; jinak NEPRAVDA.

Poznámky

Tato metoda upraví obrázky panelu nástrojů průměrem červených, zelených a modrých součástí každého pixelu a vynásobí výsledek hodnotou nGrayImageLuminancePercentage dělenou hodnotou 100. Pokud je hodnota nGrayImageLuminancePercentage nulová nebo záporná, použije se místo toho výchozí hodnota 130.

Poznámka:

Pokud chcete změnu vrátit zpět, musíte znovu načíst obrázky ze zdroje. Můžete to provést voláním CMFCToolBarImages::Load nebo CMFCToolBarImages::UpdateImage (pouze pro uživatelem definované obrázky) nebo voláním CMFCToolBarImages::Clear a opětovným přidáním obrázků voláním CMFCToolBarImages::AddIcon nebo CMFCToolBarImages::AddImage.

CMFCToolBarImages::Is32BitTransparencySupported

Určuje, jestli operační systém podporuje 32bitové alfa blending.

static BOOL Is32BitTransparencySupported();

Návratová hodnota

TRUE, pokud je podporováno 32bitové alfa blending; jinak NEPRAVDA.

Poznámky

Pomocí této statické metody můžete určit, jestli operační systém podporuje 32bitové alfa blending. Tato funkce je podporována ve Windows 2000 a novějších verzích.

CMFCToolBarImages::IsPreMultiplyAutoCheck

BOOL IsPreMultiplyAutoCheck() const;

Návratová hodnota

Poznámky

CMFCToolBarImages::IsReadOnly

Určuje, jestli jsou obrázky panelu nástrojů jen pro čtení.

BOOL IsReadOnly() const;

Návratová hodnota

TRUE, pokud jsou obrázky na panelu nástrojů jen pro čtení, jinak NEPRAVDA.

Poznámky

Objekt CMFCToolbarImages je jen pro čtení, pokud rastrový obrázek s obrázky panelu nástrojů byl načten ze souboru jen pro čtení nebo při zkopírování rastrového obrázku CMFCToolBarImages::CopyTemp pomocí metody.

CMFCToolBarImages::IsRTL

Určuje, jestli je povolená podpora zprava doleva (RTL).

static BOOL IsRTL();

Návratová hodnota

TRUE, pokud je povolena podpora RTL; jinak NEPRAVDA.

Poznámky

Podpora RTL se používá, když je aplikace lokalizovaná do jazyka, který se čte zprava doleva, jako je arabština, hebrejština, perština nebo Urdu.

CMFCToolBarImages::IsUserImagesList

Určuje, zda tato sada obrázků na panelu nástrojů obsahuje uživatelem definované obrázky.

BOOL IsUserImagesList() const;

Návratová hodnota

TRUE, pokud CMFCToolBarImages objekt obsahuje uživatelem definované obrázky panelu nástrojů; jinak NEPRAVDA.

CMFCToolBarImages::IsValid

Určuje, zda tato sada obrázků na panelu nástrojů obsahuje platný obrázek panelu nástrojů.

BOOL IsValid() const;

Návratová hodnota

TRUE, pokud CMFCToolBarImages je objekt platný; jinak NEPRAVDA.

Poznámky

Objekt CMFCToolBarImages není platný, pokud jeho popisovač rastrového obrázku s obrázky panelu nástrojů má hodnotu NULL.

CMFCToolBarImages::Load

Načte obrázky panelů nástrojů ze systémových prostředků nebo ze souboru.

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

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

Parametry

uiResID
[v] ID rastrového prostředku.

hinstRes
[v] Instance knihovny DLL prostředků.

bAdd
[v] HODNOTA TRUE pro přidání načteného rastrového obrázku do existujícího rastrového obrázku nebo NEPRAVDA pro nahrazení existujícího rastrového obrázku.

lpszBmpFileName
[v] Cesta k souboru disku, ze kterého chcete načíst rastrový obrázek.

nMaxFileSize
[v] Maximální počet bajtů v rastrovém souboru; nebo 0 pro načtení rastrového obrázku bez ohledu na velikost souboru. Pokud velikost souboru překračuje tuto maximální velikost, metoda vrátí HODNOTU FALSE a nenačte rastrový obrázek.

Návratová hodnota

TRUE, pokud rastrový obrázek byl úspěšně načten; jinak NEPRAVDA.

Poznámky

Pokud má soubor atribut jen pro čtení, je seznam obrázků označen jako jen pro čtení.

CMFCToolBarImages::LoadStr

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

Parametry

[v] lpszResourceName
[v] hinstRes
[v] bAdd

Návratová hodnota

Poznámky

CMFCToolBarImages::MapFromSysColor

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

Parametry

[v] barva
[v] bUseRGBQUAD

Návratová hodnota

Poznámky

CMFCToolBarImages::MapTo3dColors

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

Parametry

[v] bUseRGBQUAD
[v] clrSrc
[v] clrDest

Návratová hodnota

Poznámky

CMFCToolBarImages::MapToSysColor

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

Parametry

[v] barva
[v] bUseRGBQUAD

Návratová hodnota

Poznámky

CMFCToolBarImages::MapToSysColorAlpha

static COLORREF __stdcall MapToSysColorAlpha(COLORREF color);

Parametry

[v] barva

Návratová hodnota

Poznámky

CMFCToolBarImages::Zrcadlo

Nahradí obrázky panelu nástrojů jejich vodorovným zrcadlovým obrázkem.

BOOL Mirror();

Návratová hodnota

TRUE, pokud byly obrázky úspěšně zrcadlené; jinak NEPRAVDA.

Poznámky

Tato metoda se používá k podpoře systémů zápisu zprava doleva.

CMFCToolBarImages::MirrorBitmap

Nahradí rastrový obrázek vodorovným zrcadlem.

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

Parametry

hbmp
[in, out] Úchyt rastrového obrázku pro zrcadlení.

cxImage
[v] Šířka obrázku v pixelech

Návratová hodnota

TRUE, pokud byl obrázek úspěšně zrcadlený; jinak NEPRAVDA.

Poznámky

Tato funkce se používá k podpoře systémů zápisu zprava doleva.

CMFCToolBarImages::MirrorBitmapVert

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

Parametry

[v] hbmp
[v] cyImage

Návratová hodnota

Poznámky

CMFCToolBarImages::MirrorVert

BOOL MirrorVert();

Návratová hodnota

Poznámky

CMFCToolBarImages::OnSysColorChange

void OnSysColorChange();

Poznámky

CMFCToolBarImages::P reMultiplyAlpha

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

BOOL PreMultiplyAlpha(HBITMAP hbmp);

Parametry

[v] hbmp
[v] bAutoCheckPremlt

Návratová hodnota

Poznámky

CMFCToolBarImages::m_bDisableTrueColorAlpha

TRUE, pokud je zakázána kombinace alfa truecolor (32bitová barva).

static BOOL m_bDisableTrueColorAlpha;

Poznámky

Nastavte tuto členovou proměnnou na FALSE, pokud chcete povolit alfa-blending truecolor pro obrázky na panelu nástrojů.

Výchozí hodnota je PRAVDA pro zpětnou kompatibilitu.

CMFCToolBarImages::P repareDrawImage

Přidělí prostředky potřebné k vykreslení obrázku panelu nástrojů s zadanou velikostí.

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

Parametry

Ds
[v] Odkaz na CAfxDrawState strukturu, která ukládá přidělené prostředky mezi fázemi vykreslování obrázků.

sizeImageDest
[v] Určuje velikost cílové image.

bFadeInactive
[v] TRUE, pokud chcete, aby neaktivní obrázky byly nakresleny zesvětleně.

Návratová hodnota

PRAVDA, pokud byly prostředky potřebné k nakreslení obrázku panelu nástrojů úspěšně přiděleny, jinak NEPRAVDA.

Poznámky

Po volání této metody můžete volat CMFCToolBarImages::D raw libovolný počet. Po dokončení výkresu je nutné volat CMFCToolBarImages::EndDrawImage uvolnit prostředky přidělené PrepareDrawImage.

CMFCToolBarImages::Save

Uloží obrázky panelu nástrojů do souboru, pokud tato sada obrázků na panelu nástrojů obsahuje uživatelem definované obrázky.

BOOL Save(LPCTSTR lpszBmpFileName=NULL);

Parametry

lpszBmpFileName
Cesta k souboru disku.

Návratová hodnota

TRUE, pokud byly obrázky panelu nástrojů úspěšně uloženy; jinak NEPRAVDA.

Poznámky

Voláním této metody uložte uživatelem definované image do souboru disku. Pokud lpszBmpFileName je NULL, metoda uloží rastrový obrázek do souboru, ze kterého byl rastrový obrázek načten CMFCToolBarImages::Load metoda.

CMFCToolBarImages::SetAlwaysLight

void SetAlwaysLight(BOOL bAlwaysLight = TRUE);

Parametry

[v] bAlwaysLight

Poznámky

CMFCToolBarImages::SetDisabledImageAlpha

Nastaví hodnotu alfa kanálu (neprůhlednost), která se používá pro zakázané obrázky.

static void SetDisabledImageAlpha(BYTE nValue);

Parametry

nValue
[v] Nová hodnota alfa kanálu.

Poznámky

Tuto metodu použijte k nastavení vlastní alfa hodnoty pro zakázané obrázky. Výchozí hodnota je 127, což způsobí, že obrázky neaktivních tlačítek budou poloprůhledné. Pokud nastavíte hodnotu 0, zakázané obrázky budou zcela transparentní. Pokud nastavíte hodnotu 255, zakázané obrázky budou zcela neprůžné.

CMFCToolBarImages::SetFadedImageAlpha

static void __stdcall SetFadedImageAlpha(BYTE nValue);

Parametry

[v] nValue

Poznámky

CMFCToolBarImages::SetImageSize

Nastaví velikost každého obrázku panelu nástrojů (velikost zdroje).

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

Parametry

sizeImage
[v] Nová velikost obrázků na panelu nástrojů

Poznámky

Ve výchozím nastavení je velikost obrázku panelu nástrojů 16 × 15 pixelů. Tuto metodu zavolejte, pokud chcete použít obrázky panelu nástrojů s jinou velikostí.

CMFCToolBarImages::SetLightPercentage

void SetLightPercentage(int nValue);

Parametry

[v] nValue

Poznámky

CMFCToolBarImages::SetMapTo3DColors

void SetMapTo3DColors(BOOL bMapTo3DColors);

Parametry

[v] bMapTo3DColors

Poznámky

CMFCToolBarImages::SetPreMultiplyAutoCheck

void SetPreMultiplyAutoCheck(BOOL bAuto = TRUE);

Parametry

[v] bAuto

Poznámky

CMFCToolBarImages::SetSingleImage

void SetSingleImage();

Poznámky

CMFCToolBarImages::SetTransparentColor

Nastaví průhlednou barvu obrázků panelu nástrojů.

COLORREF SetTransparentColor(COLORREF clrTransparent);

Parametry

clrTransparent
[v] Hodnota RGB.

Návratová hodnota

Předchozí průhledná barva.

Poznámky

Když vy nebo architektura volání CMFCToolBarImages::D raw metoda nekreslí žádný pixel, který odpovídá barvě určené clrTransparent.

CMFCToolBarImages::UpdateImage

Aktualizuje obrázek panelu nástrojů definovaný uživatelem z rastrového obrázku.

BOOL UpdateImage(
    int iImage,
    HBITMAP hbmp);

Parametry

iImage
[v] Index image založený na nule, který se má aktualizovat.

hbmp
[v] Úchyt rastrového obrázku, ze kterého chcete obrázek aktualizovat.

Návratová hodnota

TRUE, pokud byla image úspěšně aktualizována; NEPRAVDA, pokud seznam obrázků není definovaný uživatelem nebo dočasný.

CMFCToolBarImages::ConvertTo32Bits

Převede podtržené rastrové obrázky na 32 obrázků bpp.

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

Parametry

clrTransparent
Určuje průhlednou barvu podtržených rastrových obrázků.

Poznámky

CMFCToolBarImages::GetBitsPerPixel

Vrátí aktuální rozlišení podtržených obrázků.

int GetBitsPerPixel() const;

Návratová hodnota

Celočíselná hodnota představující aktuální rozlišení podtržených obrázků v bitech na pixel (bpp).

Poznámky

CMFCToolBarImages::GetScale

Vrátí aktuální poměr měřítka podtržených obrázků.

double GetScale() const;

Návratová hodnota

Hodnota představující aktuální poměr měřítka.

Poznámky

CMFCToolBarImages::IsScaled

Určuje, jestli jsou podtržené obrázky škálované nebo ne.

BOOL IsScaled () const;

Návratová hodnota

TRUE, pokud jsou podtržené obrázky škálovány; jinak NEPRAVDA.

Poznámky

CMFCToolBarImages::SmoothResize

Hladce změní velikost podtržených obrázků.

BOOL SmoothResize(double dblImageScale);

Parametry

dblImageScale
Poměr měřítka

Návratová hodnota

TRUE, pokud změna velikosti proběhne úspěšně; jinak NEPRAVDA.

Poznámky

Viz také

Graf hierarchie
Třídy
CObject – třída
CMFCToolBar – třída
CMFCToolBarButton – třída

Sdílet prostřednictvím

CMFCToolBarImages – třída

Syntaxe

Členové

Veřejné konstruktory

Veřejné metody

Chráněné metody

Datové členy

Poznámky

Příklad

Hierarchie dědičnosti

Požadavky

CMFCToolBarImages::AdaptColors

Parametry

Poznámky

CMFCToolBarImages::AddIcon

Parametry

Návratová hodnota

CMFCToolBarImages::AddImage

Parametry

Návratová hodnota

CMFCToolBarImages::CleanUp

Poznámky

CMFCToolBarImages::Clear

CMFCToolBarImages::CMFCToolBarImages

Poznámky

CMFCToolBarImages::CopyImageToClipboard

Parametry

Návratová hodnota

Poznámky

CMFCToolBarImages::CopyTo

Parametry

Návratová hodnota

Poznámky

CMFCToolBarImages::CreateFromImageList

Parametry

Návratová hodnota

Poznámky

CMFCToolBarImages::CreateRegionFromImage

Parametry

Návratová hodnota

Poznámky

CMFCToolBarImages::D eleteImage

Parametry

Návratová hodnota

CMFCToolBarImages::D raw

Parametry

Návratová hodnota

CMFCToolBarImages::D rawEx

Parametry

Návratová hodnota

Poznámky

CMFCToolBarImages::EnableRTL

Parametry

Poznámky

CMFCToolBarImages::EndDrawImage

Parametry

CMFCToolBarImages::ExtractIcon

Parametry

Návratová hodnota

CMFCToolBarImages::FillDitheredRect

Parametry

Poznámky

CMFCToolBarImages::GetAlwaysLight

Návratová hodnota

Poznámky

CMFCToolBarImages::GetCount

Návratová hodnota

CMFCToolBarImages::GetDisabledImageAlpha

Návratová hodnota

Poznámky

CMFCToolBarImages::GetFadedImageAlpha

Návratová hodnota

Poznámky

CMFCToolBarImages::GetImageSize

Parametry

Návratová hodnota

Poznámky

CMFCToolBarImages::GetImageWell

Návratová hodnota