CMetaFileDC::CreateEnhanced
Tworzy kontekstu urządzenia dla formatu enhanced metafile.
BOOL CreateEnhanced(
CDC* pDCRef,
LPCTSTR lpszFileName,
LPCRECT lpBounds,
LPCTSTR lpszDescription
);
Parametry
pDCRef
Identyfikuje urządzenie odniesienia dla rozszerzonego metapliku.lpszFileName
Punkty do ciągu zakończonego znakiem null.Określa nazwę pliku dla rozszerzonego metapliku ma zostać utworzony.Jeśli ten parametr jest NULL, rozszerzony metaplik jest oparty pamięci i jego zawartość utracone, kiedy niszczony jest obiekt lub gdy Win32 DeleteEnhMetaFile wywoływana jest funkcja.lpBounds
Wskazuje na RECT struktury danych lub CRect obiekt, który określa wymiary w HIMETRIC jednostek (w skokach co.01 milimetra) obraz ma być przechowywana w formacie rozszerzonego metapliku.lpszDescription
Wskazuje ciąg zakończony zerem, określający nazwę aplikacji, która utworzyła obrazu, jak również tytuł obrazu.
Wartość zwracana
Dojście kontekstu urządzenia dla rozszerzonego metapliku, jeśli kończy się pomyślnie; w przeciwnym razie NULL.
Uwagi
Ten kontroler domeny może służyć do przechowywania obrazu niezależny od urządzenia.
System Windows używa urządzenia odniesienia identyfikowane przez pDCRef parametr rejestrować rozdzielczość i jednostek urządzenia, w którym pierwotnie wystąpiła obrazu.Jeśli pDCRef jest parametr NULL, używa bieżącego urządzenia wyświetlającego dla odwołania.
Lewa i górna członkami RECT struktury danych wskazywanej przez lpBounds parametr musi być mniejszy niż członkowie prawej i dolnej, odpowiednio.Punkty wzdłuż krawędzi prostokąta są uwzględniane w obrazie.Jeśli lpBounds jest NULL, graficzny interfejs urządzenia (GDI) oblicza wymiary najmniejszego prostokąta, który można ująć obraz rysowane przez aplikację.lpBounds Parametru powinny być dostarczane w przypadku, gdy jest to możliwe.
Ciąg wskazywanej przez lpszDescription parametr musi zawierać znak null między nazwę aplikacji i nazwę obrazu i musi zakończyć się dwoma znakami null — na przykład "XYZ grafiki Editor\0Bald Eagle\0\0," gdzie \0 reprezentuje znak null.Jeśli lpszDescription jest NULL, brak odpowiedniego wpisu w nagłówku rozszerzonych metaplików.
Aplikacje używają DC utworzone przez tę funkcję do przechowywania obrazów graficznych w formacie rozszerzonego metapliku.Uchwyt identyfikujący ten kontroler domeny mogą być przekazywane do dowolnej funkcji interfejsu GDI.
Po aplikacja przechowuje obraz w formacie rozszerzonego metapliku, go wyowietlić obraz na dowolnym urządzeniu wyjściowym, wywołując CDC::PlayMetaFile funkcji.Wyświetlając obraz systemu Windows używa prostokąt wskazywanej przez lpBounds parametrów i danych rozdzielczość urządzenia odniesienia do pozycji i Skaluj obraz.Kontekstu urządzenia zwracana przez tę funkcję zawiera te same atrybuty domyślne skojarzone z dowolnego nowego kontrolera domeny.
Aplikacje muszą używać Win32 GetWinMetaFileBits funkcji konwersji rozszerzony metaplik Windows na starszy format Metaplik Windows.
Należy użyć nazwy pliku w formacie rozszerzonego metapliku.Rozszerzenie EMF.
Wymagania
Nagłówek: afxext.h