Udostępnij za pośrednictwem


CDC::PlayMetaFile

Odtwarza zawartość określonego metapliku kontekstu urządzenia.

BOOL PlayMetaFile(
   HMETAFILE hMF 
);
BOOL PlayMetaFile(
   HENHMETAFILE hEnhMetaFile,
   LPCRECT lpBounds 
);

Parametry

  • hMF
    Identyfikuje metapliku może być odtwarzany.

  • hEnhMetaFile
    Identyfikuje rozszerzonego metapliku.

  • lpBounds
    Wskazuje na RECT struktury lub CRect obiekt, który zawiera współrzędne prostokąta obwiedni, używany do wyświetlania obrazu.Współrzędne są określone w jednostkach logicznych.

Wartość zwracana

Niezerowa, jeśli funkcja jest pomyślne; 0 inaczej.

Uwagi

Metaplik można odtwarzać dowolną liczbę razy.

Druga wersja z PlayMetaFile Wyświetla obraz przechowywany w danym metaplik rozszerzony format.Gdy aplikacja wywołuje druga wersja z PlayMetaFile, system Windows używa ramki obrazu enhanced metafile nagłówka do mapę obrazu na prostokąt wskazywanej przez lpBounds parametru.(Ten obraz może być ścięty lub obrócony przez ustawienie Przekształcanie świata w urządzenie wyjściowe przed wywoływaniem PlayMetaFile.) Punkty wzdłuż krawędzi prostokąta są uwzględniane w obrazie.Definiując obszar przycinania urządzenie wyjściowe przed rozpoczęciem gry, rozszerzony metaplik można przyciąć obrazu enhanced metafile.

Jeśli rozszerzony metaplik zawiera opcjonalny palety, poprzez ustawienie palety kolorów urządzenia wyjściowego przed wywołaniem druga wersja aplikacji można osiągnąć spójne kolory PlayMetaFile.Aby pobrać paletę opcjonalne, należy użyć GetEnhMetaFilePaletteEntries funkcji systemu Windows.Rozszerzony metaplik można osadzić w nowo utworzony metaplik, wywołując druga wersja PlayMetaFile i odtwarzanie metaplik rozszerzony źródła do kontekstu urządzenia nowy rozszerzony metaplik.

Państwa kontekstu urządzenia wyjściowego są zachowywane przez tę funkcję.Każdy obiekt utworzony, ale nie usunięte w formacie rozszerzonego metapliku skreśla się przez tę funkcję.Aby zatrzymać tę funkcję, aplikacja może wywołać CancelDC funkcji systemu Windows z innego wątku, aby zakończyć operację.W takim przypadku funkcja zwraca zero.

Wymagania

Nagłówek: afxwin.h

Zobacz też

Informacje

Klasa CDC

Wykres hierarchii

CancelDC

GetEnhMetaFileHeader

GetEnhMetaFilePaletteEntries

SetWorldTransform

PlayMetaFile

PlayEnhMetaFile

PlayMetaFile