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
Członkowie
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 | Aktualizacje obraz paska narzędzi zdefiniowany 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
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.
Bdodaj
[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] Bdodaj
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
Aktualizacje obraz paska narzędzi zdefiniowany 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
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla