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

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); 
}

要件

こちらもご覧ください

ブラシと図形の塗りつぶし

パス グラデーションの作成

色のグラデーションで図形を塗りつぶす

PathGradientBrush

PathGradientBrush::GetWrapMode

PathGradientBrush::SetWrapMode