Класс CBitmapCBitmap Class

Инкапсулирует растровое изображение интерфейса графических устройств Windows (GDI) и предоставляет функции-члены для манипулирования этим растровым изображением.Encapsulates a Windows graphics device interface (GDI) bitmap and provides member functions to manipulate the bitmap.

СинтаксисSyntax

class CBitmap : public CGdiObject

ЧленыMembers

Открытые конструкторыPublic Constructors

nameName ОписаниеDescription
CBitmap:: CBitmapCBitmap::CBitmap Формирует объект CBitmap.Constructs a CBitmap object.

Открытые методыPublic Methods

nameName ОписаниеDescription
CBitmap:: КреатебитмапCBitmap::CreateBitmap Инициализирует объект с битовой картой памяти, зависящей от устройства, которая имеет указанную ширину, высоту и битовый шаблон.Initializes the object with a device-dependent memory bitmap that has a specified width, height, and bit pattern.
CBitmap:: КреатебитмапиндиректCBitmap::CreateBitmapIndirect Инициализирует объект точечным рисунком с шириной, высотой и битовым шаблоном (если он указан), заданным в BITMAP структуре.Initializes the object with a bitmap with the width, height, and bit pattern (if one is specified) given in a BITMAP structure.
CBitmap:: КреатекомпатиблебитмапCBitmap::CreateCompatibleBitmap Инициализирует объект точечным рисунком, чтобы он был совместим с указанным устройством.Initializes the object with a bitmap so that it is compatible with a specified device.
CBitmap:: КреатедискардаблебитмапCBitmap::CreateDiscardableBitmap Инициализирует объект с помощью отброшенного точечного рисунка, совместимого с указанным устройством.Initializes the object with a discardable bitmap that is compatible with a specified device.
CBitmap:: FromHandleCBitmap::FromHandle Возвращает указатель на CBitmap объект при наличии маркера для HBITMAP точечного рисунка Windows.Returns a pointer to a CBitmap object when given a handle to a Windows HBITMAP bitmap.
CBitmap::/BitmapCBitmap::GetBitmap Заполняет BITMAP структуру сведениями о растровом изображении.Fills a BITMAP structure with information about the bitmap.
CBitmap:: ЖетбитмапбитсCBitmap::GetBitmapBits Копирует биты указанного растрового изображения в указанный буфер.Copies the bits of the specified bitmap into the specified buffer.
CBitmap:: ЖетбитмапдименсионCBitmap::GetBitmapDimension Возвращает ширину и высоту точечного рисунка.Returns the width and height of the bitmap. Предполагается, что высота и ширина были заданы ранее функцией члена сетбитмапдименсион .The height and width are assumed to have been set previously by the SetBitmapDimension member function.
CBitmap:: ЛоадбитмапCBitmap::LoadBitmap Инициализирует объект, загружая именованный ресурс Bitmap из исполняемого файла приложения и присоединяя к нему растровое изображение.Initializes the object by loading a named bitmap resource from the application's executable file and attaching the bitmap to the object.
CBitmap:: ЛоадмаппедбитмапCBitmap::LoadMappedBitmap Загружает растровое изображение и сопоставляет цвета с текущими системными цветами.Loads a bitmap and maps colors to current system colors.
CBitmap:: ЛоадоембитмапCBitmap::LoadOEMBitmap Инициализирует объект, загружая предопределенный точечный рисунок Windows и присоединяя к объекту растровое изображение.Initializes the object by loading a predefined Windows bitmap and attaching the bitmap to the object.
CBitmap:: СетбитмапбитсCBitmap::SetBitmapBits Устанавливает биты точечного рисунка в указанные битовые значения.Sets the bits of a bitmap to the specified bit values.
CBitmap:: СетбитмапдименсионCBitmap::SetBitmapDimension Присваивает ширину и высоту точечному рисунку в единицах 0,1-миллиметра.Assigns a width and height to a bitmap in 0.1-millimeter units.

Открытые операторыPublic Operators

ИмяName ОписаниеDescription
CBitmap:: operator ХБИТМАПCBitmap::operator HBITMAP Возвращает маркер Windows, присоединенный к CBitmap объекту.Returns the Windows handle attached to the CBitmap object.

КомментарииRemarks

Чтобы использовать CBitmap объект, создайте объект, прикрепите к нему маркер точечного рисунка с помощью одной из функций-членов инициализации, а затем вызовите функции-члены объекта.To use a CBitmap object, construct the object, attach a bitmap handle to it with one of the initialization member functions, and then call the object's member functions.

Дополнительные сведения об использовании графических объектов, таких как CBitmap , см. в разделе графические объекты.For more information on using graphic objects like CBitmap, see Graphic Objects.

Иерархия наследованияInheritance Hierarchy

CObjectCObject

CGdiObjectCGdiObject

CBitmap

ТребованияRequirements

Заголовок: afxwin.hHeader: afxwin.h

CBitmap:: CBitmapCBitmap::CBitmap

Формирует объект CBitmap.Constructs a CBitmap object.

CBitmap();

КомментарииRemarks

Полученный объект должен инициализироваться одной из функций элементов инициализации.The resulting object must be initialized with one of the initialization member functions.

CBitmap:: КреатебитмапCBitmap::CreateBitmap

Инициализируется аппаратно зависимая битовая карта памяти, имеющая заданную ширину, высоту и битовый шаблон.Initializes a device-dependent memory bitmap that has the specified width, height, and bit pattern.

BOOL CreateBitmap(
    int nWidth,
    int nHeight,
    UINT nPlanes,
    UINT nBitcount,
    const void* lpBits);

ПараметрыParameters

нвидсnWidth
Задается ширина (в пикселях) битовой карты.Specifies the width (in pixels) of the bitmap.

нхеигхтnHeight
Задается высота (в пикселях) битовой карты.Specifies the height (in pixels) of the bitmap.

нпланесnPlanes
Задается число цветовых плоскостей в битовой карте.Specifies the number of color planes in the bitmap.

нбиткаунтnBitcount
Задается число цветовых битов на пиксель отображения.Specifies the number of color bits per display pixel.

лпбитсlpBits
Указывается массив байтов, содержащий исходные значения битов битовой карты.Points to an array of bytes that contains the initial bitmap bit values. Если указывается значение NULL, новая битовая карта остается неинициализированной.If it is NULL, the new bitmap is left uninitialized.

Возвращаемое значениеReturn Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.Nonzero if successful; otherwise 0.

КомментарииRemarks

Для цветового битового изображения параметр нпланес или нбиткаунт должен иметь значение 1.For a color bitmap, either the nPlanes or nBitcount parameter should be set to 1. Если оба этих параметра имеют значение 1, CreateBitmap создает монохромную битовую карту.If both of these parameters are set to 1, CreateBitmap creates a monochrome bitmap.

Несмотря на то, что нельзя напрямую выбрать битовую карту для устройства отображения, ее можно выбрать как текущую битовую карту для "контекста устройства памяти" с помощью CDC::SelectObject и скопировать в любой совместимый контекст устройства с помощью функции CDC::BitBlt .Although a bitmap cannot be directly selected for a display device, it can be selected as the current bitmap for a "memory device context" by using CDC::SelectObject and copied to any compatible device context by using the CDC::BitBlt function.

После завершения работы с объектом CBitmap , созданным функцией CreateBitmap , сначала выберите битовую карту из контекста устройства, а затем удалите объект CBitmap .When you finish with the CBitmap object created by the CreateBitmap function, first select the bitmap out of the device context, then delete the CBitmap object.

Дополнительные сведения см. в описании bmBits поля в BITMAP структуре.For more information, see the description of the bmBits field in the BITMAP structure. Структура BITMAP рассматривается в описании функции-члена CBitmap::CreateBitmapIndirect .The BITMAP structure is described under the CBitmap::CreateBitmapIndirect member function.

CBitmap:: КреатебитмапиндиректCBitmap::CreateBitmapIndirect

Инициализирует точечный рисунок, имеющий ширину, высоту и битовый шаблон (если он указан), заданный в структуре, на которую указывает лпбитмап.Initializes a bitmap that has the width, height, and bit pattern (if one is specified) given in the structure pointed to by lpBitmap.

BOOL CreateBitmapIndirect(LPBITMAP lpBitmap);

ПараметрыParameters

лпбитмапlpBitmap
Указывает на структуру точечного рисунка , содержащую сведения о растровом изображении.Points to a BITMAP structure that contains information about the bitmap.

Возвращаемое значениеReturn Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.Nonzero if successful; otherwise 0.

КомментарииRemarks

Хотя точечный рисунок нельзя выбрать непосредственно для устройства вывода, его можно выбрать в качестве текущего точечного рисунка для контекста устройства памяти с помощью CDC:: SelectObject и скопировать в любой совместимый контекст устройства с помощью функции CDC:: BitBlt или CDC:: стретчблт .Although a bitmap cannot be directly selected for a display device, it can be selected as the current bitmap for a memory device context by using CDC::SelectObject and copied to any compatible device context by using the CDC::BitBlt or CDC::StretchBlt function. (Функция CDC::P атблт может скопировать точечный рисунок для текущей кисти непосредственно в контекст дисплея устройства.)(The CDC::PatBlt function can copy the bitmap for the current brush directly to the display device context.)

Если BITMAP структура, на которую указывает параметр лпбитмап , заполнена с помощью GetObject функции, биты точечного рисунка не указываются и битовая карта не инициализируется.If the BITMAP structure pointed to by the lpBitmap parameter has been filled in by using the GetObject function, the bits of the bitmap are not specified and the bitmap is uninitialized. Чтобы инициализировать точечный рисунок, приложение может использовать функцию, такую как CDC:: BitBlt или сетдибитс , для копирования битов из точечного рисунка, определенного первым параметром, CGdiObject::GetObject в растровое изображение, созданное CreateBitmapIndirect .To initialize the bitmap, an application can use a function such as CDC::BitBlt or SetDIBits to copy the bits from the bitmap identified by the first parameter of CGdiObject::GetObject to the bitmap created by CreateBitmapIndirect.

По завершении работы с CBitmap объектом, созданным с помощью CreateBitmapIndirect функции, сначала выберите точечный рисунок из контекста устройства, а затем удалите CBitmap объект.When you finish with the CBitmap object created with CreateBitmapIndirect function, first select the bitmap out of the device context, then delete the CBitmap object.

CBitmap:: КреатекомпатиблебитмапCBitmap::CreateCompatibleBitmap

Инициализирует точечный рисунок, совместимый с устройством, указанным в PDC.Initializes a bitmap that is compatible with the device specified by pDC.

BOOL CreateCompatibleBitmap(
    CDC* pDC,
    int nWidth,
    int nHeight);

ПараметрыParameters

ХозяинpDC
Указывает контекст устройства.Specifies the device context.

нвидсnWidth
Задается ширина (в пикселях) битовой карты.Specifies the width (in pixels) of the bitmap.

нхеигхтnHeight
Задается высота (в пикселях) битовой карты.Specifies the height (in pixels) of the bitmap.

Возвращаемое значениеReturn Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.Nonzero if successful; otherwise 0.

КомментарииRemarks

Точечный рисунок имеет то же количество цветовых плоскостей или тот же формат битов на пиксель, что и в указанном контексте устройства.The bitmap has the same number of color planes or the same bits-per-pixel format as the specified device context. Его можно выбрать в качестве текущего растрового изображения для любого устройства памяти, совместимого с указанным PDC.It can be selected as the current bitmap for any memory device that is compatible with the one specified by pDC.

Если PDC является контекстом устройства памяти, возвращаемый точечный рисунок имеет тот же формат, что и текущий выбранный точечный рисунок в этом контексте устройства.If pDC is a memory device context, the bitmap returned has the same format as the currently selected bitmap in that device context. "Контекст устройства памяти" — блок памяти, представляющий поверхность отображения.A "memory device context" is a block of memory that represents a display surface. Его можно использовать для подготовки изображений в памяти перед их копированием на фактическую поверхность экрана совместимого устройства.It can be used to prepare images in memory before copying them to the actual display surface of the compatible device.

При создании контекста устройства памяти GDI автоматически выбирает для него изображение монохромной акции.When a memory device context is created, GDI automatically selects a monochrome stock bitmap for it.

Так как для контекста устройства памяти цвета может быть выбрано либо цветное, либо монохромное растровое изображение, формат растрового изображения, возвращаемого CreateCompatibleBitmap функцией, не всегда будет одинаковым. Однако формат совместимого точечного рисунка для контекста непамяти устройства всегда имеет формат устройства.Since a color memory device context can have either color or monochrome bitmaps selected, the format of the bitmap returned by the CreateCompatibleBitmap function is not always the same; however, the format of a compatible bitmap for a nonmemory device context is always in the format of the device.

По завершении работы с CBitmap объектом, созданным с помощью CreateCompatibleBitmap функции, сначала выберите точечный рисунок из контекста устройства, а затем удалите CBitmap объект.When you finish with the CBitmap object created with the CreateCompatibleBitmap function, first select the bitmap out of the device context, then delete the CBitmap object.

CBitmap:: КреатедискардаблебитмапCBitmap::CreateDiscardableBitmap

Инициализирует отброшенный точечный рисунок, совместимый с контекстом устройства, идентифицируемым PDC.Initializes a discardable bitmap that is compatible with the device context identified by pDC.

BOOL CreateDiscardableBitmap(
    CDC* pDC,
    int nWidth,
    int nHeight);

ПараметрыParameters

ХозяинpDC
Указывает контекст устройства.Specifies a device context.

нвидсnWidth
Задает ширину точечного рисунка (в битах).Specifies the width (in bits) of the bitmap.

нхеигхтnHeight
Задает высоту (в битах) точечного рисунка.Specifies the height (in bits) of the bitmap.

Возвращаемое значениеReturn Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.Nonzero if successful; otherwise 0.

КомментарииRemarks

Точечный рисунок имеет то же количество цветовых плоскостей или тот же формат битов на пиксель, что и в указанном контексте устройства.The bitmap has the same number of color planes or the same bits-per-pixel format as the specified device context. Приложение может выбрать этот рисунок в качестве текущего точечного рисунка для устройства памяти, совместимого с указанным PDC.An application can select this bitmap as the current bitmap for a memory device that is compatible with the one specified by pDC.

Windows может удалить точечный рисунок, созданный этой функцией, только в том случае, если приложение не выбрало его в контексте вывода.Windows can discard a bitmap created by this function only if an application has not selected it into a display context. Если Windows отбрасывает точечный рисунок, если он не выбран и приложение позже пытается выбрать его, функция CDC:: SelectObject возвратит значение null.If Windows discards the bitmap when it is not selected and the application later attempts to select it, the CDC::SelectObject function will return NULL.

По завершении работы с CBitmap объектом, созданным с помощью CreateDiscardableBitmap функции, сначала выберите точечный рисунок из контекста устройства, а затем удалите CBitmap объект.When you finish with the CBitmap object created with the CreateDiscardableBitmap function, first select the bitmap out of the device context, then delete the CBitmap object.

CBitmap:: FromHandleCBitmap::FromHandle

Возвращает указатель на CBitmap объект при наличии маркера для точечного рисунка Windows GDI.Returns a pointer to a CBitmap object when given a handle to a Windows GDI bitmap.

static CBitmap* PASCAL FromHandle(HBITMAP hBitmap);

ПараметрыParameters

хбитмапhBitmap
Указывает точечный рисунок Windows GDI.Specifies a Windows GDI bitmap.

Возвращаемое значениеReturn Value

Указатель на объект в случае CBitmap успеха; в противном случае — null.A pointer to a CBitmap object if successful; otherwise NULL.

КомментарииRemarks

Если CBitmap объект еще не присоединен к обработчику, CBitmap создается и прикрепляется временный объект.If a CBitmap object is not already attached to the handle, a temporary CBitmap object is created and attached. Этот временный CBitmap объект действителен только до тех пор, пока приложение не найдет время простоя в цикле событий, во время которого все временные графические объекты будут удалены.This temporary CBitmap object is valid only until the next time the application has idle time in its event loop, at which time all temporary graphic objects are deleted. Другой способ сказать, что временный объект допустим только во время обработки одного сообщения окна.Another way of saying this is that the temporary object is only valid during the processing of one window message.

CBitmap::/BitmapCBitmap::GetBitmap

Получает свойства изображения для присоединенного точечного рисунка.Retrieves image properties for the attached bitmap.

int GetBitmap(BITMAP* pBitMap);

ПараметрыParameters

пбитмапpBitMap
Указатель на структуру точечного рисунка , которая получит свойства изображения.Pointer to a BITMAP structure that will receive the image properties. Этот параметр не может иметь значение NULL.This parameter must not be NULL.

Возвращаемое значениеReturn Value

Ненулевое значение, если метод был успешным; в противном случае — 0.Nonzero if the method was successful; otherwise 0.

КомментарииRemarks

CBitmap:: ЖетбитмапбитсCBitmap::GetBitmapBits

Копирует битовый шаблон присоединенного растрового изображения в указанный буфер.Copies the bit pattern of the attached bitmap into the specified buffer.

DWORD GetBitmapBits(
    DWORD dwCount,
    LPVOID lpBits) const;

ПараметрыParameters

двкаунтdwCount
Число байтов для копирования в буфер.The number of bytes to copy to the buffer.

лпбитсlpBits
Указатель на буфер, который получит точечный рисунок.Pointer to the buffer that will receive the bitmap.

Возвращаемое значениеReturn Value

Число байтов, скопированных в буфер при успешном выполнении метода; в противном случае — 0.The number of bytes copied to the buffer if the method was successful; otherwise 0.

КомментарииRemarks

Используйте CBitmap:: onbitmap , чтобы определить требуемый размер буфера.Use CBitmap::GetBitmap to determine the required buffer size.

CBitmap:: ЖетбитмапдименсионCBitmap::GetBitmapDimension

Возвращает ширину и высоту точечного рисунка.Returns the width and height of the bitmap.

CSize GetBitmapDimension() const;

Возвращаемое значениеReturn Value

Ширина и высота растрового изображения, измеряемая в единицах измерения 0,1-миллиметра.The width and height of the bitmap, measured in 0.1-millimeter units. Высота находится в элементе cy CSize объекта, а ширина — в элементе cx .The height is in the cy member of the CSize object, and the width is in the cx member. Если ширина и высота точечного рисунка не были заданы с помощью SetBitmapDimension , то возвращаемое значение равно 0.If the bitmap width and height have not been set by using SetBitmapDimension, the return value is 0.

КомментарииRemarks

Предполагается, что высота и ширина были заданы ранее с помощью функции члена сетбитмапдименсион .The height and width are assumed to have been set previously by using the SetBitmapDimension member function.

CBitmap:: ЛоадбитмапCBitmap::LoadBitmap

Загружает ресурс точечного рисунка с именем лпсзресаурценаме или идентифицируется по идентификатору в нидресаурце из исполняемого файла приложения.Loads the bitmap resource named by lpszResourceName or identified by the ID number in nIDResource from the application's executable file.

BOOL LoadBitmap(LPCTSTR lpszResourceName);
BOOL LoadBitmap(UINT nIDResource);

ПараметрыParameters

лпсзресаурценамеlpszResourceName
Указывает на строку, завершающуюся нулем, которая содержит имя ресурса точечного рисунка.Points to a null-terminated string that contains the name of the bitmap resource.

нидресаурцеnIDResource
Указывает идентификатор ресурса точечного рисунка.Specifies the resource ID number of the bitmap resource.

Возвращаемое значениеReturn Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.Nonzero if successful; otherwise 0.

КомментарииRemarks

Загруженный точечный рисунок прикрепляется к CBitmap объекту.The loaded bitmap is attached to the CBitmap object.

Если точечный рисунок, идентифицируемый лпсзресаурценаме , не существует, или если недостаточно памяти для загрузки точечного рисунка, функция возвращает 0.If the bitmap identified by lpszResourceName does not exist or if there is insufficient memory to load the bitmap, the function returns 0.

Для удаления битовой карты, загруженной функцией, можно использовать функцию кгдиобжект::D елетеобжект LoadBitmap , иначе CBitmap деструктор удалит объект.You can use the CGdiObject::DeleteObject function to delete bitmap loaded by the LoadBitmap function, or the CBitmap destructor will delete the object for you.

Внимание!

Перед удалением объекта убедитесь, что он не выбран в контексте устройства.Before you delete the object, make sure it is not selected into a device context.

Следующие растровые изображения были добавлены в версии Windows 3,1 и более поздних версий:The following bitmaps were added to Windows versions 3.1 and later:

OBM_UPARRROWIOBM_DNARROWIOBM_RGARROWIOBM_LFARROWIOBM_UPARRROWIOBM_DNARROWIOBM_RGARROWIOBM_LFARROWI

Эти точечные рисунки не найдены в драйверах устройств для Windows версии 3,0 и более ранних версий.These bitmaps are not found in device drivers for Windows versions 3.0 and earlier. Полный список растровых изображений и отображение их внешнего вида см. в Windows SDK.For a complete list of bitmaps and a display of their appearance, see the Windows SDK.

CBitmap:: ЛоадмаппедбитмапCBitmap::LoadMappedBitmap

Вызовите эту функцию-член для загрузки точечного рисунка и сопоставьте цвета с текущими системными цветами.Call this member function to load a bitmap and map the colors to the current system colors.

BOOL LoadMappedBitmap(
    UINT nIDBitmap,
    UINT nFlags = 0,
    LPCOLORMAP lpColorMap = NULL,
    int nMapSize = 0);

ПараметрыParameters

нидбитмапnIDBitmap
Идентификатор ресурса точечного рисунка.The ID of the bitmap resource.

нфлагсnFlags
Флаг для точечного рисунка.A flag for a bitmap. Может быть нулем или CMB_MASKED.Can be zero or CMB_MASKED.

лпколормапlpColorMap
Указатель на COLORMAP структуру, содержащую сведения о цвете, необходимые для отображения растровых изображений.A pointer to a COLORMAP structure that contains the color information needed to map the bitmaps. Если этот параметр имеет значение NULL, функция использует цветовую карту по умолчанию.If this parameter is NULL, the function uses the default color map.

нмапсизеnMapSize
Число цветовых карт, на которое указывает лпколормап.The number of color maps pointed to by lpColorMap.

Возвращаемое значениеReturn Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.Nonzero if successful; otherwise 0.

КомментарииRemarks

По умолчанию LoadMappedBitmap будет сопоставлять цвета, часто используемые в глифах кнопок.By default, LoadMappedBitmap will map colors commonly used in button glyphs.

Сведения о создании сопоставленного точечного рисунка см. в разделе Windows Function креатемаппедбитмап и структура колормап в Windows SDK.For information about creating a mapped bitmap, see the Windows function CreateMappedBitmap and the COLORMAP structure in the Windows SDK.

CBitmap:: ЛоадоембитмапCBitmap::LoadOEMBitmap

Загружает предопределенный точечный рисунок, используемый Windows.Loads a predefined bitmap used by Windows.

BOOL LoadOEMBitmap(UINT nIDBitmap);

ПараметрыParameters

нидбитмапnIDBitmap
ИДЕНТИФИКАЦИОНный номер предопределенного точечного рисунка Windows.ID number of the predefined Windows bitmap. Возможные значения перечислены ниже в WINDOWS. ВысотыThe possible values are listed below from WINDOWS.H:

OBM_BTNCORNERS OBM_BTNCORNERS
OBM_BTSIZE OBM_BTSIZE
OBM_CHECK OBM_CHECK
OBM_CHECKBOXES OBM_CHECKBOXES
OBM_CLOSE OBM_CLOSE
OBM_COMBO OBM_COMBO
OBM_DNARROW OBM_DNARROW
OBM_DNARROWD OBM_DNARROWD
OBM_DNARROWI OBM_DNARROWI
OBM_LFARROW OBM_LFARROW
OBM_LFARROWD OBM_LFARROWD
OBM_LFARROWIOBM_LFARROWI

OBM_MNARROW OBM_MNARROW
OBM_OLD_CLOSE OBM_OLD_CLOSE
OBM_OLD_DNARROW OBM_OLD_DNARROW
OBM_OLD_LFARROW OBM_OLD_LFARROW
OBM_OLD_REDUCE OBM_OLD_REDUCE
OBM_OLD_RESTORE OBM_OLD_RESTORE
OBM_OLD_RGARROW OBM_OLD_RGARROW
OBM_OLD_UPARROW OBM_OLD_UPARROW
OBM_OLD_ZOOM OBM_OLD_ZOOM
OBM_REDUCE OBM_REDUCE
OBM_REDUCEDOBM_REDUCED

OBM_RESTORE OBM_RESTORE
OBM_RESTORED OBM_RESTORED
OBM_RGARROW OBM_RGARROW
OBM_RGARROWD OBM_RGARROWD
OBM_RGARROWI OBM_RGARROWI
OBM_SIZE OBM_SIZE
OBM_UPARROW OBM_UPARROW
OBM_UPARROW OBM_UPARROW
OBM_UPARROWD OBM_UPARROWD
OBM_ZOOM OBM_ZOOM
OBM_ZOOMDOBM_ZOOMD

Возвращаемое значениеReturn Value

Имеет ненулевое значение в случае успешного выполнения, иначе — 0.Nonzero if successful; otherwise 0.

КомментарииRemarks

Битовые имена, начинающиеся с OBM_OLD, представляют точечные рисунки, используемые версиями Windows до 3,0.Bitmap names that begin with OBM_OLD represent bitmaps used by Windows versions prior to 3.0.

Обратите внимание, что константа ОЕМРЕСАУРЦЕ должна быть определена перед включением WINDOWS. H, чтобы использовать любые константы OBM_ .Note that the constant OEMRESOURCE must be defined before including WINDOWS.H in order to use any of the OBM_ constants.

CBitmap:: operator ХБИТМАПCBitmap::operator HBITMAP

Этот оператор используется для получения подключенного маркера GDI Windows CBitmap объекта.Use this operator to get the attached Windows GDI handle of the CBitmap object.

operator HBITMAP() const;

Возвращаемое значениеReturn Value

В случае успеха — обработчик для объекта Windows GDI, представленного CBitmap объектом; в противном случае — null.If successful, a handle to the Windows GDI object represented by the CBitmap object; otherwise NULL.

КомментарииRemarks

Этот оператор является оператором приведения, который поддерживает прямое использование HBITMAP объекта.This operator is a casting operator, which supports direct use of an HBITMAP object.

Дополнительные сведения об использовании графических объектов см. в разделе графические объекты в Windows SDK.For more information about using graphic objects, see Graphic Objects in the Windows SDK.

CBitmap:: СетбитмапбитсCBitmap::SetBitmapBits

Устанавливает биты точечного рисунка в битовые значения, заданные параметром лпбитс.Sets the bits of a bitmap to the bit values given by lpBits.

DWORD SetBitmapBits(
    DWORD dwCount,
    const void* lpBits);

ПараметрыParameters

двкаунтdwCount
Указывает число байтов, на которое указывает лпбитс.Specifies the number of bytes pointed to by lpBits.

лпбитсlpBits
Указывает на массив БАЙТОВ, содержащий значения пикселей, копируемые в CBitmap объект.Points to the BYTE array that contains the pixel values to be copied to the CBitmap object. Чтобы точечный рисунок мог правильно визуализировать изображение, значения необходимо отформатировать, чтобы они соответствовали значениям высоты, ширины и глубины цвета, которые были указаны при создании экземпляра CBitmap.In order for the bitmap to be able to render its image correctly, the values should be formatted to conform to the height, width and color depth values that were specified when the CBitmap instance was created. Дополнительные сведения см. в разделе CBitmap:: креатебитмап.For more information, see CBitmap::CreateBitmap.

Возвращаемое значениеReturn Value

Число байтов, используемых при настройке битов растрового изображения; 0, если функция завершается ошибкой.The number of bytes used in setting the bitmap bits; 0 if the function fails.

CBitmap:: СетбитмапдименсионCBitmap::SetBitmapDimension

Присваивает ширину и высоту точечному рисунку в единицах 0,1-миллиметра.Assigns a width and height to a bitmap in 0.1-millimeter units.

CSize SetBitmapDimension(
    int nWidth,
    int nHeight);

ПараметрыParameters

нвидсnWidth
Задает ширину точечного рисунка (в единицах 0,1-миллиметра).Specifies the width of the bitmap (in 0.1-millimeter units).

нхеигхтnHeight
Задает высоту точечного рисунка (в единицах 0,1-миллиметра).Specifies the height of the bitmap (in 0.1-millimeter units).

Возвращаемое значениеReturn Value

Предыдущие размеры растрового изображения.The previous bitmap dimensions. Высота находится в cy переменной-члене CSize объекта, а ширина — в переменной- cx члене.Height is in the cy member variable of the CSize object, and width is in the cx member variable.

КомментарииRemarks

GDI не использует эти значения, кроме возврата их при вызове приложением функции члена жетбитмапдименсион .The GDI does not use these values except to return them when an application calls the GetBitmapDimension member function.

См. также разделSee also

Образец MDI-формы MFCMFC Sample MDI
Класс КгдиобжектCGdiObject Class
Иерархическая диаграммаHierarchy Chart