CMetaFileDC::CreateEnhanced

BOOL CreateEnhanced ( CDC * pDCRef, LPCTSTR lpszFileName, LPCRECT lpBounds, LPCTSTR lpszDescription );

Wartość zwracany

Dojście kontekstu urządzenia dla rozszerzonego metapliku, jeśli kończy się pomyślnie; inny sposób NULL.

Parametry

pDCRef

Określa urządzenie odniesienia dla rozszerzonego metapliku.

lpszFileName

Wskazuje ciąg zakończony wartością zerową znaków. Określa nazwę pliku dla rozszerzonego metapliku ma być utworzony. Jeśli ten parametr ma wartość NULL, rozszerzony metaplik jest pamięć i jego zawartość utracone, kiedy niszczony jest obiekt, lub gdy :: DeleteEnhMetaFile funkcja jest wywoływana.

lpBounds

Punkty RECT struktury danych lub obiekt CRect , który określa wymiary w jednostkach HIMETRIC (w skokach co.01-milimetra) obrazu ma być przechowywana w formacie rozszerzonego metapliku.

lpszDescription

Wskazuje ciąg zakończony zerem, określający nazwę aplikacji, która utworzyła obraz, jak również tytuł obrazu.

Uwagi

Tworzy kontekstu urządzenia w formacie rozszerzonego metapliku. Ten kontroler domeny może służyć do przechowywania obrazu niezależny od urządzenia.

System Windows używa urządzenia odniesienia określone przez parametr pDCRef do rejestrowania rozdzielczość i jednostek urządzenie, w którym wystąpiła pierwotnie obraz. Jeżeli parametr pDCRef ma wartość NULL, używa bieżącego urządzenia wyświetlającego odniesienia.

Lewa i Górna członków struktury danych RECT wskazywanego przez parametr lpBounds musi być mniejszy niż członkowie prawej i dolnej, odpowiednio. Punkty wzdłuż krawędzi prostokąta znajdują się na rysunku. Jeśli lpBounds ma wartość NULL, graficzny interfejs urządzenia (GDI) oblicza wymiary najmniejszego prostokąta, który można ująć obraz rysowane przez aplikację. Parametr lpBounds powinny być dostarczone, w przypadku gdy jest to możliwe.

Ciąg wskazywanego przez parametr lpszDescription musi zawierać znak null między nazwę aplikacji i nazwę obrazu i musi być zakończone z dwoma znakami null — na przykład "XYZ grafiki Editor\0Bald Eagle\0\0," gdzie \0 reprezentuje znak null. Jeśli lpszDescription ma wartość NULL, jest nie odpowiedniego wpisu w nagłówku rozszerzony metaplik.

Aplikacje używają DC tworzony przez tę funkcję do przechowywania obrazów graficznych w formacie rozszerzonego metapliku. Uchwyt identyfikujący ten kontroler domeny mogą być przekazane do dowolnej funkcji interfejsu GDI.

Po aplikacja przechowuje obraz w formacie rozszerzonego metapliku, go wyowietlić obraz na dowolnym urządzeniu wyjściowym przez wywołanie funkcji CDC::PlayMetaFile . Podczas wyświetlania obrazu, system Windows użyje prostokąt wskazywanego przez parametr lpBounds i danych rezolucji z urządzenia odniesienia położenia i skalowania obrazu. Kontekstu urządzenia, zwracana przez tę funkcję zawiera te same atrybuty domyślne skojarzone z jakiegokolwiek nowego kontrolera domeny.

Aplikacje muszą używać :: GetWinMetaFileBits funkcji konwersji rozszerzony metaplik Windows na starszy format Metaplik Windows.

Należy użyć pliku w formacie rozszerzonego metapliku.Rozszerzeniem EMF.

Omówie&nie CMetaFileDC |nbsp; Klasa członków | Wykres hierarchii

See Also   CMetaFileDC::CloseEnhanced, CDC::PlayMetaFile, ::CloseEnhMetaFile, ::DeleteEnhMetaFile, ::GetEnhMetaFileDescription, ::GetEnhMetaFileHeader, ::GetWinMetaFileBits, ::PlayEnhMetaFile

Index