IXpsOMGradientBrush::GetTransformLookup-Methode (xpsobjectmodel.h)
Ruft den Namen des Nachschlageschlüssels der Transformationsschnittstelle der freigegebenen Matrix ab, die für den Pinsel verwendet werden soll.
Der Schlüsselname identifiziert eine freigegebene Ressource in einem Ressourcenverzeichnis.
Syntax
HRESULT GetTransformLookup(
[out, retval] LPWSTR *key
);
Parameter
[out, retval] key
Der Name des Nachschlageschlüssels der Transformationsschnittstelle der freigegebenen Matrix, die für den Pinsel verwendet werden soll. Wenn der Name des Suchschlüssels nicht festgelegt wurde oder die lokale Matrixtransformation festgelegt wurde, wird ein NULL-Zeiger zurückgegeben.
Der wert, der in diesem Parameter zurückgegeben wird, hängt davon ab, welche Methode zuletzt aufgerufen wurde, um den Nachschlageschlüssel oder die Transformation festzulegen.
| Die neueste Methode wurde aufgerufen. | Zeichenfolge, die im Schlüssel zurückgegeben wird |
|---|---|
| NULL-Zeiger . | |
| Der Schlüssel, der von SetTransformLookup festgelegt wird. | |
| Weder SetTransformLocal noch SetTransformLookup wurde noch aufgerufen. | NULL-Zeiger . |
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Informationen zu Rückgabewerten der XPS-Dokument-API, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
key ist NULL. |
Hinweise
Diese Methode gibt keinen IXpsOMMatrixTransform-Schnittstellenzeiger zurück. Rufen Sie IXpsOMDictionary::GetByKey auf, um diesen Zeiger aus dem Wörterbuch abzurufen.
Die Transformation bestimmt, wie der Farbverlauf transformiert wird. Der sichtbare Teil des Farbverlaufs, der letztendlich im Bild gerendert wird, wird durch den Pfad, den Strich oder die Glyphe bestimmt, die den Farbverlaufpinsel verwendet.
Diese Methode ordnet den Arbeitsspeicher zu, der von der Zeichenfolge verwendet wird, die in key zurückgegeben wird. Wenn key nicht NULL ist, verwenden Sie die CoTaskMemFree-Funktion , um den Arbeitsspeicher freizugeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | xpsobjectmodel.h |