На главную

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

SetWinMetaFileBits



The SetWinMetaFileBits function converts a metafile from the older Windows format to the new enhanced format and stores the new metafile in memory.

HENHMETAFILE SetWinMetaFileBits(

UINT cbBuffer, // size of buffer
CONST BYTE *lpbBuffer, // address of buffered metafile data
HDC hdcRef, // handle of reference device context
CONST METAFILEPICT *lpmfp // suggested size of metafile picture
);


Parameters

cbBuffer

Specifies the size, in bytes, of the buffer that contains the Windows-format metafile.

lpbBuffer

Points to a buffer that contains the Windows-format metafile data. (It is assumed that the data was obtained by using the GetMetaFileBitsEx or GetWinMetaFileBits function.)

hdcRef

Identifies a reference device context.

lpmfp

Points to a METAFILEPICT structure that contains the suggested size of the metafile picture and the mapping mode that was used when the picture was created.



Return Values

If the function succeeds, the return value is a handle of a memory-based enhanced metafile.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

Windows uses the reference device context's resolution data and the data in the METAFILEPICT structure to scale a picture. If the hdcRef parameter is NULL, Windows uses resolution data for the current output device. If the lpmfp parameter is NULL, Windows uses the MM_ANISOTROPIC mapping mode to scale the picture so that it fits the entire device surface. The hMF field in the METAFILEPICT structure is not used.
When the application no longer needs the enhanced metafile handle, it should delete it by calling the DeleteEnhMetaFile function.

The handle returned by this function can be used with other enhanced-metafile functions.
If the reference device context is not identical to the device in which the metafile was originally created, some GDI functions that use device units may not draw the picture correctly.

See Also

DeleteEnhMetaFile, GetWinMetaFileBits, GetMetaFileBitsEx, METAFILEPICT, PlayEnhMetaFile


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

SetWinMetaFileBits



Функция SetWinMetaFileBits преобразовывает метафайл от более старого формата Windows до нового расширенного формата и загружает новый метафайл в память.

HENHMETAFILE SetWinMetaFileBits(

UINT cbBuffer, // РАЗМЕР буферного БАЙТА CONST *lpbBuffer, // адрес буферных данных метафайла HDC hdcRef, // контекст исходного устройства ручки CONST METAFILEPICT *lpmfp // предложенный размер изображения метафайла
);


Параметры

cbBuffer

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

lpbBuffer

Точки на буфер, которые содержат данные метафайла формата Windows-. ( Допущено что данные были получены использованием GetMetaFileBitsEx или GetWinMetaFileBits function.)

hdcRef

Идентифицирует контекст устройства ссылки.

lpmfp

Точки на структуру METAFILEPICT, которые содержат предложенный размер изображения метафайла и отображающий режим, который был использован когда изображение было создано.



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

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

Замечания

Windows использует устройство ссылки контекстного разрешения данных и данные в структуре METAFILEPICT, чтобы масштабировать изображение. Если параметр hdcRef НЕДЕЙСТВИТЕЛЕН, Windows использует разрешение данных для текущего выходного устройства. Если параметр lpmfp НЕДЕЙСТВИТЕЛЕН, Windows использует MM_ANISOTROPIC, отображающее режим, чтобы масштабировать изображение чтобы оно устанавливало целую поверхность устройства. Область hMF в структуре METAFILEPICT не использована.
Когда приложение больше не нужно расширенная ручка метафайла, это должно удалить это вызывая функцию DeleteEnhMetaFile.

Ручка возвращанная этой функцией может быть использована другим расширенным метафайлом функций.
Если контекст устройства ссылки не идентичен устройству в котором метафайл первоначально был создан, некоторые функции GDI, которые используют устройства устройства не может делать изображением правильно.

Смотри Также

DeleteEnhMetaFile, GetWinMetaFileBits, GetMetaFileBitsEx, METAFILEPICT, PlayEnhMetaFile


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