На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GetObject



The GetObject function obtains information about a specified graphics object. Depending on the graphics object, the function places a filled-in BITMAP, DIBSECTION, EXTLOGPEN, LOGBRUSH, LOGFONT, or LOGPEN structure, or a count of table entries (for a logical palette), into a specified buffer.

int GetObject(

HGDIOBJ hgdiobj, // handle to graphics object of interest
int cbBuffer, // size of buffer for object information
LPVOID lpvObject // pointer to buffer for object information
);


Parameters

hgdiobj

A handle to the graphics object of interest. This can be a handle to one of the following: a logical bitmap, a brush, a font, a palette, a pen, or a device independent bitmap created by calling the CreateDIBSection function.

cbBuffer

Specifies the number of bytes of information to be written to the buffer.

lpvObject

Points to a buffer that is to receive the information about the specified graphics object.
The following table shows the type of information the buffer receives for each type of graphics object you can specify with hgdiobj:



hgdiobj Type Data Written to *lpvObject
HBITMAP BITMAP
HBITMAP returned from a call to CreateDIBSection DIBSECTION, if cbBuffer is set to sizeof(DIBSECTION), or BITMAP, if cbBuffer is set to sizeof(BITMAP)
HPALETTE a WORD count of the number of entries in the logical palette
HPEN returned from a call to ExtCreatePen EXTLOGPEN
HPEN LOGPEN
HBRUSH LOGBRUSH
HFONT LOGFONT


If the lpvObject parameter is NULL, the function return value is the number of bytes required to store the information it writes to the buffer for the specified graphics object.



Return Values

If the function succeeds, and lpvObject is a valid pointer, the return value is the number of bytes stored into the buffer.
If the function succeeds, and lpvObject is NULL, the return value is the number of bytes required to hold the information the function would store into the buffer.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The buffer pointed to by the lpvObject parameter must be sufficiently large to receive the information about the graphics object.
If hgdiobj identifies a bitmap created by calling CreateDIBSection, and the specified buffer is large enough, the GetObject function returns a DIBSECTION structure. In addition, the bmBits member of the BITMAP structure contained within the DIBSECTION will contain a pointer to the bitmap's bit values.

If hgdiobj identifies a bitmap created by any other means, GetObject returns only the width, height, and color format information of the bitmap. You can obtain the bitmap's bit values by calling the GetDIBits or GetBitmapBits function.
If hgdiobj identifies a logical palette, GetObject retrieves a two-byte integer that specifies the number of entries in the palette. The function does not retrieve the LOGPALETTE structure defining the palette. To retrieve information about palette entries, an application can call the GetPaletteEntries function.

See Also

CreateDIBSection, GetBitmapBits, GetDIBits, GetPaletteEntries, GetRegionData, BITMAP, DIBSECTION, EXTLOGPEN, LOGBRUSH, LOGFONT, LOGPALETTE, LOGPEN


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetObject



Функция GetObject получает информацию об определенном графическом объекте. В зависимости от графического объекта, функция устанавливается заполненный-в ПОБИТОВОМ отображении, DIBSECTION, EXTLOGPEN, LOGBRUSH, LOGFONT, или структуре LOGPEN, или счет табличных данных (для логической палитры), в определенный буфер.

int GetObject(

HGDIOBJ hgdiobj, // РУЧКА на графический объект интереса int cbBuffer, // размер буфера для объектного указателя информации LPVOID lpvObject //, чтобы буферизоваться для объектной информации
);


Параметры

hgdiobj

Ручка на графический объект интереса. Это может быть ручкой в одном из следующего: логическое побитовое отображение, щетка, шрифт, палитра, ручка, или независимое побитовое отображение устройства создавалось вызовом функции CreateDIBSection.

cbBuffer

Определяет количество байтов информации, которая нужно записывать в буфер.

lpvObject

Точки на буфер, которые должны получать информацию об определенном графическом объекте.
Следующая таблица показывает типу информации буферные приемники для каждого типа графического объекта Вы можете определить с hgdiobj:



hgdiobj Данные Типа Записанные, чтобы *ПОБИТОВОЕ отображение lpvObject HBITMAP
HBITMAP ВОЗВРАЩАЛСЯ от вызова до CreateDIBSection DIBSECTION, если cbBuffer установлен, чтобы sizeof(DIBSECTION), или ПОБИТОВОЕ отображение, если cbBuffer установлен, чтобы sizeof(ПОБИТОВОЕ отображение) HPALETTE ТЕКСТОВЫЙ счет номера данных в логической палитре HPEN возвращанной от вызова до ExtCreatePen EXTLOGPEN HPEN LOGPEN HBRUSH LOGBRUSH HFONT LOGFONT


Если параметр lpvObject НЕДЕЙСТВИТЕЛЕН, функциональная обратная величина является количеством байтов требовавшихся, чтобы загружать информацию, которую она записывается в буфер для определенного графического объекта.



Обратные Величины

Если функция получает, и lpvObject - правильный указатель, обратная величина является количеством байтов загруженных в буфер.
Если функция получает, и lpvObject НЕДЕЙСТВИТЕЛЕН, обратная величина является количеством байтов требовавшихся, чтобы хранить информацию, которую функция должна загружаться в буфер.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Буфер указанный, чтобы параметром lpvObject должен быть достаточно большим, чтобы получать информацию о графическом объекте.
Если hgdiobj идентифицирует побитовое отображение созданное вызовом CreateDIBSection, и определенный буфер является большой достаточно, функциональный возврат GetObject структура DIBSECTION. Кроме того, элемент bmBits структуры ПОБИТОВОГО отображения содержимого в пределах DIBSECTION будет содержать указатель в битовые величины побитового отображения.

Если hgdiobj идентифицирует побитовое отображение созданное любыми другими средствами, GetObject возвращает только ширину, высоту, и цветная информация формата побитового отображения. Вы можете получить битовые величины побитового отображения вызывая GetDIBits или функция GetBitmapBits.
Если hgdiobj идентифицирует логическую палитру, GetObject извлекает двух байтовое целое, которое определяет номер данных в палитре. Функция не извлекает структуру LOGPALETTE, определяющую палитру. Чтобы извлекать информацию о данных палитры, приложение может назвать функцию GetPaletteEntries.

Смотри Также

CreateDIBSection, GetBitmapBits, GetDIBits, GetPaletteEntries, GetRegionData, BITMAP, DIBSECTION, EXTLOGPEN, LOGBRUSH, LOGFONT, LOGPALETTE, LOGPEN


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz