Graphics.ExcludeClip Метод

Определение

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

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

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

Перегрузки

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

ExcludeClip(Region)

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

Graphics.cs

Обновляет отсеченную область данного объекта 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.cs

Обновляет область вырезания данного объекта 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объекта .