Класс CMFCToolBarImages
Изображения на панели инструментов. Класс CMFCToolBarImages управляет изображениями панели инструментов, загруженными из ресурсов приложения или из файлов.
Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.
Синтаксис
class CMFCToolBarImages : public CObject
Участники
Открытые конструкторы
| Имя | Описание |
|---|---|
| CMFCToolBarImages::CMFCToolBarImages | Формирует объект CMFCToolBarImages. |
Открытые методы
| Имя | Описание |
|---|---|
| CMFCToolBarImages::AdaptColors | |
| CMFCToolBarImages::AddIcon | Добавляет значок на изображения панели инструментов. |
| CMFCToolBarImages::AddImage | Добавляет растровое изображение на изображения панели инструментов. |
| CMFCToolBarImages::CleanUp | |
| CMFCToolBarImages::Clear | Освобождает системные ресурсы, выделенные этому объекту. |
| CMFCToolBarImages::ConvertTo32Bits | Преобразует подчеркнутые растровые изображения в 32 изображения bpp. |
| CMFCToolBarImages::CopyImageToClipboard | |
| CMFCToolBarImages::CopyTo | |
| CMFCToolBarImages::CreateFromImageList | Инициализирует изображения панели инструментов из списка изображений ( класс CImageList). |
| CMFCToolBarImages::CreateRegionFromImage | |
| CMFCToolBarImages::D eleteImage | Удаляет изображение с указанным индексом из изображений панели инструментов, если этот набор изображений панели инструментов содержит пользовательские изображения. |
| CMFCToolBarImages::D raw | Рисует изображение одной панели инструментов (кнопка). |
| CMFCToolBarImages::D rawEx | |
| CMFCToolBarImages::EnableRTL | |
| CMFCToolBarImages::EndDrawImage | Освобождает системные ресурсы после рисования изображения панели инструментов. |
| CMFCToolBarImages::ExtractIcon | Возвращает значок с указанным индексом изображения из изображений панели инструментов. |
| CMFCToolBarImages::FillDitheredRect | Заполняет прямоугольник с помощью кисти с цветами фона панели инструментов. |
| CMFCToolBarImages::GetAlwaysLight | |
| CMFCToolBarImages::GetBitsPerPixel | Возвращает текущее разрешение подчеркнутых изображений. |
| CMFCToolBarImages::GetCount | Возвращает количество изображений на панели инструментов. |
| CMFCToolBarImages::GetDisabledImageAlpha | Возвращает значение альфа-канала, используемое для отключенных образов. |
| CMFCToolBarImages::GetFadedImageAlpha | |
| CMFCToolBarImages::GetImageSize | Извлекает либо размер изображений панели инструментов, хранящихся в памяти (размер источника), либо размер изображений панели инструментов, рисуемых на экране (размер назначения). |
| CMFCToolBarImages::GetImageWell | Возвращает дескриптор растрового изображения, содержащего все изображения панели инструментов. |
| CMFCToolBarImages::GetImageWellLight | |
| CMFCToolBarImages::GetLastImageRect | |
| CMFCToolBarImages::GetLightPercentage | |
| CMFCToolBarImages::GetMapTo3DColors | |
| CMFCToolBarImages::GetMask | |
| CMFCToolBarImages::GetResourceOffset | Возвращает индекс изображения для указанного идентификатора ресурса. |
| CMFCToolBarImages::GetScale | Возвращает текущее соотношение масштаба подчеркнутых изображений. |
| CMFCToolBarImages::GetTransparentColor | |
| CMFCToolBarImages::GrayImages | Серый цвет изображений панели инструментов, чтобы сделать их отключенными. |
| CMFCToolBarImages::Is32BitTransparencySupported | Определяет, поддерживает ли операционная система 32-разрядную альфа-смесь. |
| CMFCToolBarImages::IsPreMultiplyAutoCheck | |
| CMFCToolBarImages::IsRTL | Определяет, включена ли поддержка справа налево (RTL). |
| CMFCToolBarImages::IsReadOnly | Определяет, доступны ли изображения панели инструментов только для чтения. |
| CMFCToolBarImages::IsScaled | Указывает, масштабируются ли подчеркнутые изображения. |
| CMFCToolBarImages::IsUserImagesList | Определяет, содержит ли этот набор изображений панели инструментов, определенных пользователем. |
| CMFCToolBarImages::IsValid | Определяет, содержит ли этот набор изображений панели инструментов допустимый образ панели инструментов. |
| CMFCToolBarImages::Load | Загружает образы панели инструментов из системных ресурсов или из файла. |
| CMFCToolBarImages::LoadStr | |
| CMFCToolBarImages::MapFromSysColor | |
| CMFCToolBarImages::MapTo3dColors | |
| CMFCToolBarImages::MapToSysColor | |
| CMFCToolBarImages::MapToSysColorAlpha | |
| CMFCToolBarImages::Mirror | Горизонтально зеркально отражает все изображения панели инструментов. |
| CMFCToolBarImages::MirrorBitmap | Горизонтально зеркально отражает растровое изображение. |
| CMFCToolBarImages::MirrorBitmapVert | |
| CMFCToolBarImages::MirrorVert | |
| CMFCToolBarImages::OnSysColorChange | |
| CMFCToolBarImages::P repareDrawImage | Выделяет ресурсы, необходимые для рисования изображения панели инструментов с указанным размером. |
| CMFCToolBarImages::Save | Сохраняет изображения панели инструментов в файле, если этот набор изображений панели инструментов содержит пользовательские изображения. |
| CMFCToolBarImages::SetAlwaysLight | |
| CMFCToolBarImages::SetDisabledImageAlpha | Задает значение альфа-канала, используемое для отключенных образов. |
| CMFCToolBarImages::SetFadedImageAlpha | |
| CMFCToolBarImages::SetImageSize | Задает размер изображения панели инструментов (исходный размер). |
| CMFCToolBarImages::SetLightPercentage | |
| CMFCToolBarImages::SetMapTo3DColors | |
| CMFCToolBarImages::SetPreMultiplyAutoCheck | |
| CMFCToolBarImages::SetSingleImage | |
| CMFCToolBarImages::SetTransparentColor | Задает прозрачный цвет изображений панели инструментов. |
| CMFCToolBarImages::SmoothResize | Плавное изменение размера подчеркнутых изображений. |
| CMFCToolBarImages::UpdateImage | Обновляет определяемое пользователем изображение панели инструментов из растрового изображения. |
Защищенные методы
| Имя | Описание |
|---|---|
| CMFCToolBarImages::P reMultiplyAlpha |
Элементы данных
| Имя | Описание |
|---|---|
| CMFCToolBarImages::m_bDisableTrueColorAlpha | Значение TRUE, если альфа-смешивание truecolor (32-разрядный цвет) отключено. |
Замечания
Полное растровое изображение изображений панели инструментов, управляемых CMFCToolbarImages одним или несколькими небольшими изображениями панели инструментов (кнопками) фиксированного размера.
Пример
В следующем примере показано, как настроить CMFCToolBarImages объект с помощью различных методов в CMFCToolBarImages классе. В примере показано, как задать размер изображения панели инструментов, загрузить изображение и задать прозрачный цвет изображения. Этот фрагмент кода является частью примера демонстрации Visual Studio.
CMFCToolBarImages m_Image;
m_Image.SetImageSize(CSize(32, 32));
m_Image.Load(IDR_START);
m_Image.SetTransparentColor(RGB(255, 0, 255));
Иерархия наследования
CMFCToolBarImages
Требования
Заголовок: afxtoolbarimages.h
CMFCToolBarImages::AdaptColors
void AdaptColors(
COLORREF clrBase,
COLORREF clrTone);
Параметры
[in] clrBase
[in] clrTone
Замечания
CMFCToolBarImages::AddIcon
Добавляет значок в список изображений панели инструментов.
int AddIcon(
HICON hIcon,
BOOL bAlphaBlend=FALSE);
Параметры
hIcon
[in] Дескриптор значка, который нужно добавить.
bAlphaBlend
[in] ЗНАЧЕНИЕ TRUE, если этот значок используется с альфа-смешения; в противном случае ЗНАЧЕНИЕ FALSE.
Возвращаемое значение
Отсчитываемый от нуля индекс изображения панели инструментов, добавленного при успешном выполнении метода; в противном случае - 1.
CMFCToolBarImages::AddImage
Добавляет растровое изображение на изображения панели инструментов.
int AddImage(
HBITMAP hbmp,
BOOL bSetBitPerPixel=FALSE);
int AddImage(
const CMFCToolBarImages& imageList,
int nIndex);
Параметры
hbmp
[in] Дескриптор для добавления растрового изображения.
bSetBitPerPixel
[in] TRUE, если CMFCToolBarImages объект использует глубину цвета (биты на пиксель) нового изображения; Значение FALSE, если CMFCToolbarImages объект сохраняет текущую глубину цвета.
imageList
[in] Ссылка на CMFCToolbarImages объект, содержащий добавляемое изображение.
nIndex
[in] Индекс в исходном CMFCToolbarImages объекте изображения, добавляемого.
Возвращаемое значение
Количество изображений панели инструментов, которые CMFCToolBarImages объект сохраняет после успешного добавления нового растрового изображения; -1, если операция завершилась ошибкой.
CMFCToolBarImages::CleanUp
static void __stdcall CleanUp();
Замечания
CMFCToolBarImages::Clear
Освобождает системные ресурсы, выделенные объектом CMFCToolbarImages .
void Clear();
CMFCToolBarImages::CMFCToolBarImages
Формирует объект CMFCToolBarImages.
CMFCToolBarImages();
Замечания
CMFCToolBarImages Создает объект, инициализирует его обработчик отрисовки и задает размер изображения значением по умолчанию 16x15 пикселей. Используйте CMFCToolBarImages::SetImageSize , чтобы изменить размер изображения перед добавлением изображений.
CMFCToolBarImages::CopyImageToClipboard
BOOL CopyImageToClipboard(int iImage);
Параметры
[in] iImage
Возвращаемое значение
Замечания
CMFCToolBarImages::CopyTo
BOOL CopyTo(CMFCToolBarImages& imageList);
Параметры
[in] imageList
Возвращаемое значение
Замечания
CMFCToolBarImages::CreateFromImageList
Инициализирует изображения панели инструментов из объекта класса CImageList.
BOOL CreateFromImageList(const CImageList& imageList);
Параметры
imageList
[in] Список изображений, используемый в качестве источника для изображений панели инструментов.
Возвращаемое значение
Всегда возвращает значение TRUE.
Замечания
Эта функция позволяет быстро инициализировать список изображений панели инструментов из внешнего списка изображений.
CMFCToolBarImages::CreateRegionFromImage
static HRGN __stdcall CreateRegionFromImage(
HBITMAP bmp,
COLORREF clrTransparent);
Параметры
[in] bmp
[in] clrTransparent
Возвращаемое значение
Замечания
CMFCToolBarImages::D eleteImage
Удаляет определяемое пользователем изображение с указанным индексом из изображений панели инструментов.
BOOL DeleteImage(int iImage);
Параметры
iImage
[in] Указывает отсчитываемый от нуля индекс образа для удаления.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если изображение было успешно удалено; ЗНАЧЕНИЕ FALSE, если индекс изображения недопустим, CMFCToolbarImages объект является временным, CMFCToolbarImages объект не содержит определяемых пользователем образов или если произошла другая ошибка.
CMFCToolBarImages::D raw
Рисует изображение одной панели инструментов.
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);
Параметры
pDC
[in] Указатель на контекст устройства.
x
[in] Координата X левой стороны прямоугольника, в которой нужно нарисовать изображение.
г
[in] Координата Y верхней части прямоугольника, в которой нужно нарисовать изображение.
iImageIndex
[in] Отсчитываемый от нуля индекс изображения.
bHilite
[in] ЗНАЧЕНИЕ TRUE, если изображение должно быть выделено; в противном случае ЗНАЧЕНИЕ FALSE.
bDisabled
[in] ЗНАЧЕНИЕ TRUE, если изображение должно быть нарисовано в отключенном стиле; в противном случае ЗНАЧЕНИЕ FALSE.
bIndeterminate
[in] ЗНАЧЕНИЕ TRUE, если изображение должно быть нарисовано в неопределенном стиле состояния; в противном случае ЗНАЧЕНИЕ FALSE.
bShadow
[in] ЗНАЧЕНИЕ TRUE, если изображение должно быть нарисовано с тенью падения; в противном случае ЗНАЧЕНИЕ FALSE.
bInactive
[in] ЗНАЧЕНИЕ TRUE, если изображение должно быть нарисовано в неактивном стиле состояния; в противном случае ЗНАЧЕНИЕ FALSE.
alphaSrc
[in] Значение альфа-канала (непрозрачность). Значение 255 означает, что изображение рисуется непрозрачным. Значение 0 означает, что изображение рисуется прозрачным. Это значение используется только для 32-разрядных цветовых изображений и для изображений, отображающих стиль стекла Windows Vista.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если указанное изображение было успешно отображено; Значение FALSE, если индекс изображения был недопустимым или произошла другая ошибка.
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);
Параметры
[in] PDC
[in] rect
[in] iImageIndex
[in] horzAlign
[in] vertAlign
[in] rectSrc
[in] alphaSrc
Возвращаемое значение
Замечания
CMFCToolBarImages::EnableRTL
static void __stdcall EnableRTL(BOOL bIsRTL = TRUE);
Параметры
[in] bIsRTL
Замечания
CMFCToolBarImages::EndDrawImage
Освобождает системные ресурсы, выделенные CMFCToolBarImages::P repareDrawImage после рисования изображения панели инструментов путем вызова CMFCToolBarImages::D raw.
void EndDrawImage(CAfxDrawState& ds);
Параметры
ds
[in] Ссылка на объект, переданный CAfxDrawState методу PrepareDrawImage .
CMFCToolBarImages::ExtractIcon
Возвращает значок с указанным индексом изображения из изображений панели инструментов.
HICON ExtractIcon(int nIndex);
Параметры
nIndex
[in] Отсчитываемый от нуля индекс в списке изображений, по которому извлекается изображение в виде значка.
Возвращаемое значение
Дескриптор извлеченного значка или NULL, если nIndex выходит за пределы диапазона.
CMFCToolBarImages::FillDitheredRect
Заполняет прямоугольник цветом фона панели инструментов.
static void FillDitheredRect(
CDC* pDC,
const CRect& rect);
Параметры
pDC
[in] Указатель на контекст устройства.
rect
[in] Координаты прямоугольника для заливки.
Замечания
Используйте этот метод, чтобы заполнить прямоугольник цветом, который является средним значением системных цветов COLOR_BTNFACE и COLOR_BTNHIGHLIGHT. Если в системе используется 256 или меньше цветов, прямоугольник будет заполнен рифленным шаблоном этих двух цветов.
CMFCToolBarImages::GetAlwaysLight
BOOL GetAlwaysLight() const;
Возвращаемое значение
Замечания
CMFCToolBarImages::GetCount
Возвращает количество изображений в списке изображений панели инструментов.
int GetCount() const;
Возвращаемое значение
Количество изображений в объекте CMFCToolBarImages .
CMFCToolBarImages::GetDisabledImageAlpha
Возвращает значение альфа-канала (непрозрачность), используемое для отключенных образов.
static BYTE GetDisabledImageAlpha();
Возвращаемое значение
Текущее значение альфа-канала.
Замечания
Чтобы изменить значение альфа-канала, можно вызвать CMFCToolBarImages::SetDisabledImageAlpha .
CMFCToolBarImages::GetFadedImageAlpha
static BYTE __stdcall GetFadedImageAlpha();
Возвращаемое значение
Замечания
CMFCToolBarImages::GetImageSize
Извлекает либо размер изображений панели инструментов, хранящихся в памяти (размер источника), либо размер изображений панели инструментов, рисуемых на экране (размер назначения).
SIZE GetImageSize(BOOL bDest=FALSE) const;
Параметры
bDest
[in] ЗНАЧЕНИЕ TRUE для получения целевого размера; ЗНАЧЕНИЕ FALSE для получения размера исходного изображения.
Возвращаемое значение
Структура SIZE , указывающая размер изображения в пикселях.
Замечания
Размер исходного изображения — это размер изображений, хранящихся в объекте CMFCToolbarImages . Чтобы задать исходный размер, можно вызвать CMFCToolBarImages::SetImageSize . Значение по умолчанию — 16x15 пикселей.
По умолчанию размер целевого образа 0x0. Размер назначения указывается при вызове CMFCToolBarImages::P repareDrawImage. Метод CMFCToolBarImages::EndDrawImage сбрасывает размер назначения до значения по умолчанию.
CMFCToolBarImages::GetImageWell
Возвращает дескриптор растрового изображения, содержащего все изображения панели инструментов.
HBITMAP GetImageWell() const;
Возвращаемое значение
Дескриптор растрового изображения, содержащего изображения панели инструментов.
Замечания
Изображения панели инструментов хранятся в строке в одном растровом рисунке, который хорошо известен как изображение. Чтобы найти изображение панели инструментов в изображении хорошо, умножьте индекс изображения на ширину изображений панели инструментов (см . cmFCToolBarImages::GetImageSize), чтобы получить горизонтальное смещение изображения внутри изображения.
CMFCToolBarImages::GetImageWellLight
HBITMAP GetImageWellLight() const;
Возвращаемое значение
Замечания
CMFCToolBarImages::GetLastImageRect
CRect GetLastImageRect() const;
Возвращаемое значение
Замечания
CMFCToolBarImages::GetLightPercentage
int GetLightPercentage() const;
Возвращаемое значение
Замечания
CMFCToolBarImages::GetMapTo3DColors
BOOL GetMapTo3DColors() const;
Возвращаемое значение
Замечания
CMFCToolBarImages::GetMask
HBITMAP GetMask(int iImage);
Параметры
[in] iImage
Возвращаемое значение
Замечания
CMFCToolBarImages::GetResourceOffset
Возвращает индекс изображения для указанного идентификатора ресурса.
int GetResourceOffset(UINT uiResId) const;
Параметры
uiResId
[in] Идентификатор ресурса изображения.
Возвращаемое значение
Индекс изображения, если метод выполнен успешно; -1, если изображение с указанным идентификатором ресурса не существует.
CMFCToolBarImages::GetTransparentColor
COLORREF GetTransparentColor() const;
Возвращаемое значение
Замечания
CMFCToolBarImages::GrayImages
Серый цвет изображений панели инструментов, чтобы сделать их отключенными.
BOOL GrayImages(int nGrayImageLuminancePercentage);
Параметры
nGrayImageLuminancePercentage
[in] Процент свечения.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если изображения в коллекции были успешно серыми; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Этот метод изменяет изображения панели инструментов путем усреднения красных, зеленых и синих компонентов каждого пикселя и умножения результата на nGrayImageLuminancePercentage , разделенных на 100. Если nGrayImageLuminancePercentage равно нулю или отрицательному, вместо этого используется значение по умолчанию 130.
Примечание.
Если вы хотите отменить изменение, необходимо перезагрузить изображения из источника. Это можно сделать, вызвав CMFCToolBarImages::Load или CMFCToolBarImages::UpdateImage (только для пользовательских изображений), или вызвав CMFCToolBarImages::Clear и добавив изображения, вызвав CMFCToolBarImages::AddIcon или CMFCToolBarImages::AddIcon или CMFCToolBarImages::AddImage.
CMFCToolBarImages::Is32BitTransparencySupported
Указывает, поддерживает ли операционная система 32-разрядную альфа-смесь.
static BOOL Is32BitTransparencySupported();
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если поддерживается 32-разрядная альфа-смесь; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Используйте этот статический метод, чтобы определить, поддерживает ли операционная система 32-разрядную альфа-смесь. Эта функция поддерживается в Windows 2000 и более поздних версиях.
CMFCToolBarImages::IsPreMultiplyAutoCheck
BOOL IsPreMultiplyAutoCheck() const;
Возвращаемое значение
Замечания
CMFCToolBarImages::IsReadOnly
Указывает, доступны ли изображения панели инструментов только для чтения.
BOOL IsReadOnly() const;
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если изображения панели инструментов доступны только для чтения, в противном случае — FALSE.
Замечания
Объект CMFCToolbarImages доступен только для чтения, если растровое изображение с изображениями панели инструментов было загружено из файла, доступного только для чтения, или при копировании растрового CMFCToolBarImages::CopyTemp изображения с помощью метода.
CMFCToolBarImages::IsRTL
Указывает, включена ли поддержка справа налево (RTL).
static BOOL IsRTL();
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если включена поддержка RTL; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Поддержка RTL используется при локализации приложения на язык, который считывается справа налево, например арабский, иврит, персидской или урду.
CMFCToolBarImages::IsUserImagesList
Указывает, содержит ли этот набор изображений панели инструментов, определенных пользователем.
BOOL IsUserImagesList() const;
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если CMFCToolBarImages объект содержит пользовательские образы панели инструментов; в противном случае — ЗНАЧЕНИЕ FALSE.
CMFCToolBarImages::IsValid
Указывает, содержит ли этот набор изображений панели инструментов допустимый образ панели инструментов.
BOOL IsValid() const;
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если объект является допустимым CMFCToolBarImages ; в противном случае — ЗНАЧЕНИЕ FALSE.
Замечания
Объект CMFCToolBarImages недопустим, если его дескриптор растрового изображения с изображениями панели инструментов имеет значение NULL.
CMFCToolBarImages::Load
Загружает образы панели инструментов из системных ресурсов или из файла.
BOOL Load(
UINT uiResID,
HINSTANCE hinstRes=NULL,
BOOL bAdd=FALSE);
BOOL Load(
LPCTSTR lpszBmpFileName,
DWORD nMaxFileSize = 819200);
Параметры
uiResID
[in] Идентификатор ресурса растрового изображения.
hinstRes
[in] Экземпляр библиотеки DLL ресурсов.
bAdd
[in] Значение TRUE, чтобы добавить загруженную растровую карту в существующую растровую карту или false, чтобы заменить существующее растровое изображение.
lpszBmpFileName
[in] Путь к файлу диска, из которого необходимо загрузить растровое изображение.
nMaxFileSize
[in] Максимальное число байтов в растровом файле; или 0, чтобы загрузить растровое изображение независимо от размера файла. Если размер файла превышает этот максимальный размер, метод возвращает значение FALSE и не загружает растровое изображение.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если растровое изображение было загружено успешно; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Если файл имеет атрибут только для чтения, список изображений помечается как доступный только для чтения.
CMFCToolBarImages::LoadStr
BOOL LoadStr(
LPCTSTR lpszResourceName,
HINSTANCE hinstRes = NULL,
BOOL bAdd = FALSE);
Параметры
[in] lpszResourceName
[in] hinstRes
[in] bAdd
Возвращаемое значение
Замечания
CMFCToolBarImages::MapFromSysColor
static COLORREF __stdcall MapFromSysColor(
COLORREF color,
BOOL bUseRGBQUAD = TRUE);
Параметры
[in] Цвет
[in] bUseRGBQUAD
Возвращаемое значение
Замечания
CMFCToolBarImages::MapTo3dColors
BOOL MapTo3dColors(
BOOL bUseRGBQUAD = TRUE,
COLORREF clrSrc = (COLORREF)-1,
COLORREF clrDest = (COLORREF)-1);
Параметры
[in] bUseRGBQUAD
[in] clrSrc
[in] clrDest
Возвращаемое значение
Замечания
CMFCToolBarImages::MapToSysColor
static COLORREF __stdcall MapToSysColor(
COLORREF color,
BOOL bUseRGBQUAD = TRUE);
Параметры
[in] Цвет
[in] bUseRGBQUAD
Возвращаемое значение
Замечания
CMFCToolBarImages::MapToSysColorAlpha
static COLORREF __stdcall MapToSysColorAlpha(COLORREF color);
Параметры
[in] Цвет
Возвращаемое значение
Замечания
CMFCToolBarImages::Mirror
Заменяет изображения панели инструментов горизонтальным зеркальным изображением.
BOOL Mirror();
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если изображения были успешно зеркальными; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Этот метод используется для поддержки систем записи справа налево.
CMFCToolBarImages::MirrorBitmap
Заменяет растровое изображение горизонтальным зеркальным изображением.
static BOOL MirrorBitmap(
HBITMAP& hbmp,
int cxImage);
Параметры
hbmp
[in, out] Дескриптор для отображения растрового изображения.
cxImage
[in] Ширина изображения в пикселях.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если изображение успешно зеркально; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Эта функция используется для поддержки систем записи справа налево.
CMFCToolBarImages::MirrorBitmapVert
static BOOL __stdcall MirrorBitmapVert(
HBITMAP& hbmp,
int cyImage);
Параметры
[in] hbmp
[in] cyImage
Возвращаемое значение
Замечания
CMFCToolBarImages::MirrorVert
BOOL MirrorVert();
Возвращаемое значение
Замечания
CMFCToolBarImages::OnSysColorChange
void OnSysColorChange();
Замечания
CMFCToolBarImages::P reMultiplyAlpha
static BOOL __stdcall PreMultiplyAlpha(
HBITMAP hbmp,
BOOL bAutoCheckPremlt);
BOOL PreMultiplyAlpha(HBITMAP hbmp);
Параметры
[in] hbmp
[in] bAutoCheckPremlt
Возвращаемое значение
Замечания
CMFCToolBarImages::m_bDisableTrueColorAlpha
Значение TRUE, если альфа-смешивание truecolor (32-разрядный цвет) отключено.
static BOOL m_bDisableTrueColorAlpha;
Замечания
Установите для этой переменной-член значение FALSE, чтобы включить альфа-смешивание truecolor для изображений панели инструментов.
Значение по умолчанию — TRUE для обратной совместимости.
CMFCToolBarImages::P repareDrawImage
Выделяет ресурсы, необходимые для рисования изображения панели инструментов с указанным размером.
BOOL PrepareDrawImage(
CAfxDrawState& ds,
CSize sizeImageDest=CSize(0,
0)
BOOL bFadeInactive=FALSE);
Параметры
ds
[in] Ссылка на структуру CAfxDrawState , которая сохраняет выделенные ресурсы между этапами отрисовки изображений.
sizeImageDest
[in] Указывает размер целевого образа.
bFadeInactive
[in] ЗНАЧЕНИЕ TRUE, если вы хотите, чтобы неактивные изображения отображались.
Возвращаемое значение
Значение TRUE, если ресурсы, необходимые для рисования изображения панели инструментов, были успешно выделены, в противном случае — ЗНАЧЕНИЕ FALSE.
Замечания
После вызова этого метода можно вызвать CMFCToolBarImages::D raw любое количество раз. После завершения рисования необходимо вызвать CMFCToolBarImages::EndDrawImage , чтобы освободить ресурсы, выделенные PrepareDrawImage.
CMFCToolBarImages::Save
Сохраняет изображения панели инструментов в файле, если этот набор изображений панели инструментов содержит пользовательские изображения.
BOOL Save(LPCTSTR lpszBmpFileName=NULL);
Параметры
lpszBmpFileName
Путь к файлу диска.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если изображения панели инструментов были успешно сохранены; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
Вызовите этот метод для хранения пользовательских образов в файл диска. Если lpszBmpFileName имеет значение NULL, метод сохраняет растровое изображение в файл, из которого была загружена растровая карта методом CMFCToolBarImages::Load .
CMFCToolBarImages::SetAlwaysLight
void SetAlwaysLight(BOOL bAlwaysLight = TRUE);
Параметры
[in] bAlwaysLight
Замечания
CMFCToolBarImages::SetDisabledImageAlpha
Задает значение альфа-канала (непрозрачность), используемое для отключенных образов.
static void SetDisabledImageAlpha(BYTE nValue);
Параметры
nValue
[in] Новое значение альфа-канала.
Замечания
Используйте этот метод, чтобы задать настраиваемое альфа-значение для отключенных изображений. Значение по умолчанию — 127, что приводит к отключенным изображениям кнопок, которые будут полутранспарентными. Если задать значение 0, отключенные изображения будут полностью прозрачными. Если задать значение 255, отключенные изображения будут полностью непрозрачными.
CMFCToolBarImages::SetFadedImageAlpha
static void __stdcall SetFadedImageAlpha(BYTE nValue);
Параметры
[in] nValue
Замечания
CMFCToolBarImages::SetImageSize
Задает размер каждого изображения панели инструментов (исходный размер).
void SetImageSize(
SIZE sizeImage,
BOOL bUpdateCount=FALSE);
Параметры
sizeImage
[in] Новый размер изображений панели инструментов.
Замечания
По умолчанию размер изображения панели инструментов составляет 16x15 пикселей. Вызовите этот метод, если вы хотите использовать изображения панели инструментов другого размера.
CMFCToolBarImages::SetLightPercentage
void SetLightPercentage(int nValue);
Параметры
[in] nValue
Замечания
CMFCToolBarImages::SetMapTo3DColors
void SetMapTo3DColors(BOOL bMapTo3DColors);
Параметры
[in] bMapTo3DColors
Замечания
CMFCToolBarImages::SetPreMultiplyAutoCheck
void SetPreMultiplyAutoCheck(BOOL bAuto = TRUE);
Параметры
[in] bAuto
Замечания
CMFCToolBarImages::SetSingleImage
void SetSingleImage();
Замечания
CMFCToolBarImages::SetTransparentColor
Задает прозрачный цвет изображений панели инструментов.
COLORREF SetTransparentColor(COLORREF clrTransparent);
Параметры
clrTransparent
[in] Значение RGB.
Возвращаемое значение
Предыдущий прозрачный цвет.
Замечания
При вызове CMFCToolBarImages::D raw метод не рисует пиксель, соответствующий цвету, указанному clrTransparent.
CMFCToolBarImages::UpdateImage
Обновляет определяемое пользователем изображение панели инструментов из растрового изображения.
BOOL UpdateImage(
int iImage,
HBITMAP hbmp);
Параметры
iImage
[in] Отсчитываемый от нуля индекс образа для обновления.
hbmp
[in] Дескриптор растрового изображения, с которого необходимо обновить изображение.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если изображение было успешно обновлено; ЗНАЧЕНИЕ FALSE, если список изображений не определен пользователем или временным.
CMFCToolBarImages::ConvertTo32Bits
Преобразует подчеркнутые растровые изображения в 32 изображения bpp.
BOOL ConvertTo32Bits(COLORREF clrTransparent = (COLORREF)-1);
Параметры
clrTransparent
Указывает прозрачный цвет подчеркнутых растровых изображений.
Замечания
CMFCToolBarImages::GetBitsPerPixel
Возвращает текущее разрешение подчеркнутых изображений.
int GetBitsPerPixel() const;
Возвращаемое значение
Целочисленное значение, представляющее текущее разрешение подчеркнутых изображений в битах на пиксель (bpp).
Замечания
CMFCToolBarImages::GetScale
Возвращает текущее соотношение масштаба подчеркнутых изображений.
double GetScale() const;
Возвращаемое значение
Значение, представляющее текущее коэффициент масштабирования.
Замечания
CMFCToolBarImages::IsScaled
Указывает, масштабируются ли подчеркнутые изображения.
BOOL IsScaled () const;
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если подчеркнутые изображения масштабируются; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
CMFCToolBarImages::SmoothResize
Плавное изменение размера подчеркнутых изображений.
BOOL SmoothResize(double dblImageScale);
Параметры
dblImageScale
Коэффициент масштабирования.
Возвращаемое значение
ЗНАЧЕНИЕ TRUE, если изменение размера выполнено успешно; в противном случае ЗНАЧЕНИЕ FALSE.
Замечания
См. также
Диаграмма иерархии
Классы
Класс CObject
Класс CMFCToolBar
Класс CMFCToolBarButton