Graphics.SetClip Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v9.0.0-preview.6.24327.6

Задает область вырезки этого Graphics свойству Clip указанного Graphics.

Перегрузки

SetClip(Region, CombineMode)	Задает область вырезки этого Graphics результатом указанной операции, объединяющей текущий регион клипа и указанный Region.
SetClip(RectangleF, CombineMode)	Задает область вырезки этого Graphics результатом указанной операции объединения текущей области клипа и прямоугольника, указанного структурой RectangleF.
SetClip(Rectangle, CombineMode)	Задает область вырезки этого Graphics результатом указанной операции объединения текущей области клипа и прямоугольника, указанного структурой Rectangle.
SetClip(Graphics, CombineMode)	Задает область вырезки этого Graphics результатом указанной операции объединения текущей области клипа и свойства Clip указанного Graphics.
SetClip(GraphicsPath, CombineMode)	Задает область вырезки этого Graphics результатом указанной операции, объединяющей текущий регион клипа и указанный GraphicsPath.
SetClip(RectangleF)	Задает область вырезки этого Graphics прямоугольнику, заданному структурой RectangleF.
SetClip(Rectangle)	Задает область вырезки этого Graphics прямоугольнику, заданному структурой Rectangle.
SetClip(Graphics)	Задает область вырезки этого Graphics свойству Clip указанного Graphics.
SetClip(GraphicsPath)	Задает область вырезки этого Graphics указанным GraphicsPath.

SetClip(Region, CombineMode)

Исходный код:

Graphics.cs

Задает область вырезки этого Graphics результатом указанной операции, объединяющей текущий регион клипа и указанный 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

Public Sub SetClip (region As Region, combineMode As CombineMode)

Параметры

region

Region

Region объединить.

combineMode

CombineMode

Элемент из перечисления CombineMode, указывающий используемую операцию объединения.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint. Код выполняет следующие действия:

• Создает небольшой прямоугольник для области вырезки.

• Задает область вырезки прямоугольником с элементом Replace.

• Заполняет большой прямоугольник с твердой черной кистью.

Результатом является небольшой, заполненный, черный прямоугольник.

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.cs

Задает область вырезки этого Graphics результатом указанной операции объединения текущей области клипа и прямоугольника, указанного структурой RectangleF.

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

Public Sub SetClip (rect As RectangleF, combineMode As CombineMode)

Параметры

rect

RectangleF

RectangleF структуру для объединения.

combineMode

CombineMode

Элемент перечисления CombineMode, указывающий операцию объединения для использования.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint. Код выполняет следующие действия:

• Создает небольшой прямоугольник для области вырезки.

• Задает область вырезки прямоугольником с элементом Replace.

• Заполняет большой прямоугольник с твердой черной кистью.

Результатом является небольшой, заполненный, черный прямоугольник.

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.cs

Задает область вырезки этого Graphics результатом указанной операции объединения текущей области клипа и прямоугольника, указанного структурой Rectangle.

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

Public Sub SetClip (rect As Rectangle, combineMode As CombineMode)

Параметры

rect

Rectangle

Rectangle структуру для объединения.

combineMode

CombineMode

Элемент перечисления CombineMode, указывающий операцию объединения для использования.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint. Код выполняет следующие действия:

• Создает небольшой прямоугольник для области вырезки.

• Задает область вырезки прямоугольником с элементом Replace.

• Заполняет большой прямоугольник с твердой черной кистью.

Результатом является небольшой, заполненный, черный прямоугольник.

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(Graphics, CombineMode)

Исходный код:

Graphics.cs

Задает область вырезки этого Graphics результатом указанной операции объединения текущей области клипа и свойства Clip указанного 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

Public Sub SetClip (g As Graphics, combineMode As CombineMode)

Параметры

g

Graphics

Graphics, указывающий область клипа для объединения.

combineMode

CombineMode

Элемент перечисления CombineMode, указывающий операцию объединения для использования.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint, а также thisForm, Form для примера. Код выполняет следующие действия:

• Создает временный Graphics из thisFormForm примера.

• Задает область вырезки временной Graphics на небольшой квадрат.

• Обновляет область вырезки графического объекта формы до новой Graphics с элементом Replace.

• Заполняет большой прямоугольник с твердой черной кистью.

Результатом является небольшая, заполненная, черная квадрат.

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(GraphicsPath, CombineMode)

Исходный код:

Graphics.cs

Задает область вырезки этого Graphics результатом указанной операции, объединяющей текущий регион клипа и указанный 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

Public Sub SetClip (path As GraphicsPath, combineMode As CombineMode)

Параметры

path

GraphicsPath

GraphicsPath объединить.

combineMode

CombineMode

Элемент перечисления CombineMode, указывающий операцию объединения для использования.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint. Код выполняет следующие действия:

• Создает графический путь и добавляет многоточие в путь.

• Задает область вырезки в эллиптические пути с элементом Replace.

• Заполняет большой прямоугольник с твердой черной кистью.

Результатом является заполненный, черный многоточие.

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, не закрыт, дополнительный сегмент добавляется из последней точки в первую точку, чтобы закрыть путь.

SetClip(RectangleF)

Исходный код:

Graphics.cs

Задает область вырезки этого Graphics прямоугольнику, заданному структурой RectangleF.

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 структура, представляющая новый регион клипа.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint. Код выполняет следующие действия:

• Создает небольшой прямоугольник для области вырезки.

• Задает область вырезки прямоугольником.

• Заполняет большой прямоугольник с твердой черной кистью.

Результатом является небольшой, заполненный, черный прямоугольник.

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

SetClip(Rectangle)

Исходный код:

Graphics.cs

Задает область вырезки этого Graphics прямоугольнику, заданному структурой Rectangle.

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 структура, представляющая новый регион клипа.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint. Код выполняет следующие действия:

• Создает небольшой прямоугольник для области вырезки.

• Задает область вырезки прямоугольником.

• Заполняет большой прямоугольник с твердой черной кистью.

Результатом является небольшой, заполненный, черный прямоугольник.

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.cs

Задает область вырезки этого Graphics свойству Clip указанного 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, из которого нужно взять новый регион клипа.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint, а также thisForm, Form для примера. Код выполняет следующие действия:

• Создает временный Graphics из thisFormForm примера.

• Задает область вырезки временной Graphics на небольшой квадрат.

• Обновляет область вырезки графического объекта формы на временную Graphics.

• Заполняет большой прямоугольник с твердой черной кистью.

Результатом является небольшая, заполненная, черная квадрат.

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.cs

Задает область вырезки этого Graphics указанным 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, представляющий новый регион клипа.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика событий Paint. Код выполняет следующие действия:

• Создает графический путь и добавляет многоточие в путь.

• Задает область вырезки для эллиптического пути.

• Заполняет большой прямоугольник с твердой черной кистью.

Результатом является заполненный, черный многоточие.

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, не закрыт, дополнительный сегмент добавляется из последней точки в первую точку, чтобы закрыть путь.