IXpsOMObjectFactory::CreateMatrixTransform-Methode (xpsobjectmodel.h)
Erstellt eine IXpsOMMatrixTransform-Schnittstelle , die eine affine Matrixtransformation angibt.
Syntax
HRESULT CreateMatrixTransform(
[in] const XPS_MATRIX *matrix,
[out, retval] IXpsOMMatrixTransform **transform
);
Parameter
[in] matrix
Die anfängliche Matrix, die der Transformation zugewiesen werden soll.
[out, retval] transform
Ein Zeiger auf die neue IXpsOMMatrixTransform-Schnittstelle .
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle. Informationen zu XPS-Dokument-API-Rückgabewerten, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Matrix oder Transformation ist NULL. |
Hinweise
Die in dieser Matrix angegebene Transformation kann auf die Transformationseigenschaft anderer XPS-Objekte angewendet werden.
Das folgende Codebeispiel veranschaulicht, wie diese Methode zum Erstellen einer neuen Schnittstelle verwendet wird.
IXpsOMMatrixTransform *newInterface;
// The following value is defined outside of
// this example.
XPS_MATRIX newMatrix;
// Note the implicit requirement that CoInitializeEx
// has previously been called from this thread.
hr = CoCreateInstance(
__uuidof(XpsOMObjectFactory),
NULL,
CLSCTX_INPROC_SERVER,
_uuidof(IXpsOMObjectFactory),
reinterpret_cast<LPVOID*>(&xpsFactory)
);
if (SUCCEEDED(hr))
{
hr = xpsFactory->CreateMatrixTransform (
&newMatrix,
&newInterface);
if (SUCCEEDED(hr))
{
// use newInterface
newInterface->Release();
}
xpsFactory->Release();
}
else
{
// evaluate HRESULT error returned in hr
}
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |