ホーム › Storage.Xps › IXpsOMMatrixTransform
IXpsOMMatrixTransform
COM公式ドキュメント
オブジェクトモデル内の他のオブジェクトに適用できるアフィン行列変換を指定します。
解説(Remarks)
次のコード例は、このインターフェイスのインスタンスを作成する方法を示しています。
IXpsOMMatrixTransform *newInterface;
// 次の値は、この例の外部で
// 定義されています。
XPS_MATRIX newMatrix;
// このスレッドで CoInitializeEx が事前に
// 呼び出されている必要があることに注意してください。
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))
{
// newInterface を使用する
newInterface->Release();
}
xpsFactory->Release();
}
else
{
// hr で返された HRESULT エラーを評価する
}
メソッド 3
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 5 HRESULT GetMatrix(XPS_MATRIX* matrix)
変換行列を指定する XPS_MATRIX 構造体を取得します。
| matrix | XPS_MATRIX* | out | XPS_MATRIX 構造体を受け取る変数のアドレス。 |
戻り値
このメソッドは HRESULT を返します。返される値には、次の表に示すものが含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、XPS ドキュメントのエラーを参照してください。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 | |
| matrix が NULL です。 |
vtbl 6 HRESULT SetMatrix(XPS_MATRIX* matrix)
変換行列を指定する XPS_MATRIX 構造体を設定します。
| matrix | XPS_MATRIX* | in | XPS_MATRIX 構造体のアドレス。 |
戻り値
このメソッドは HRESULT を返します。返される値には、次の表に示すものが含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、XPS ドキュメントのエラーを参照してください。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 | |
| matrix が NULL です。 | |
| matrix が参照する行列が有効ではありません。 |
vtbl 7 HRESULT Clone(IXpsOMMatrixTransform** matrixTransform)
インターフェイスのディープコピーを作成します。(IXpsOMMatrixTransform.Clone)
| matrixTransform | IXpsOMMatrixTransform** | out | インターフェイスのコピーへのポインター。 |
戻り値
このメソッドは HRESULT を返します。返される値には、次の表に示すものが含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、XPS ドキュメントのエラーを参照してください。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 | |
| この操作を実行するのに十分なメモリがありません。 | |
| matrixTransform が NULL です。 |
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IXpsOMMatrixTransform "{B77330FF-BB37-4501-A93E-F1B1E50BFC46}" #usecom global IXpsOMMatrixTransform IID_IXpsOMMatrixTransform "{}" #comfunc global IXpsOMMatrixTransform_GetMatrix 5 var #comfunc global IXpsOMMatrixTransform_SetMatrix 6 var #comfunc global IXpsOMMatrixTransform_Clone 7 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IXpsOMMatrixTransform "{B77330FF-BB37-4501-A93E-F1B1E50BFC46}" #usecom global IXpsOMMatrixTransform IID_IXpsOMMatrixTransform "{}" #comfunc global IXpsOMMatrixTransform_GetMatrix 5 sptr #comfunc global IXpsOMMatrixTransform_SetMatrix 6 sptr #comfunc global IXpsOMMatrixTransform_Clone 7 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。