Pixelformatfunktionen
Die folgenden Windows-Funktionen verwalten Pixelformate.
Windows-Funktion | BESCHREIBUNG |
---|---|
ChoosePixelFormat | Ruft das Pixelformat des Gerätekontexts ab, das einem angegebenen Pixelformat am nächsten kommt. |
SetPixelFormat | Legt das aktuelle Pixelformat eines Gerätekontexts auf das Pixelformat fest, das von einem Pixelformatindex angegeben wird. |
GetPixelFormat | Ruft den Pixelformatindex des aktuellen Pixelformats eines Gerätekontexts ab. |
DescribePixelFormat | Bei einem Gerätekontext und einem Pixelformatindex wird eine PIXELFORMATDESCRIPTOR-Datenstruktur mit den Eigenschaften des Pixelformats ausgefüllt. |
GetEnhMetaFilePixelFormat | Ruft Pixelformatinformationen für eine erweiterte Metadatei ab. |
Die ChoosePixelFormat-Funktion gibt einen 1-basierten Pixelformatindex zurück, der die beste Übereinstimmung aus den unterstützten Pixelformaten des Gerätekontexts identifiziert.
Die SetPixelFormat-Funktion identifiziert das gewünschte Format mithilfe eines 1-basierten Pixelformatindex. In der Regel rufen Sie ChoosePixelFormat auf, um ein pixelgenaues Format zu finden, und rufen dann SetPixelFormat mit dem Ergebnis ChoosePixelFormat auf.
Wenn Sie SetPixelFormat für einen Gerätekontext aufrufen, der auf ein Fenster verweist, ändert SetPixelFormat auch das Pixelformat des Fensters. Wenn Sie das Pixelformat eines Fensters mehrmals festlegen, kann dies zu erheblichen Komplikationen für den Fenster-Manager und für Multithreadanwendungen führen, sodass dies nicht zulässig ist. Sie können das Pixelformat eines Fensters nur einmal festlegen. Danach kann das Pixelformat des Fensters nicht mehr geändert werden.
Die GetPixelFormat-Funktion gibt einen 1-basierten Pixelformatindex zurück.
Die DescribePixelFormat-Funktion verwendet Folgendes als Parameter:
- Ein Handle für einen Gerätekontext
- Ein Pixelformatindex
- Ein Zeiger auf eine PIXELFORMATDESCRIPTOR-Datenstruktur
Die DescribePixelFormat-Funktion gibt zurück, wobei die Member von PIXELFORMATDESCRIPTOR entsprechend festgelegt sind.
Die GetEnhMetaFilePixelFormat-Funktion gibt die Größe des Pixelformats einer Metadatei zurück und ruft die Pixelformatinformationen der Metadatei ab.