Graphics.ExcludeClip Метод

Определение

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

System.Drawing

Сборка:

System.Drawing.Common.dll

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

Перегрузки

ExcludeClip(Region)	Обновляет область клипа этого Graphics, чтобы исключить область, указанную Region.
ExcludeClip(Rectangle)	Обновляет область клипа этого Graphics, чтобы исключить область, указанную структурой Rectangle.

ExcludeClip(Region)

Обновляет область клипа этого Graphics, чтобы исключить область, указанную Region.

public:
 void ExcludeClip(System::Drawing::Region ^ region);

public void ExcludeClip (System.Drawing.Region region);

member this.ExcludeClip : System.Drawing.Region -> unit

Public Sub ExcludeClip (region As Region)

Параметры

region

Region

Region, указывающий регион, который следует исключить из области клипа.

Примеры

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

• Создает прямоугольник 100 пикселей на 100 пикселей, верхний левый угол которого находится в координате (100, 100).

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

• Заполняет прямоугольник на 300 пикселей на 300 пикселей, верхний левый угол которого находится в координате (0, 0) с твердой синей кистью.

Результатом является синий прямоугольник с квадратной площадью к правому нижнему углу, отсутствующим.

public:
   void ExcludeClipRegion( PaintEventArgs^ e )
   {
      // Create rectangle for region.
      Rectangle excludeRect = Rectangle(100,100,200,200);

      // Create region for exclusion.
      System::Drawing::Region^ excludeRegion = gcnew System::Drawing::Region( excludeRect );

      // Set clipping region to exclude region.
      e->Graphics->ExcludeClip( excludeRegion );

      // Fill large rectangle to show clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Blue ), 0, 0, 300, 300 );
   }

public void ExcludeClipRegion(PaintEventArgs e)
{
             
    // Create rectangle for region.
    Rectangle excludeRect = new Rectangle(100, 100, 200, 200);
             
    // Create region for exclusion.
    Region excludeRegion = new Region(excludeRect);
             
    // Set clipping region to exclude region.
    e.Graphics.ExcludeClip(excludeRegion);
             
    // Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Blue), 0, 0, 300, 300);
}

Public Sub ExcludeClipRegion(ByVal e As PaintEventArgs)

    ' Create rectangle for region.
    Dim excludeRect As New Rectangle(100, 100, 200, 200)

    ' Create region for exclusion.
    Dim excludeRegion As New [Region](excludeRect)

    ' Set clipping region to exclude region.
    e.Graphics.ExcludeClip(excludeRegion)

    ' Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Blue), 0, 0, _
    300, 300)
End Sub

Комментарии

Этот метод исключает область, указанную параметром region из текущего области клипа, и назначает результирующей области свойству Clip данного Graphics.

ExcludeClip(Rectangle)

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

public:
 void ExcludeClip(System::Drawing::Rectangle rect);

public void ExcludeClip (System.Drawing.Rectangle rect);

member this.ExcludeClip : System.Drawing.Rectangle -> unit

Public Sub ExcludeClip (rect As Rectangle)

Параметры

rect

Rectangle

Rectangle структура, указывающая прямоугольник для исключения из области клипа.

Примеры

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

• Создает прямоугольник 100 пикселей на 100 пикселей, верхний левый угол которого находится в координате (100, 100).

• Создает область, определяемую прямоугольником.

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

• Заполняет прямоугольник на 300 пикселей на 300 пикселей, верхний левый угол которого находится в координате (0, 0) с твердой синей кистью.

Результатом является синий прямоугольник с квадратной областью к его нижнему правому углу отсутствуют.

public:
   void ExcludeClipRectangle( PaintEventArgs^ e )
   {
      // Create rectangle for exclusion.
      Rectangle excludeRect = Rectangle(100,100,200,200);

      // Set clipping region to exclude rectangle.
      e->Graphics->ExcludeClip( excludeRect );

      // Fill large rectangle to show clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Blue ), 0, 0, 300, 300 );
   }

public void ExcludeClipRectangle(PaintEventArgs e)
{
             
    // Create rectangle for exclusion.
    Rectangle excludeRect = new Rectangle(100, 100, 200, 200);
             
    // Set clipping region to exclude rectangle.
    e.Graphics.ExcludeClip(excludeRect);
             
    // Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Blue), 0, 0, 300, 300);
}

Public Sub ExcludeClipRectangle(ByVal e As PaintEventArgs)

    ' Create rectangle for exclusion.
    Dim excludeRect As New Rectangle(100, 100, 200, 200)

    ' Set clipping region to exclude rectangle.
    e.Graphics.ExcludeClip(excludeRect)

    ' Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Blue), 0, 0, _
    300, 300)
End Sub

Комментарии

Этот метод исключает область, указанную параметром rect из текущего области клипа, и назначает результирующей области свойству Clip данного Graphics.