Udostępnij za pośrednictwem


Klasa CMFCToolBarImages

Obrazy na pasku narzędzi. Klasa CMFCToolBarImages zarządza obrazami paska narzędzi załadowanych z zasobów aplikacji lub plików. Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

Składnia

class CMFCToolBarImages : public CObject

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CMFCToolBarImages::CMFCToolBarImages CMFCToolBarImages Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko opis
CMFCToolBarImages::AdaptColors
CMFCToolBarImages::AddIcon Dodaje ikonę do obrazów paska narzędzi.
CMFCToolBarImages::AddImage Dodaje mapę bitową do obrazów paska narzędzi.
CMFCToolBarImages::CleanUp
CMFCToolBarImages::Clear Zwalnia zasoby systemowe przydzielone do tego obiektu.
CMFCToolBarImages::ConvertTo32Bits Konwertuje podkreślone mapy bitowe na 32 obrazy bpp.
CMFCToolBarImages::CopyImageToClipboard
CMFCToolBarImages::CopyTo
CMFCToolBarImages::CreateFromImageList Inicjuje obrazy paska narzędzi z listy obrazów ( klasa CImageList).
CMFCToolBarImages::CreateRegionFromImage
CMFCToolBarImages::D eleteImage Usuwa obraz z określonego indeksu z obrazów paska narzędzi, jeśli ten zestaw obrazów paska narzędzi zawiera obrazy zdefiniowane przez użytkownika.
CMFCToolBarImages::D raw Rysuje obraz pojedynczego paska narzędzi (przycisk).
CMFCToolBarImages::D rawEx
CMFCToolBarImages::EnableRTL
CMFCToolBarImages::EndDrawImage Zwalnia zasoby systemowe po narysowanym obrazie paska narzędzi.
CMFCToolBarImages::ExtractIcon Zwraca ikonę z określonym indeksem obrazu z obrazów paska narzędzi.
CMFCToolBarImages::FillDitheredRect Wypełnia prostokąt za pomocą pędzla, który ma kolory tła paska narzędzi.
CMFCToolBarImages::GetAlwaysLight
CMFCToolBarImages::GetBitsPerPixel Zwraca bieżącą rozdzielczość podkreślonych obrazów.
CMFCToolBarImages::GetCount Zwraca liczbę obrazów na pasku narzędzi.
CMFCToolBarImages::GetDisabledImageAlpha Zwraca wartość kanału alfa, która jest używana dla wyłączonych obrazów.
CMFCToolBarImages::GetFadedImageAlpha
CMFCToolBarImages::GetImageSize Pobiera rozmiar obrazów paska narzędzi przechowywanych w pamięci (rozmiar źródła) lub rozmiar obrazów paska narzędzi rysowanych na ekranie (rozmiar docelowy).
CMFCToolBarImages::GetImageWell Zwraca uchwyt do mapy bitowej zawierającej wszystkie obrazy paska narzędzi.
CMFCToolBarImages::GetImageWellLight
CMFCToolBarImages::GetLastImageRect
CMFCToolBarImages::GetLightPercentage
CMFCToolBarImages::GetMapTo3DColors
CMFCToolBarImages::GetMask
CMFCToolBarImages::GetResourceOffset Zwraca indeks obrazu dla określonego identyfikatora zasobu.
CMFCToolBarImages::GetScale Zwraca bieżący współczynnik skali podkreślenia obrazów.
CMFCToolBarImages::GetTransparentColor
CMFCToolBarImages::GrayImages Szarości obrazów paska narzędzi, aby wyglądały na wyłączone.
CMFCToolBarImages::Is32BitTransparencySupported Określa, czy system operacyjny obsługuje 32-bitowe mieszanie alfa.
CMFCToolBarImages::IsPreMultiplyAutoCheck
CMFCToolBarImages::IsRTL Określa, czy jest włączona obsługa od prawej do lewej (RTL).
CMFCToolBarImages::IsReadOnly Określa, czy obrazy paska narzędzi są tylko do odczytu.
CMFCToolBarImages::IsScaled Informuje, czy podkreślone obrazy są skalowane, czy nie.
CMFCToolBarImages::IsUserImagesList Określa, czy ten zestaw obrazów paska narzędzi zawiera obrazy zdefiniowane przez użytkownika.
CMFCToolBarImages::IsValid Określa, czy ten zestaw obrazów paska narzędzi zawiera prawidłowy obraz paska narzędzi.
CMFCToolBarImages::Load Ładuje obrazy paska narzędzi z zasobów systemowych lub z pliku.
CMFCToolBarImages::LoadStr
CMFCToolBarImages::MapFromSysColor
CMFCToolBarImages::MapTo3dColors
CMFCToolBarImages::MapToSysColor
CMFCToolBarImages::MapToSysColorAlpha
CMFCToolBarImages::Mirror W poziomie dubluje wszystkie obrazy pasków narzędzi.
CMFCToolBarImages::MirrorBitmap Poziomo dubluje mapę bitową.
CMFCToolBarImages::MirrorBitmapVert
CMFCToolBarImages::MirrorVert
CMFCToolBarImages::OnSysColorChange
CMFCToolBarImages::P repareDrawImage Przydziela zasoby wymagane do narysowania obrazu paska narzędzi o określonym rozmiarze.
CMFCToolBarImages::Save Przechowuje obrazy paska narzędzi w pliku, jeśli ten zestaw obrazów paska narzędzi zawiera obrazy zdefiniowane przez użytkownika.
CMFCToolBarImages::SetAlwaysLight
CMFCToolBarImages::SetDisabledImageAlpha Ustawia wartość kanału alfa, która jest używana dla wyłączonych obrazów.
CMFCToolBarImages::SetFadedImageAlpha
CMFCToolBarImages::SetImageSize Ustawia rozmiar obrazu paska narzędzi (rozmiar źródła).
CMFCToolBarImages::SetLightPercentage
CMFCToolBarImages::SetMapTo3DColors
CMFCToolBarImages::SetPreMultiplyAutoCheck
CMFCToolBarImages::SetSingleImage
CMFCToolBarImages::SetTransparentColor Ustawia przezroczysty kolor obrazów paska narzędzi.
CMFCToolBarImages::SmoothResize Płynnie zmienia rozmiar podkreślone obrazy.
CMFCToolBarImages::UpdateImage Aktualizuje obraz paska narzędzi zdefiniowanego przez użytkownika z mapy bitowej.

Metody chronione

Nazwa/nazwisko opis
CMFCToolBarImages::P reMultiplyAlpha

Składowe danych

Nazwa/nazwisko opis
CMFCToolBarImages::m_bDisableTrueColorAlpha Wartość TRUE, jeśli mieszanie alfacolor (kolor 32-bitowy) jest wyłączone.

Uwagi

Pełna mapa bitowa obrazów pasków narzędzi zarządzanych przez CMFCToolbarImages program składa się z co najmniej jednego małego obrazu paska narzędzi (przycisków) o stałym rozmiarze.

Przykład

W poniższym przykładzie pokazano, jak skonfigurować CMFCToolBarImages obiekt przy użyciu różnych metod w CMFCToolBarImages klasie. W przykładzie pokazano, jak ustawić rozmiar obrazu paska narzędzi, załadować obraz i ustawić przezroczysty kolor obrazu. Ten fragment kodu jest częścią przykładu pokazowego programu Visual Studio.

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

Hierarchia dziedziczenia

Obiekt CObject

CMFCToolBarImages

Wymagania

Nagłówek: afxtoolbarimages.h

CMFCToolBarImages::AdaptColors

void AdaptColors(
    COLORREF clrBase,
    COLORREF clrTone);

Parametry

[in] clrBase
[in] clrTone

Uwagi

CMFCToolBarImages::AddIcon

Dodaje ikonę do listy obrazów paska narzędzi.

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

Parametry

hIcon
[in] Uchwyt do ikony do dodania.

bAlphaBlend
[in] WARTOŚĆ TRUE, jeśli ta ikona jest używana z mieszaniem alfa; w przeciwnym razie FAŁSZ.

Wartość zwracana

Indeks na podstawie zera obrazu paska narzędzi, który został dodany, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie -1.

CMFCToolBarImages::AddImage

Dodaje mapę bitową do obrazów paska narzędzi.

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

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

Parametry

hbmp
[in] Uchwyt do mapy bitowej do dodania.

bSetBitPerPixel
[in] WARTOŚĆ TRUE, jeśli CMFCToolBarImages obiekt używa głębokości koloru (bitów na piksel) nowego obrazu; FAŁSZ, jeśli CMFCToolbarImages obiekt zachowuje bieżącą głębokość koloru.

imageList
[in] Odwołanie do obiektu zawierającego CMFCToolbarImages obraz do dodania.

nIndex
[in] Indeks w obiekcie źródłowym CMFCToolbarImages obrazu do dodania.

Wartość zwracana

Liczba obrazów paska narzędzi, które CMFCToolBarImages obiekt utrzymuje po pomyślnym dodaniu nowej mapy bitowej; -1, jeśli operacja nie powiodła się.

CMFCToolBarImages::CleanUp

static void __stdcall CleanUp();

Uwagi

CMFCToolBarImages::Clear

Zwalnia zasoby systemowe przydzielone przez obiekt CMFCToolbarImages .

void Clear();

CMFCToolBarImages::CMFCToolBarImages

CMFCToolBarImages Tworzy obiekt.

CMFCToolBarImages();

Uwagi

Tworzy obiekt, inicjuje CMFCToolBarImages aparat renderowania i ustawia rozmiar obrazu na wartość domyślną 16x15 pikseli. Użyj narzędzia CMFCToolBarImages::SetImageSize , aby zmienić rozmiar obrazu przed dodaniem obrazów.

CMFCToolBarImages::CopyImageToClipboard

BOOL CopyImageToClipboard(int iImage);

Parametry

[in] iImage

Wartość zwracana

Uwagi

CMFCToolBarImages::CopyTo

BOOL CopyTo(CMFCToolBarImages& imageList);

Parametry

[in] imageList

Wartość zwracana

Uwagi

CMFCToolBarImages::CreateFromImageList

Inicjuje obrazy paska narzędzi z obiektu klasy CImageList.

BOOL CreateFromImageList(const CImageList& imageList);

Parametry

imageList
[in] Lista obrazów, która ma być używana jako źródło obrazów paska narzędzi.

Wartość zwracana

Zawsze zwraca wartość TRUE.

Uwagi

Użyj tej funkcji, aby szybko zainicjować listę obrazów paska narzędzi z listy obrazów zewnętrznych.

CMFCToolBarImages::CreateRegionFromImage

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

Parametry

[in] Bmp
[in] clrTransparent

Wartość zwracana

Uwagi

CMFCToolBarImages::D eleteImage

Usuwa obraz zdefiniowany przez użytkownika, który ma określony indeks z obrazów paska narzędzi.

BOOL DeleteImage(int iImage);

Parametry

iImage
[in] Określa indeks zerowy obrazu do usunięcia.

Wartość zwracana

WARTOŚĆ TRUE, jeśli obraz został pomyślnie usunięty; FAŁSZ, jeśli indeks obrazu jest nieprawidłowy, CMFCToolbarImages obiekt jest tymczasowy, CMFCToolbarImages obiekt nie zawiera obrazów zdefiniowanych przez użytkownika lub jeśli wystąpił inny błąd.

CMFCToolBarImages::D raw

Rysuje pojedynczy obraz paska narzędzi.

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
[in] Wskaźnik do kontekstu urządzenia.

x
[in] Współrzędna X lewej strony prostokąta, w którym ma zostać narysowany obraz.

y
[in] Współrzędna Y w górnej części prostokąta, w którym ma zostać narysowany obraz.

iImageIndex
[in] Indeks na podstawie zera obrazu, który ma być wyświetlany.

bHilite
[in] WARTOŚĆ TRUE, jeśli obraz ma zostać wyróżniony; w przeciwnym razie FAŁSZ.

bDisabled
[in] WARTOŚĆ TRUE, jeśli obraz ma być rysowany w stylu wyłączonym; w przeciwnym razie FAŁSZ.

bIndeterminate
[in] WARTOŚĆ TRUE, jeśli obraz ma zostać narysowany w nieokreślonym stylu stanu; w przeciwnym razie FAŁSZ.

bShadow
[in] WARTOŚĆ TRUE, jeśli obraz ma zostać narysowany z cieniem kropli; w przeciwnym razie FAŁSZ.

bInactive
[in] WARTOŚĆ TRUE, jeśli obraz ma zostać narysowany w nieaktywnym stylu stanu; w przeciwnym razie FAŁSZ.

alphaSrc
[in] Wartość kanału alfa (nieprzezroczystości). Wartość 255 oznacza, że obraz jest rysowany nieprzezroczystym. Wartość 0 oznacza, że obraz jest rysowany przezroczystie. Ta wartość jest używana tylko dla 32-bitowych obrazów kolorów i obrazów, które wyświetlały styl szkła systemu Windows Vista.

Wartość zwracana

WARTOŚĆ TRUE, jeśli określony obraz został wyświetlony pomyślnie; FAŁSZ, jeśli indeks obrazu był nieprawidłowy lub wystąpił inny błąd.

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

[in] PDC
[in] Rect
[in] iImageIndex
[in] horzAlign
[in] vertAlign
[in] rectSrc
[in] alphaSrc

Wartość zwracana

Uwagi

CMFCToolBarImages::EnableRTL

static void __stdcall EnableRTL(BOOL bIsRTL = TRUE);

Parametry

[in] bIsRTL

Uwagi

CMFCToolBarImages::EndDrawImage

Zwalnia zasoby systemowe przydzielone przez cmFCToolBarImages::P repareDrawImage po narysowaniu obrazu paska narzędzi przez wywołanie polecenia CMFCToolBarImages::D raw.

void EndDrawImage(CAfxDrawState& ds);

Parametry

Ds
[in] Odwołanie do CAfxDrawState obiektu przekazanego PrepareDrawImage do metody .

CMFCToolBarImages::ExtractIcon

Zwraca ikonę z określonym indeksem obrazu z obrazów paska narzędzi.

HICON ExtractIcon(int nIndex);

Parametry

nIndex
[in] Indeks oparty na zera na liście obrazów, w którym znajduje się obraz do wyodrębnienia jako ikona.

Wartość zwracana

Uchwyt do wyodrębnionej ikony lub wartość NULL, jeśli nIndex jest poza zakresem.

CMFCToolBarImages::FillDitheredRect

Wypełnia prostokąt kolorami tła paska narzędzi.

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

Parametry

PDC
[in] Wskaźnik do kontekstu urządzenia.

Rect
[in] Współrzędne prostokąta do wypełnienia.

Uwagi

Użyj tej metody, aby wypełnić prostokąt kolorem, który jest średnią kolorów systemowych COLOR_BTNFACE i COLOR_BTNHIGHLIGHT. Jeśli system używa 256 lub mniej kolorów, prostokąt zostanie wypełniony dyżerowanym wzorcem tych dwóch kolorów.

CMFCToolBarImages::GetAlwaysLight

BOOL GetAlwaysLight() const;

Wartość zwracana

Uwagi

CMFCToolBarImages::GetCount

Zwraca liczbę obrazów na liście obrazów paska narzędzi.

int GetCount() const;

Wartość zwracana

Liczba obrazów w CMFCToolBarImages obiekcie.

CMFCToolBarImages::GetDisabledImageAlpha

Zwraca wartość kanału alfa (nieprzezroczystość), która jest używana dla wyłączonych obrazów.

static BYTE GetDisabledImageAlpha();

Wartość zwracana

Bieżąca wartość kanału alfa.

Uwagi

Możesz wywołać metodę CMFCToolBarImages::SetDisabledImageAlpha , aby zmienić wartość kanału alfa.

CMFCToolBarImages::GetFadedImageAlpha

static BYTE __stdcall GetFadedImageAlpha();

Wartość zwracana

Uwagi

CMFCToolBarImages::GetImageSize

Pobiera rozmiar obrazów paska narzędzi przechowywanych w pamięci (rozmiar źródła) lub rozmiar obrazów paska narzędzi rysowanych na ekranie (rozmiar docelowy).

SIZE GetImageSize(BOOL bDest=FALSE) const;

Parametry

bDest
[in] WARTOŚĆ TRUE w celu pobrania rozmiaru miejsca docelowego; FAŁSZ do pobrania rozmiaru obrazu źródłowego.

Wartość zwracana

Struktura SIZE określająca rozmiar obrazu w pikselach.

Uwagi

Rozmiar obrazu źródłowego to rozmiar obrazów przechowywanych w obiekcie CMFCToolbarImages . Możesz wywołać polecenie CMFCToolBarImages::SetImageSize , aby ustawić rozmiar źródła. Wartość domyślna to 16x15 pikseli.

Domyślnie rozmiar obrazu docelowego jest 0x0. Rozmiar miejsca docelowego określa się podczas wywoływania polecenia CMFCToolBarImages::P repareDrawImage. Metoda CMFCToolBarImages::EndDrawImage resetuje rozmiar docelowy do wartości domyślnej.

CMFCToolBarImages::GetImageWell

Zwraca uchwyt do mapy bitowej zawierającej wszystkie obrazy paska narzędzi.

HBITMAP GetImageWell() const;

Wartość zwracana

Uchwyt do mapy bitowej zawierającej obrazy paska narzędzi.

Uwagi

Obrazy paska narzędzi są przechowywane w wierszu w pojedynczej mapie bitowej znanej jako obraz. Aby znaleźć obraz paska narzędzi w obszarze obrazu, pomnóż indeks obrazu przez szerokość obrazów paska narzędzi (zobacz CMFCToolBarImages::GetImageSize), aby uzyskać przesunięcie poziome obrazu wewnątrz źródła obrazu.

CMFCToolBarImages::GetImageWellLight

HBITMAP GetImageWellLight() const;

Wartość zwracana

Uwagi

CMFCToolBarImages::GetLastImageRect

CRect GetLastImageRect() const;

Wartość zwracana

Uwagi

CMFCToolBarImages::GetLightPercentage

int GetLightPercentage() const;

Wartość zwracana

Uwagi

CMFCToolBarImages::GetMapTo3DColors

BOOL GetMapTo3DColors() const;

Wartość zwracana

Uwagi

CMFCToolBarImages::GetMask

HBITMAP GetMask(int iImage);

Parametry

[in] iImage

Wartość zwracana

Uwagi

CMFCToolBarImages::GetResourceOffset

Zwraca indeks obrazu dla określonego identyfikatora zasobu.

int GetResourceOffset(UINT uiResId) const;

Parametry

uiResId
[in] Identyfikator zasobu obrazu.

Wartość zwracana

Indeks obrazu, jeśli metoda zakończyła się pomyślnie; -1, jeśli obraz o określonym identyfikatorze zasobu nie istnieje.

CMFCToolBarImages::GetTransparentColor

COLORREF GetTransparentColor() const;

Wartość zwracana

Uwagi

CMFCToolBarImages::GrayImages

Szarości obrazów paska narzędzi, aby wyglądały na wyłączone.

BOOL GrayImages(int nGrayImageLuminancePercentage);

Parametry

nGrayImageLuminancePercentage
[in] Procent luminacji.

Wartość zwracana

Wartość TRUE, jeśli obrazy w kolekcji zostały pomyślnie wyszarane; w przeciwnym razie FAŁSZ.

Uwagi

Ta metoda modyfikuje obrazy pasków narzędzi przez średnio czerwone, zielone i niebieskie składniki każdego piksela i mnożenie wyniku przez nGrayImageLuminancePercentage podzielone przez 100. Jeśli nGrayImageLuminancePercentage ma wartość zero lub ujemną, zamiast tego zostanie użyta wartość domyślna 130.

Uwaga

Jeśli chcesz cofnąć zmianę, musisz ponownie załadować obrazy ze źródła. Można to zrobić, wywołując polecenie CMFCToolBarImages::Load lub CMFCToolBarImages::UpdateImage (tylko dla obrazów zdefiniowanych przez użytkownika) lub wywołując polecenie CMFCToolBarImages::Clear i dodając obrazy ponownie, wywołując polecenie CMFCToolBarImages::AddIcon lub CMFCToolBarImages::AddImages::AddImages.

CMFCToolBarImages::Is32BitTransparencySupported

Określa, czy system operacyjny obsługuje 32-bitowe mieszanie alfa.

static BOOL Is32BitTransparencySupported();

Wartość zwracana

Wartość TRUE, jeśli jest obsługiwane 32-bitowe mieszanie alfa; w przeciwnym razie FAŁSZ.

Uwagi

Użyj tej metody statycznej, aby określić w czasie wykonywania, czy system operacyjny obsługuje 32-bitowe mieszanie alfa. Ta funkcja jest obsługiwana w systemie Windows 2000 i nowszych wersjach.

CMFCToolBarImages::IsPreMultiplyAutoCheck

BOOL IsPreMultiplyAutoCheck() const;

Wartość zwracana

Uwagi

CMFCToolBarImages::IsReadOnly

Określa, czy obrazy paska narzędzi są tylko do odczytu.

BOOL IsReadOnly() const;

Wartość zwracana

Wartość TRUE, jeśli obrazy paska narzędzi są tylko do odczytu, w przeciwnym razie wartość FALSE.

Uwagi

CMFCToolbarImages Obiekt jest tylko do odczytu, gdy mapa bitowa z obrazami paska narzędzi została załadowana z pliku tylko do odczytu lub gdy mapa bitowa została skopiowana przy użyciu CMFCToolBarImages::CopyTemp metody .

CMFCToolBarImages::IsRTL

Określa, czy obsługa od prawej do lewej (RTL) jest włączona.

static BOOL IsRTL();

Wartość zwracana

Wartość TRUE, jeśli jest włączona obsługa biblioteki RTL; w przeciwnym razie FAŁSZ.

Uwagi

Obsługa biblioteki RTL jest używana, gdy aplikacja jest zlokalizowana w języku odczytanym od prawej do lewej, na przykład arabskim, hebrajskim, perskim lub urdu.

CMFCToolBarImages::IsUserImagesList

Określa, czy ten zestaw obrazów paska narzędzi zawiera obrazy zdefiniowane przez użytkownika.

BOOL IsUserImagesList() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli CMFCToolBarImages obiekt zawiera obrazy paska narzędzi zdefiniowanego przez użytkownika; w przeciwnym razie WARTOŚĆ FALSE.

CMFCToolBarImages::IsValid

Wskazuje, czy ten zestaw obrazów paska narzędzi zawiera prawidłowy obraz paska narzędzi.

BOOL IsValid() const;

Wartość zwracana

Wartość TRUE, jeśli CMFCToolBarImages obiekt jest prawidłowy; w przeciwnym razie wartość FALSE.

Uwagi

Obiekt CMFCToolBarImages jest nieprawidłowy, gdy jego uchwyt do mapy bitowej z obrazami paska narzędzi ma wartość NULL.

CMFCToolBarImages::Load

Ładuje obrazy paska narzędzi z zasobów systemowych lub z pliku.

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

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

Parametry

uiResID
[in] Identyfikator zasobu mapy bitowej.

hinstRes
[in] Wystąpienie biblioteki DLL zasobu.

bAdd
[in] WARTOŚĆ TRUE, aby dodać załadowaną mapę bitową do istniejącej mapy bitowej lub wartość FALSE, aby zastąpić istniejącą mapę bitową.

lpszBmpFileName
[in] Ścieżka do pliku dysku, z którego ma być ładowana mapa bitowa.

nMaxFileSize
[in] Maksymalna liczba bajtów w pliku mapy bitowej; lub 0, aby załadować mapę bitową niezależnie od rozmiaru pliku. Jeśli rozmiar pliku przekracza ten maksymalny rozmiar, metoda zwraca wartość FALSE i nie ładuje mapy bitowej.

Wartość zwracana

Wartość TRUE, jeśli mapa bitowa została załadowana pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Jeśli plik ma atrybut tylko do odczytu, lista obrazów jest oznaczona jako tylko do odczytu.

CMFCToolBarImages::LoadStr

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

Parametry

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

Wartość zwracana

Uwagi

CMFCToolBarImages::MapFromSysColor

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

Parametry

[in] Kolor
[in] bUseRGBQUAD

Wartość zwracana

Uwagi

CMFCToolBarImages::MapTo3dColors

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

Parametry

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

Wartość zwracana

Uwagi

CMFCToolBarImages::MapToSysColor

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

Parametry

[in] Kolor
[in] bUseRGBQUAD

Wartość zwracana

Uwagi

CMFCToolBarImages::MapToSysColorAlpha

static COLORREF __stdcall MapToSysColorAlpha(COLORREF color);

Parametry

[in] Kolor

Wartość zwracana

Uwagi

CMFCToolBarImages::Mirror

Zamienia obrazy paska narzędzi na ich obraz dublowany w poziomie.

BOOL Mirror();

Wartość zwracana

WARTOŚĆ TRUE, jeśli obrazy zostały pomyślnie zdublowane; w przeciwnym razie FAŁSZ.

Uwagi

Ta metoda służy do obsługi systemów zapisu od prawej do lewej.

CMFCToolBarImages::MirrorBitmap

Zastępuje mapę bitową obrazem dublowania poziomego.

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

Parametry

hbmp
[in, out] Uchwyt do map bitowych do dublowania.

cxImage
[in] Szerokość obrazu w pikselach.

Wartość zwracana

WARTOŚĆ TRUE, jeśli obraz został pomyślnie zdublowany; w przeciwnym razie FAŁSZ.

Uwagi

Ta funkcja jest używana do obsługi systemów zapisu od prawej do lewej.

CMFCToolBarImages::MirrorBitmapVert

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

Parametry

[in] hbmp
[in] cyImage

Wartość zwracana

Uwagi

CMFCToolBarImages::MirrorVert

BOOL MirrorVert();

Wartość zwracana

Uwagi

CMFCToolBarImages::OnSysColorChange

void OnSysColorChange();

Uwagi

CMFCToolBarImages::P reMultiplyAlpha

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

BOOL PreMultiplyAlpha(HBITMAP hbmp);

Parametry

[in] hbmp
[in] bAutoCheckPremlt

Wartość zwracana

Uwagi

CMFCToolBarImages::m_bDisableTrueColorAlpha

Wartość TRUE, jeśli mieszanie alfacolor (kolor 32-bitowy) jest wyłączone.

static BOOL m_bDisableTrueColorAlpha;

Uwagi

Ustaw tę zmienną składową na WARTOŚĆ FALSE, aby włączyć łączenie truecolor alfa-blending dla obrazów pasków narzędzi.

Wartość domyślna to TRUE dla zgodności z poprzednimi wersjami.

CMFCToolBarImages::P repareDrawImage

Przydziela zasoby wymagane do narysowania obrazu paska narzędzi o określonym rozmiarze.

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

Parametry

Ds
[in] Odwołanie do CAfxDrawState struktury, która przechowuje przydzielone zasoby między etapami renderowania obrazów.

sizeImageDest
[in] Określa rozmiar obrazu docelowego.

bFadeInactive
[in] WARTOŚĆ TRUE, jeśli chcesz, aby nieaktywne obrazy są rysowane wyblakłe.

Wartość zwracana

Wartość TRUE, jeśli zasoby wymagane do narysowania obrazu paska narzędzi zostały pomyślnie przydzielone, w przeciwnym razie wartość FALSE.

Uwagi

Po wywołaniu tej metody można wywołać metodę CMFCToolBarImages::D raw dowolną liczbę razy. Po zakończeniu rysowania należy wywołać polecenie CMFCToolBarImages::EndDrawImage , aby zwolnić zasoby przydzielone przez PrepareDrawImageprogram .

CMFCToolBarImages::Save

Przechowuje obrazy paska narzędzi w pliku, jeśli ten zestaw obrazów paska narzędzi zawiera obrazy zdefiniowane przez użytkownika.

BOOL Save(LPCTSTR lpszBmpFileName=NULL);

Parametry

lpszBmpFileName
Ścieżka do pliku dysku.

Wartość zwracana

WARTOŚĆ TRUE, jeśli obrazy paska narzędzi zostały zapisane pomyślnie; w przeciwnym razie FAŁSZ.

Uwagi

Wywołaj tę metodę, aby zapisać obrazy zdefiniowane przez użytkownika w pliku dysku. Jeśli lpszBmpFileName ma wartość NULL, metoda przechowuje mapę bitową w pliku, z którego mapa bitowa została załadowana przez metodę CMFCToolBarImages::Load .

CMFCToolBarImages::SetAlwaysLight

void SetAlwaysLight(BOOL bAlwaysLight = TRUE);

Parametry

[in] bAlwaysLight

Uwagi

CMFCToolBarImages::SetDisabledImageAlpha

Ustawia wartość kanału alfa (nieprzezroczystości), która jest używana dla wyłączonych obrazów.

static void SetDisabledImageAlpha(BYTE nValue);

Parametry

nValue
[in] Nowa wartość kanału alfa.

Uwagi

Użyj tej metody, aby ustawić niestandardową wartość alfa dla wyłączonych obrazów. Wartość domyślna to 127, co powoduje, że wyłączone obrazy przycisków są półprzezroczyste. Jeśli ustawisz wartość 0, wyłączone obrazy będą całkowicie przezroczyste. Jeśli ustawisz wartość 255, wyłączone obrazy będą całkowicie nieprzezroczyste.

CMFCToolBarImages::SetFadedImageAlpha

static void __stdcall SetFadedImageAlpha(BYTE nValue);

Parametry

[in] nValue

Uwagi

CMFCToolBarImages::SetImageSize

Ustawia rozmiar każdego obrazu paska narzędzi (rozmiar źródła).

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

Parametry

sizeImage
[in] Nowy rozmiar obrazów paska narzędzi.

Uwagi

Domyślnie rozmiar obrazu paska narzędzi to 16x15 pikseli. Wywołaj tę metodę, jeśli chcesz użyć obrazów paska narzędzi o innym rozmiarze.

CMFCToolBarImages::SetLightPercentage

void SetLightPercentage(int nValue);

Parametry

[in] nValue

Uwagi

CMFCToolBarImages::SetMapTo3DColors

void SetMapTo3DColors(BOOL bMapTo3DColors);

Parametry

[in] bMapTo3DColors

Uwagi

CMFCToolBarImages::SetPreMultiplyAutoCheck

void SetPreMultiplyAutoCheck(BOOL bAuto = TRUE);

Parametry

[in] bAuto

Uwagi

CMFCToolBarImages::SetSingleImage

void SetSingleImage();

Uwagi

CMFCToolBarImages::SetTransparentColor

Ustawia przezroczysty kolor obrazów paska narzędzi.

COLORREF SetTransparentColor(COLORREF clrTransparent);

Parametry

clrTransparent
[in] Wartość RGB.

Wartość zwracana

Poprzedni przezroczysty kolor.

Uwagi

W przypadku wywołania narzędzia CMFCToolBarImages::D raw metoda nie rysuje żadnego piksela zgodnego z kolorem określonym przez clrTransparent.

CMFCToolBarImages::UpdateImage

Aktualizuje obraz paska narzędzi zdefiniowanego przez użytkownika z mapy bitowej.

BOOL UpdateImage(
    int iImage,
    HBITMAP hbmp);

Parametry

iImage
[in] Indeks obrazu oparty na zerach do zaktualizowania.

hbmp
[in] Uchwyt do mapy bitowej, z którego ma być aktualizowany obraz.

Wartość zwracana

WARTOŚĆ TRUE, jeśli obraz został pomyślnie zaktualizowany; FAŁSZ, jeśli lista obrazów nie jest zdefiniowana przez użytkownika ani tymczasowa.

CMFCToolBarImages::ConvertTo32Bits

Konwertuje podkreślone mapy bitowe na 32 obrazy bpp.

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

Parametry

clrTransparent
Określa przezroczysty kolor podkreślonej mapy bitowej.

Uwagi

CMFCToolBarImages::GetBitsPerPixel

Zwraca bieżącą rozdzielczość podkreślonych obrazów.

int GetBitsPerPixel() const;

Wartość zwracana

Wartość całkowita reprezentująca bieżącą rozdzielczość podkreślonych obrazów w bitach na piksel (bpp).

Uwagi

CMFCToolBarImages::GetScale

Zwraca bieżący współczynnik skali podkreślenia obrazów.

double GetScale() const;

Wartość zwracana

Wartość reprezentująca bieżący współczynnik skalowania.

Uwagi

CMFCToolBarImages::IsScaled

Informuje, czy podkreślone obrazy są skalowane, czy nie.

BOOL IsScaled () const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli podkreślone obrazy są skalowane; w przeciwnym razie FAŁSZ.

Uwagi

CMFCToolBarImages::SmoothResize

Płynnie zmienia rozmiar podkreślone obrazy.

BOOL SmoothResize(double dblImageScale);

Parametry

dblImageScale
Współczynnik skali.

Wartość zwracana

Wartość TRUE, jeśli zmiana rozmiaru powiedzie się; w przeciwnym razie FAŁSZ.

Uwagi

Zobacz też

Wykres hierarchii
Klasy
Klasa CObject
Klasa CMFCToolBar
Klasa CMFCToolBarButton