PathGradientBrush::GetCenterPoint(Point*) メソッド (gdipluspath.h)

[アーティクル]
02/29/2024

PathGradientBrush::GetCenterPoint メソッドは、このパスグラデーションブラシの中心点を取得します。

構文

Status GetCenterPoint(
  [out] Point *point
);

パラメーター

[out] point

種類: ポイント*

中心点を受け取る Point オブジェクトへのポインター。

戻り値

種類: 状態

メソッドが成功した場合は、Status 列挙の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

注釈

既定では、PathGradientBrush オブジェクトの中心点はブラシの境界パスの重心にありますが、PathGradientBrush オブジェクトの SetCenterPoint メソッドを呼び出すことで、パスの内側または外側の任意の場所に中心点を設定できます。

例

次の例では、PathGradientBrush::GetCenterPoint や PathGradientBrush::SetCenterColor など、PathGradientBrush クラスのいくつかのメソッドを示します。このコードでは 、PathGradientBrush オブジェクトを作成し、ブラシの中心の色と境界の色を設定します。このコードでは 、PathGradientBrush::GetCenterPoint メソッドを呼び出してパスグラデーションブラシの中心点を決定し、原点からその中心点までの線を描画します。

VOID Example_GetCenterPoint(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a path that consists of a single ellipse.
   GraphicsPath path;
   path.AddEllipse(0, 0, 200, 100);

   // Use the path to construct a brush.
   PathGradientBrush pthGrBrush(&path);

   // Set the color at the center of the path to blue.
   pthGrBrush.SetCenterColor(Color(255, 0, 0, 255));

   // Set the color along the entire boundary of the path to aqua.
   Color colors[] = {Color(255, 0, 255, 255)};
   INT count = 1;
   pthGrBrush.SetSurroundColors(colors, &count);

   // Fill the ellipse with the path gradient brush.
   graphics.FillEllipse(&pthGrBrush, 0, 0, 200, 100);

   // Obtain information about the path gradient brush.
   Point  centerPoint;
   pthGrBrush.GetCenterPoint(&centerPoint);

   // Draw a line from the origin to the center of the ellipse.
   Pen pen(Color(255, 0, 255, 0));
   graphics.DrawLine(&pen, Point(0, 0), centerPoint);
}

要件

要件	値
サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdipluspath.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll