Graphics.SetClip Метод

Определение

Задает в качестве отсеченной области данного объекта Graphics значение свойства Clip указанного объекта Graphics.Sets the clipping region of this Graphics to the Clip property of the specified Graphics.

Перегрузки

SetClip(Region, CombineMode)

Задает в качестве отсеченной области данного объекта Graphics результат указанной операции объединения текущей отсеченной области и заданной области Region.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified Region.

SetClip(RectangleF, CombineMode)

Задает в качестве отсеченной области данного объекта Graphics результат указанной операции объединения текущей отсеченной области и прямоугольника, задаваемого структурой RectangleF.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a RectangleF structure.

SetClip(Rectangle, CombineMode)

Задает в качестве отсеченной области данного объекта Graphics результат указанной операции объединения текущей отсеченной области и прямоугольника, задаваемого структурой Rectangle.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a Rectangle structure.

SetClip(GraphicsPath, CombineMode)

Задает в качестве отсеченной области данного объекта Graphics результат указанной операции объединения текущей отсеченной области и заданной области GraphicsPath.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified GraphicsPath.

SetClip(Graphics, CombineMode)

Задает в качестве отсеченной области данного объекта Graphics результат указанной операции объединения текущей отсеченной области и свойства Clip заданного объекта Graphics.Sets the clipping region of this Graphics to the result of the specified combining operation of the current clip region and the Clip property of the specified Graphics.

SetClip(Rectangle)

Задает в качестве отсеченной области данного объекта Graphics прямоугольник, задаваемый структурой Rectangle.Sets the clipping region of this Graphics to the rectangle specified by a Rectangle structure.

SetClip(Graphics)

Задает в качестве отсеченной области данного объекта Graphics значение свойства Clip указанного объекта Graphics.Sets the clipping region of this Graphics to the Clip property of the specified Graphics.

SetClip(GraphicsPath)

Задает в качестве отсеченной области данного объекта Graphics указанный объект GraphicsPath.Sets the clipping region of this Graphics to the specified GraphicsPath.

SetClip(RectangleF)

Задает в качестве отсеченной области данного объекта Graphics прямоугольник, задаваемый структурой RectangleF.Sets the clipping region of this Graphics to the rectangle specified by a RectangleF structure.

SetClip(Region, CombineMode)

Задает в качестве отсеченной области данного объекта Graphics результат указанной операции объединения текущей отсеченной области и заданной области Region.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified Region.

public:
 void SetClip(System::Drawing::Region ^ region, System::Drawing::Drawing2D::CombineMode combineMode);
public void SetClip (System.Drawing.Region region, System.Drawing.Drawing2D.CombineMode combineMode);
member this.SetClip : System.Drawing.Region * System.Drawing.Drawing2D.CombineMode -> unit

Параметры

region
Region

Область Region для объединения.Region to combine.

combineMode
CombineMode

Элемент из перечисления CombineMode, задающий используемую операцию объединения.Member from the CombineMode enumeration that specifies the combining operation to use.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает небольшой прямоугольник для вырезанной области.Creates a small rectangle for the clipping region.

  • Задает область отсечения прямоугольнику с элементом Replace.Sets the clipping region to the rectangle with the Replace member.

  • Заполняет большой прямоугольник сплошной черной кистью.Fills a large rectangle with a solid black brush.

Результатом является небольшой, закрашенный черный прямоугольник.The result is a small, filled, black rectangle.

public:
   void SetClipRegionCombine( PaintEventArgs^ e )
   {
      // Create region for clipping.
      System::Drawing::Region^ clipRegion = gcnew System::Drawing::Region( Rectangle(0,0,100,100) );

      // Set clipping region of graphics to region.
      e->Graphics->SetClip( clipRegion, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipRegionCombine(PaintEventArgs e)
{

    // Create region for clipping.
    Region clipRegion = new Region(new Rectangle(0, 0, 100, 100));

    // Set clipping region of graphics to region.
    e.Graphics.SetClip(clipRegion, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipRegionCombine(ByVal e As PaintEventArgs)

    ' Create region for clipping.
    Dim clipRegion As New [Region](New Rectangle(0, 0, 100, 100))

    ' Set clipping region of graphics to region.
    e.Graphics.SetClip(clipRegion, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(RectangleF, CombineMode)

Задает в качестве отсеченной области данного объекта Graphics результат указанной операции объединения текущей отсеченной области и прямоугольника, задаваемого структурой RectangleF.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a RectangleF structure.

public:
 void SetClip(System::Drawing::RectangleF rect, System::Drawing::Drawing2D::CombineMode combineMode);
public void SetClip (System.Drawing.RectangleF rect, System.Drawing.Drawing2D.CombineMode combineMode);
member this.SetClip : System.Drawing.RectangleF * System.Drawing.Drawing2D.CombineMode -> unit

Параметры

rect
RectangleF

Структура RectangleF для объединения.RectangleF structure to combine.

combineMode
CombineMode

Элемент перечисления CombineMode, задающий используемую операцию объединения.Member of the CombineMode enumeration that specifies the combining operation to use.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает небольшой прямоугольник для вырезанной области.Creates a small rectangle for the clipping region.

  • Задает область отсечения прямоугольнику с элементом Replace.Sets the clipping region to the rectangle with the Replace member.

  • Заполняет большой прямоугольник сплошной черной кистью.Fills a large rectangle with a solid black brush.

Результатом является небольшой, закрашенный черный прямоугольник.The result is a small, filled, black rectangle.

public:
   void SetClipRectangleFCombine( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      RectangleF clipRect = RectangleF(0.0F,0.0F,100.0F,100.0F);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipRectangleFCombine(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    RectangleF clipRect = new RectangleF(0.0F, 0.0F, 100.0F, 100.0F);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipRectangleFCombine(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New RectangleF(0.0F, 0.0F, 100.0F, 100.0F)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(Rectangle, CombineMode)

Задает в качестве отсеченной области данного объекта Graphics результат указанной операции объединения текущей отсеченной области и прямоугольника, задаваемого структурой Rectangle.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the rectangle specified by a Rectangle structure.

public:
 void SetClip(System::Drawing::Rectangle rect, System::Drawing::Drawing2D::CombineMode combineMode);
public void SetClip (System.Drawing.Rectangle rect, System.Drawing.Drawing2D.CombineMode combineMode);
member this.SetClip : System.Drawing.Rectangle * System.Drawing.Drawing2D.CombineMode -> unit

Параметры

rect
Rectangle

Структура Rectangle для объединения.Rectangle structure to combine.

combineMode
CombineMode

Элемент перечисления CombineMode, задающий используемую операцию объединения.Member of the CombineMode enumeration that specifies the combining operation to use.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает небольшой прямоугольник для вырезанной области.Creates a small rectangle for the clipping region.

  • Задает область отсечения прямоугольнику с элементом Replace.Sets the clipping region to the rectangle with the Replace member.

  • Заполняет большой прямоугольник сплошной черной кистью.Fills a large rectangle with a solid black brush.

Результатом является небольшой, закрашенный черный прямоугольник.The result is a small, filled, black rectangle.

public:
   void SetClipRectangleCombine( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      Rectangle clipRect = Rectangle(0,0,100,100);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipRectangleCombine(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    Rectangle clipRect = new Rectangle(0, 0, 100, 100);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipRectangleCombine(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New Rectangle(0, 0, 100, 100)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(GraphicsPath, CombineMode)

Задает в качестве отсеченной области данного объекта Graphics результат указанной операции объединения текущей отсеченной области и заданной области GraphicsPath.Sets the clipping region of this Graphics to the result of the specified operation combining the current clip region and the specified GraphicsPath.

public:
 void SetClip(System::Drawing::Drawing2D::GraphicsPath ^ path, System::Drawing::Drawing2D::CombineMode combineMode);
public void SetClip (System.Drawing.Drawing2D.GraphicsPath path, System.Drawing.Drawing2D.CombineMode combineMode);
member this.SetClip : System.Drawing.Drawing2D.GraphicsPath * System.Drawing.Drawing2D.CombineMode -> unit

Параметры

path
GraphicsPath

Область GraphicsPath для объединения.GraphicsPath to combine.

combineMode
CombineMode

Элемент перечисления CombineMode, задающий используемую операцию объединения.Member of the CombineMode enumeration that specifies the combining operation to use.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает графический контур и добавляет к нему эллипс.Creates a graphics path and adds an ellipse to the path.

  • Задает в качестве вырезанной области путь к эллиптическому контуру с элементом Replace.Sets the clipping region to the elliptical path with the Replace member.

  • Заполняет большой прямоугольник сплошной черной кистью.Fills a large rectangle with a solid black brush.

В результате получается закрашенный черный эллипс.The result is a filled, black ellipse.

public:
   void SetClipPathCombine( PaintEventArgs^ e )
   {
      // Create graphics path.
      GraphicsPath^ clipPath = gcnew GraphicsPath;
      clipPath->AddEllipse( 0, 0, 200, 100 );

      // Set clipping region to path.
      e->Graphics->SetClip( clipPath, CombineMode::Replace );

      // Fill rectangle to demonstrate clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipPathCombine(PaintEventArgs e)
{

    // Create graphics path.
    GraphicsPath clipPath = new GraphicsPath();
    clipPath.AddEllipse(0, 0, 200, 100);

    // Set clipping region to path.
    e.Graphics.SetClip(clipPath, CombineMode.Replace);

    // Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipPathCombine(ByVal e As PaintEventArgs)

    ' Create graphics path.
    Dim clipPath As New GraphicsPath
    clipPath.AddEllipse(0, 0, 200, 100)

    ' Set clipping region to path.
    e.Graphics.SetClip(clipPath, CombineMode.Replace)

    ' Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

Комментарии

Если графический путь, представленный параметром path, не закрыт, добавляется дополнительный сегмент из последней точки к первой точке, чтобы закрыть путь.If the graphics path represented by the path parameter is not closed, an additional segment is added from the last point to the first point to close the path.

SetClip(Graphics, CombineMode)

Задает в качестве отсеченной области данного объекта Graphics результат указанной операции объединения текущей отсеченной области и свойства Clip заданного объекта Graphics.Sets the clipping region of this Graphics to the result of the specified combining operation of the current clip region and the Clip property of the specified Graphics.

public:
 void SetClip(System::Drawing::Graphics ^ g, System::Drawing::Drawing2D::CombineMode combineMode);
public void SetClip (System.Drawing.Graphics g, System.Drawing.Drawing2D.CombineMode combineMode);
member this.SetClip : System.Drawing.Graphics * System.Drawing.Drawing2D.CombineMode -> unit

Параметры

g
Graphics

Объект Graphics, который задает отсеченную область для объединения.Graphics that specifies the clip region to combine.

combineMode
CombineMode

Элемент перечисления CombineMode, задающий используемую операцию объединения.Member of the CombineMode enumeration that specifies the combining operation to use.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint, а также thisForm, Form для примера.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler, as well as thisForm, the Form for the example. Код выполняет следующие действия.The code performs the following actions:

  • Создает временный Graphics из thisFormForm примера.Creates a temporary Graphics from the thisFormForm of the example.

  • Задает в качестве вырезанной области временной Graphics небольшой квадрат.Sets the clipping region of the temporary Graphics to a small square.

  • Обновляет область обрезки графического объекта формы до новой Graphics с элементом Replace.Updates the clipping region of the form's graphic object to that of the new Graphics with the Replace member.

  • Заполняет большой прямоугольник сплошной черной кистью.Fills a large rectangle with a solid black brush.

Результатом является небольшой, закрашенный черный квадрат.The result is a small, filled, black square.

public:
   void SetClipGraphicsCombine( PaintEventArgs^ e )
   {
      // Create temporary graphics object and set its clipping region.
      Graphics^ newGraphics = this->CreateGraphics();
      newGraphics->SetClip( Rectangle(0,0,100,100) );

      // Update clipping region of graphics to clipping region of new
      // graphics.
      e->Graphics->SetClip( newGraphics, CombineMode::Replace );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );

      // Release new graphics.
      delete newGraphics;
   }
private void SetClipGraphicsCombine(PaintEventArgs e)
{

    // Create temporary graphics object and set its clipping region.
    Graphics newGraphics = this.CreateGraphics();
    newGraphics.SetClip(new Rectangle(0, 0, 100, 100));

    // Update clipping region of graphics to clipping region of new

    // graphics.
    e.Graphics.SetClip(newGraphics, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);

    // Release new graphics.
    newGraphics.Dispose();
}
Private Sub SetClipGraphicsCombine(ByVal e As PaintEventArgs)

    ' Create temporary graphics object and set its clipping region.
    Dim newGraphics As Graphics = Me.CreateGraphics()
    newGraphics.SetClip(New Rectangle(0, 0, 100, 100))

    ' Update clipping region of graphics to clipping region of new

    ' graphics.
    e.Graphics.SetClip(newGraphics, CombineMode.Replace)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)

    ' Release new graphics.
    newGraphics.Dispose()
End Sub

SetClip(Rectangle)

Задает в качестве отсеченной области данного объекта Graphics прямоугольник, задаваемый структурой Rectangle.Sets the clipping region of this Graphics to the rectangle specified by a Rectangle structure.

public:
 void SetClip(System::Drawing::Rectangle rect);
public void SetClip (System.Drawing.Rectangle rect);
member this.SetClip : System.Drawing.Rectangle -> unit
Public Sub SetClip (rect As Rectangle)

Параметры

rect
Rectangle

Структура Rectangle, представляющая новую отсеченную область.Rectangle structure that represents the new clip region.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает небольшой прямоугольник для вырезанной области.Creates a small rectangle for the clipping region.

  • Задает область отсечения прямоугольнику.Sets the clipping region to the rectangle.

  • Заполняет большой прямоугольник сплошной черной кистью.Fills a large rectangle with a solid black brush.

Результатом является небольшой, закрашенный черный прямоугольник.The result is a small, filled, black rectangle.

public:
   void SetClipRectangle( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      Rectangle clipRect = Rectangle(0,0,100,100);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipRectangle(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    Rectangle clipRect = new Rectangle(0, 0, 100, 100);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipRectangle(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New Rectangle(0, 0, 100, 100)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

SetClip(Graphics)

Задает в качестве отсеченной области данного объекта Graphics значение свойства Clip указанного объекта Graphics.Sets the clipping region of this Graphics to the Clip property of the specified Graphics.

public:
 void SetClip(System::Drawing::Graphics ^ g);
public void SetClip (System.Drawing.Graphics g);
member this.SetClip : System.Drawing.Graphics -> unit
Public Sub SetClip (g As Graphics)

Параметры

g
Graphics

Объект Graphics, из которого извлекается новая отсеченная область.Graphics from which to take the new clip region.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint, а также thisForm, Form для примера.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler, as well as thisForm, the Form for the example. Код выполняет следующие действия.The code performs the following actions:

  • Создает временный Graphics из thisFormForm примера.Creates a temporary Graphics from the thisFormForm of the example.

  • Задает в качестве вырезанной области временной Graphics небольшой квадрат.Sets the clipping region of the temporary Graphics to a small square.

  • Обновляет область обрезки графического объекта формы до того, как она является временной Graphics.Updates the clipping region of the form's graphic object to that of the temporary Graphics.

  • Заполняет большой прямоугольник сплошной черной кистью.Fills a large rectangle with a solid black brush.

Результатом является небольшой, закрашенный черный квадрат.The result is a small, filled, black square.

public:
   void SetClipGraphics( PaintEventArgs^ e )
   {
      // Create temporary graphics object and set its clipping region.
      Graphics^ newGraphics = this->CreateGraphics();
      newGraphics->SetClip( Rectangle(0,0,100,100) );

      // Update clipping region of graphics to clipping region of new
      // graphics.
      e->Graphics->SetClip( newGraphics );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );

      // Release new graphics.
      delete newGraphics;
   }
private void SetClipGraphics(PaintEventArgs e)
{

    // Create temporary graphics object and set its clipping region.
    Graphics newGraphics = this.CreateGraphics();
    newGraphics.SetClip(new Rectangle(0, 0, 100, 100));

    // Update clipping region of graphics to clipping region of new

    // graphics.
    e.Graphics.SetClip(newGraphics);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);

    // Release new graphics.
    newGraphics.Dispose();
}
Private Sub SetClipGraphics(ByVal e As PaintEventArgs)

    ' Create temporary graphics object and set its clipping region.
    Dim newGraphics As Graphics = Me.CreateGraphics()
    newGraphics.SetClip(New Rectangle(0, 0, 100, 100))

    ' Update clipping region of graphics to clipping region of new

    ' graphics.
    e.Graphics.SetClip(newGraphics)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)

    ' Release new graphics.
    newGraphics.Dispose()
End Sub

SetClip(GraphicsPath)

Задает в качестве отсеченной области данного объекта Graphics указанный объект GraphicsPath.Sets the clipping region of this Graphics to the specified GraphicsPath.

public:
 void SetClip(System::Drawing::Drawing2D::GraphicsPath ^ path);
public void SetClip (System.Drawing.Drawing2D.GraphicsPath path);
member this.SetClip : System.Drawing.Drawing2D.GraphicsPath -> unit
Public Sub SetClip (path As GraphicsPath)

Параметры

path
GraphicsPath

Объект GraphicsPath, содержащий новую вырезанную область.GraphicsPath that represents the new clip region.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает графический контур и добавляет к нему эллипс.Creates a graphics path and adds an ellipse to the path.

  • Задает в качестве вырезанной области путь в виде эллиптического пути.Sets the clipping region to the elliptical path.

  • Заполняет большой прямоугольник сплошной черной кистью.Fills a large rectangle with a solid black brush.

В результате получается закрашенный черный эллипс.The result is a filled, black ellipse.

public:
   void SetClipPath( PaintEventArgs^ e )
   {
      // Create graphics path.
      GraphicsPath^ clipPath = gcnew GraphicsPath;
      clipPath->AddEllipse( 0, 0, 200, 100 );

      // Set clipping region to path.
      e->Graphics->SetClip( clipPath );

      // Fill rectangle to demonstrate clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipPath(PaintEventArgs e)
{

    // Create graphics path.
    GraphicsPath clipPath = new GraphicsPath();
    clipPath.AddEllipse(0, 0, 200, 100);

    // Set clipping region to path.
    e.Graphics.SetClip(clipPath);

    // Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipPath(ByVal e As PaintEventArgs)

    ' Create graphics path.
    Dim clipPath As New GraphicsPath
    clipPath.AddEllipse(0, 0, 200, 100)

    ' Set clipping region to path.
    e.Graphics.SetClip(clipPath)

    ' Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

Комментарии

Если графический путь, представленный параметром path, не закрыт, добавляется дополнительный сегмент из последней точки к первой точке, чтобы закрыть путь.If the graphics path represented by the path parameter is not closed, an additional segment is added from the last point to the first point to close the path.

SetClip(RectangleF)

Задает в качестве отсеченной области данного объекта Graphics прямоугольник, задаваемый структурой RectangleF.Sets the clipping region of this Graphics to the rectangle specified by a RectangleF structure.

public:
 void SetClip(System::Drawing::RectangleF rect);
public void SetClip (System.Drawing.RectangleF rect);
member this.SetClip : System.Drawing.RectangleF -> unit
Public Sub SetClip (rect As RectangleF)

Параметры

rect
RectangleF

Структура RectangleF, представляющая новую отсеченную область.RectangleF structure that represents the new clip region.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код выполняет следующие действия.The code performs the following actions:

  • Создает небольшой прямоугольник для вырезанной области.Creates a small rectangle for the clipping region.

  • Задает область отсечения прямоугольнику.Sets the clipping region to the rectangle.

  • Заполняет большой прямоугольник сплошной черной кистью.Fills a large rectangle with a solid black brush.

Результатом является небольшой, закрашенный черный прямоугольник.The result is a small, filled, black rectangle.

public:
   void SetClipRectangleF( PaintEventArgs^ e )
   {
      // Create rectangle for clipping region.
      RectangleF clipRect = RectangleF(0.0F,0.0F,100.0F,100.0F);

      // Set clipping region of graphics to rectangle.
      e->Graphics->SetClip( clipRect );

      // Fill rectangle to demonstrate clip region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Black ), 0, 0, 500, 300 );
   }
private void SetClipRectangleF(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    RectangleF clipRect = new RectangleF(0.0F, 0.0F, 100.0F, 100.0F);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}
Private Sub SetClipRectangleF(ByVal e As PaintEventArgs)

    ' Create rectangle for clipping region.
    Dim clipRect As New RectangleF(0.0F, 0.0F, 100.0F, 100.0F)

    ' Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect)

    ' Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Black), 0, 0, _
    500, 300)
End Sub

Применяется к