TextureBrush::GetTransform メソッド (gdiplusbrush.h)
TextureBrush::GetTransform メソッドは、このテクスチャ ブラシの変換マトリックスを取得します。
構文
Status GetTransform(
[out] Matrix *matrix
);
パラメーター
[out] matrix
種類: マトリックス*
変換行列を受け取る Matrix オブジェクトへのポインター。
戻り値
種類: 状態
メソッドが成功した場合は、Status 列挙の要素である Ok を返します。
メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。
解説
TextureBrush オブジェクトは、任意のアフィン変換を格納できる変換行列を保持します。 テクスチャ ブラシを使用して領域を塗りつぶすと、GDI+ はブラシの変換マトリックスに従ってブラシのイメージを変換し、領域を塗りつぶします。 変換されたイメージは、レンダリング中にのみ存在します。 TextureBrush オブジェクトに格納されているイメージは変換されません。 たとえば、 someTextureBrush.ScaleTransform(3) を呼び出し、 someTextureBrush で領域を塗りつぶすとします。 領域を塗りつぶすとブラシのイメージの幅は 3 倍になりますが、 someTextureBrush に格納されているイメージは変更されません。
例
次の例では、テクスチャ ブラシを作成し、ブラシの変換を設定します。 次に、このコードはブラシの変換マトリックスを取得し、要素の検査または使用に進みます。
VOID Example_GetTransform(HDC hdc)
{
Graphics graphics(hdc);
// Create a texture brush, and set its transform.
Image image(L"marble.jpg");
TextureBrush textureBrush(&image);
textureBrush.ScaleTransform(3, 2);
// Obtain information about the texture brush.
Matrix matrix;
REAL elements[6];
textureBrush.GetTransform(&matrix);
matrix.GetElements(elements);
for(INT j = 0; j <=5; ++j)
{
// Inspect or use the value in elements[j].
}
}
要件
| サポートされている最小のクライアント | Windows XP、Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | gdiplusbrush.h (Gdiplus.h を含む) |
| Library | Gdiplus.lib |
| [DLL] | Gdiplus.dll |