Graphics.ExcludeClip Метод

Определение

Обновляет вырезанную область данного объекта Graphics, чтобы исключить из нее часть, определяемую структурой Rectangle.Updates the clip region of this Graphics to exclude the area specified by a Rectangle structure.

Перегрузки

ExcludeClip(Region)

Обновляет вырезанную область данного объекта Graphics, чтобы исключить из нее часть, определяемую структурой Region.Updates the clip region of this Graphics to exclude the area specified by a Region.

ExcludeClip(Rectangle)

Обновляет вырезанную область данного объекта Graphics, чтобы исключить из нее часть, определяемую структурой Rectangle.Updates the clip region of this Graphics to exclude the area specified by a Rectangle structure.

ExcludeClip(Region)

Обновляет вырезанную область данного объекта Graphics, чтобы исключить из нее часть, определяемую структурой Region.Updates the clip region of this Graphics to exclude the area specified by a Region.

public:
 void ExcludeClip(System::Drawing::Region ^ region);
public void ExcludeClip (System.Drawing.Region region);
member this.ExcludeClip : System.Drawing.Region -> unit

Параметры

region
Region

Объект Region, который задает область, исключаемую из вырезанной области.Region that specifies the region to exclude from the clip region.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что 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:

  • Создает прямоугольник размером 100 пикселей на 100 пикселей, верхний левый угол которого находится в координатах (100, 100).Creates a 100 pixel by 100 pixel rectangle whose upper-left corner is at the coordinate (100, 100).

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

  • Заполняет 300 пикселей на 300 пиксельного прямоугольника, верхний левый угол которого находится в координатах (0,0) с сплошной синей кистью.Fills a 300 pixel by 300 pixel rectangle whose upper-left corner is at the coordinate (0, 0) with a solid blue brush.

Результатом является синий прямоугольник с квадратной областью, в которой отсутствует правый нижний угол.The result is a blue rectangle with a square area toward its lower-right corner missing.

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объекта.This method excludes the area specified by the region parameter from the current clip region and assigns the resulting area to the Clip property of this Graphics.

ExcludeClip(Rectangle)

Обновляет вырезанную область данного объекта Graphics, чтобы исключить из нее часть, определяемую структурой Rectangle.Updates the clip region of this Graphics to exclude the area specified by a Rectangle structure.

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, которая задает прямоугольник, исключаемый из вырезанной области.Rectangle structure that specifies the rectangle to exclude from the clip region.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что 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:

  • Создает прямоугольник размером 100 пикселей на 100 пикселей, верхний левый угол которого находится в координатах (100, 100).Creates a 100 pixel by 100 pixel rectangle whose upper-left corner is at the coordinate (100, 100).

  • Создает область, определяемую прямоугольником.Creates a region defined by the rectangle.

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

  • Заполняет 300 пикселей на 300 пиксельного прямоугольника, верхний левый угол которого находится в координатах (0,0) с сплошной синей кистью.Fills a 300 pixel by 300 pixel rectangle whose upper-left corner is at the coordinate (0, 0) with a solid blue brush.

Результатом является синий прямоугольник с квадратной областью в сторону отсутствующего правого нижнего угла.The result is a blue rectangle with a square region toward its lower-right corner missing.

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объекта.This method excludes the area specified by the rect parameter from the current clip region and assigns the resulting area to the Clip property of this Graphics.

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