LinearGradientBrush::GetTransform メソッド (gdiplusbrush.h)
LinearGradientBrush::GetTransform メソッドは、この線形グラデーション ブラシの変換行列を取得します。
構文
Status GetTransform(
[out] Matrix *matrix
);
パラメーター
[out] matrix
種類: Matrix*
変換行列を受け取る Matrix オブジェクトへのポインター。
戻り値
種類: 状態
メソッドが成功した場合は、 Status 列挙の要素である Ok を返します。
メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。
解説
LinearGradientBrush オブジェクトは、任意のアフィン変換を格納できる変換行列を保持します。 線形グラデーション ブラシを使用して領域を塗りつぶすと、GDI+ はブラシの変換マトリックスに従ってブラシの境界線を変換し、領域を塗りつぶします。 変換された境界は、レンダリング中にのみ存在します。 LinearGradientBrush オブジェクトに格納されている境界は変換されません。
例
次の例では、線形グラデーション ブラシを作成し、その変換行列を設定します。 次に、このコードはブラシの変換行列を取得し、マトリックス要素の検査または使用に進みます。
VOID Example_GetTransform(HDC hdc)
{
Graphics myGraphics(hdc);
// Construct a linear gradient brush, and set its transformation.
LinearGradientBrush linGrBrush(
Point(0, 0),
Point(200, 0),
Color(255, 255, 0, 0), // red
Color(255, 0, 0, 255)); // blue
Matrix matrixSet(0, 1, -1, 0, 0, 0);
linGrBrush.SetTransform(&matrixSet);
// Obtain information about the linear gradient brush.
Matrix matrixGet;
REAL elements[6];
linGrBrush.GetTransform(&matrixGet);
matrixGet.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 |