PathGradientBrush::SetWrapMode メソッド (gdipluspath.h)

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

PathGradientBrush::SetWrapMode メソッドは、このパスグラデーションブラシのラップモードを設定します。

構文

Status SetWrapMode(
  [in] WrapMode wrapMode
);

パラメーター

[in] wrapMode

型: WrapMode

パスグラデーションブラシで塗りつぶされた領域を並べて表示する方法を指定する WrapMode 列挙体の要素。既定値は WrapModeClamp です。

戻り値

種類: 状態

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

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

注釈

パスグラデーションブラシの外接する四角形は、ブラシの境界パスを囲む最小の四角形です。パスグラデーションブラシを使用して外接する四角形を塗りつぶすと、境界パス内の領域のみが塗りつぶされます。外接する四角形内の境界パスの外側の領域は塗りつぶされません。

WrapModeClamp (既定のラップモード) は、ブラシの外接する四角形の外側で描画が行われないことを示します。他のすべてのラップモードは、ブラシの外接する四角形の外側の領域がタイル化されることを示します。各タイルは、外接する四角形内の塗りつぶされたパスのコピー (場合によっては反転) です。

例

次の例では、三角形のパスに基づいて PathGradientBrush オブジェクトを作成します。このコードでは、 PathGradientBrush オブジェクトの PathGradientBrush::SetWrapMode メソッドを呼び出して、ブラシのラップモードを WrapModeTileFlipX に設定します。 Graphics::FillRectangle メソッドは、パスグラデーションブラシを使用して大きな領域をタイル化します。

コードの出力はタイルのグリッドです。特定の行の 1 つのタイルから次のタイルに移動すると、画像 (境界の四角形内の塗りつぶされた境界パス) が水平方向に反転されます。

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

   Point points[] = {
      Point(0, 0), 
      Point(100, 0), 
      Point(100, 100)};

   Color colors[] = {
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255),   // blue
      Color(255, 0, 255, 0)};  // green

   INT count = 3;

   PathGradientBrush pthGrBrush(points, 3);
   pthGrBrush.SetSurroundColors(colors, &count);
   pthGrBrush.SetWrapMode(WrapModeTileFlipX);

   graphics.FillRectangle(&pthGrBrush, 0, 0, 800, 800); 
}

要件

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