На главную

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 | Скачать Вниз

GetMetaFileBitsEx



The GetMetaFileBitsEx function retrieves the contents of a Windows-format metafile and copies them into the specified buffer.

This function is provided for compatibility with earlier versions of Microsoft Windows. Win32-based applications should use the GetEnhMetaFileBits function.

UINT GetMetaFileBitsEx(

HMETAFILE hmf, // handle of metafile
UINT nSize, // size of metafile, in bytes
LPVOID lpvData // address of metafile data
);


Parameters

hmf

Identifies a Windows-format metafile.

nSize

Specifies the size, in bytes, of the buffer to receive the data.

lpvData

Points to the buffer to receive the metafile data. The buffer must be sufficiently large to contain the data. If lpvData is NULL, the function returns the number of bytes required to hold the data.



Return Values

If the function succeeds and the buffer pointer is NULL, the return value is the number of bytes required for the buffer; if the function succeeds and the buffer pointer is a valid pointer, the return value is the number of bytes copied.
If the function fails, the return value is zero.

Remarks

After the Windows-metafile bits are retrieved, they can be used to create a memory-based metafile by calling the SetMetaFileBitsEx function.
The GetMetaFileBitsEx function does not invalidate the metafile handle. An application must delete this handle by calling the DeleteMetaFile function.
A Windows-format metafile does not support the new curve, path, and transformation functions, such as PolyBezier, BeginPath, and SetWorldTransform. Applications that use these new functions and use metafiles to store pictures created by these functions should use the enhanced format metafile functions.

To convert a Windows-format metafile into an enhanced-format metafile, use the SetWinMetaFileBits function.

See Also

BeginPath, DeleteMetaFile, GetEnhMetaFileBits, PolyBezier, SetMetaFileBitsEx, SetWinMetaFileBits, SetWorldTransform




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

GetMetaFileBitsEx



Функция GetMetaFileBitsEx извлекает содержание метафайла формата Windows-и копирует их в определенный буфер.

Эта функция предусмотрена для совместимости более ранними версиями Microsoft Windows. базирующиеся приложения Win32 должны использовать функцию GetEnhMetaFileBits.

UINT GetMetaFileBitsEx(

HMETAFILE hmf, // РУЧКА метафайла UINT nSize, // размера метафайла, в адресе байтов LPVOID lpvData // данных метафайла
);


Параметры

hmf

Идентифицирует метафайл формата Windows-.

nSize

Определяет размер, в байтах, буфера, чтобы получать данные.

lpvData

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



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

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

Замечания

После того, как биты метафайла Windows-будут извлечены, они могут быть использованы, чтобы создавать базирующийся метафайл памяти вызывая функцию SetMetaFileBitsEx.
Функция GetMetaFileBitsEx не аннулирует ручку метафайла. Приложение должно удалить эту ручку вызывая функцию DeleteMetaFile.
Метафайл формата Windows-не поддерживает новую кривую, путь, и функции преобразования, как например, PolyBezier, BeginPath, и SetWorldTransform. Приложения, которые используют эти новые функции и используют метафайлы, чтобы загружать изображения созданные этими функциями должно использовать функции метафайла расширенного формата.

Для того, чтобы преобразовывать метафайл формата Windows-в расширенный формат метафайла, используйте функцию SetWinMetaFileBits.

Смотри Также

BeginPath, DeleteMetaFile, GetEnhMetaFileBits, PolyBezier, SetMetaFileBitsEx, SetWinMetaFileBits, SetWorldTransform




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