Описание
Класс TBitmap инкапсулирует битовую матрицу Windows, включая палитру. Обеспечивает быстрое и простое для пользователя выполнение операций создания, копирования, преобразования и сохранения битовой матрицы.
Иерархия
TObject - TPersistent - TGraphic
Модуль
graphics.h
Свойства
| Свойство | Тип | Описание |
| Canvas | TCanvas | Определяет пространство (холст) для изображения битовой матрицы. Свойство только для чтения. |
| Empty | bool | Указывает, содержит ли объект битовую матрицу. Свойство только для чтения. |
| Handle | HBITMAP | Обеспечивает доступ к обработке битовых матриц в GDI Windows. Используется при вызовах функций API Windows. |
| HandleType | enum TBitmapHandleType {bmDIB, bmDDB} | Указывает, является ли битовая матрица DDB (Device Dependent Bitmap - аппаратно зависимой), или DIB (Device Independent Bitmap - аппаратно независимой). Может изменяться пользователем. |
| Height | int | Указывает высоту изображения в пикселах. Может изменяться пользователем, что вызывает создание копии матрицы с указанным размером. |
| IgnorePalette | bool | Определяет, использует ли матрица палитру. При установке в true ухудшается качество, но ускоряется рисование. |
| Modified | bool | Определяет, было ли модифицировано изображение после его загрузки. |
| MaskHandle | HBITMAP | Обеспечивает доступ к обработке битовых матриц в GDI Windows. Используется при вызовах функций API Windows. Свойство только для чтения. |
| Monochrome | bool | Определяет, является ли битовая матрица монохромной (значение true). |
| Palette | HPALETTE | Управляет цветами битовой матрицы с 256 цветами. Если изображение не нуждается в палитре или не имеет палитры, то Palette - 0. |
| PixelFormat | enum TPixelFormat {pfDevice, pflbit, pf4bit, pf8bit, pflSbit, pfl6bit, pf246it, pf32bit, pfCustom} | Определяет битовый формат отображения изображения. Используется для задания формата видеодрайверам, не способным прочитать собственный формат битовой матрицы. |
| ScanLine | void * | Обеспечивает доступ к отдельным строкам пикселов для их низкоуровневой обработки для матриц DIBs (Device Independent Bitmap - аппаратно независимых). Свойство только для чтения. |
| Transparent | bool | Определяет, должно ли изображение быть «прозрачным». |
| TransparentColor | TColor | Определяет, какой из цветов будет прозрачным при рисовании битовой матрицы. Читаемое значение зависит от значения TransparentMode. |
| TransparentMode | enum TTransparentMode {tmAuto, tmFixed} | Определяет, будет ли свойство TransparentColor сохраняться вместе с битовой матрицей. |
| Width | int | Указывает ширину изображения в пикселах. Может изменяться пользователем, что вызывает создание копии матрицы с указанным размером. |
Методы
| Значение | Описание |
| Assign | Копирует изображение из другого графического объекта, в частности, из буфера обмена Clipboard. |
| Dormant | Создает изображение битовой матрицы в памяти, чтобы освободить дескриптор матрицы и сэкономить ресурсы. |
| Freelmage | Освобождаем память, занятую кэшированием изображения, экономит ресурсы, но может вести к потере глубины цвета. |
| LoadFromClipboardFormat | Читает изображение из буфера обмена Clipboard в заданном формате. |
| LoadFromFile | Читает изображение из файла. |
| LoadFromResourcelD | Загружает битовую карту из ресурса по указанному идентификатору. |
| LoadFromResourceName | Загружает битовую карту из ресурса по указанному имени. |
| LoadFromStream | Читает графическое изображение из указанного потока. |
| Mask | Преобразует изображение в монохромную маску. |
| ReleaseHandle | Возвращает дескриптор типа HBitmap и очищает объект TBitmap от этого дескриптора. |
| ReleaseMaskHandle | Возвращает дескриптор маски типа HBitmap и очищает объект TBitmapот этого дескриптора. |
| ReleasePalette | Возвращает дескриптор палитры типа HPalette и разрывает связь палитры с объектом TBitmap. |
| SaveToClipboardFormat | Сохраняет изображение в буфере обмена Clipboard в заданном формате. |
| SaveToFile | Сохраняет изображение в файле. |
| SaveToStream | Записывает изображение в поток. |
События
| Значение | Описание |
| OnChantfe | Событие при изменении графического объекта. |
| OnProgress | События происходят при медленных процессах изменения графического изображения и позволяют построить индикатор хода процесса. |
