Region.Exclude Méthode

Définition

Met à jour cet objet Region avec la partie de son intérieur qui ne croise pas la structure Rectangle spécifiée.Updates this Region to the portion of its interior that does not intersect with the specified Rectangle structure.

Surcharges

Exclude(Region)

Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas le Region spécifié.Updates this Region to contain only the portion of its interior that does not intersect with the specified Region.

Exclude(GraphicsPath)

Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas le GraphicsPath spécifié.Updates this Region to contain only the portion of its interior that does not intersect with the specified GraphicsPath.

Exclude(Rectangle)

Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas la structure Rectangle spécifiée.Updates this Region to contain only the portion of its interior that does not intersect with the specified Rectangle structure.

Exclude(RectangleF)

Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas la structure RectangleF spécifiée.Updates this Region to contain only the portion of its interior that does not intersect with the specified RectangleF structure.

Exclude(Region)

Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas le Region spécifié.Updates this Region to contain only the portion of its interior that does not intersect with the specified Region.

public:
 void Exclude(System::Drawing::Region ^ region);
public void Exclude (System.Drawing.Region region);
member this.Exclude : System.Drawing.Region -> unit
Public Sub Exclude (region As Region)

Paramètres

region
Region

Region à exclure de cet objet Region.The Region to exclude from this Region.

Exceptions

region a la valeur null.region is null.

Exemples

Pour obtenir des exemples de code, consultez les Exclude(RectangleF) Complement(Region) méthodes et.For code examples, see the Exclude(RectangleF) and Complement(Region) methods.

S’applique à

Produit Introduit

Exclude(GraphicsPath)

Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas le GraphicsPath spécifié.Updates this Region to contain only the portion of its interior that does not intersect with the specified GraphicsPath.

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

Paramètres

path
GraphicsPath

GraphicsPath à exclure de cet objet Region.The GraphicsPath to exclude from this Region.

Exceptions

path a la valeur null.path is null.

Exemples

L’exemple de code suivant illustre le Region constructeur et Exclude les Dispose méthodes et.The following code example demonstrates the Region constructor and the Exclude and Dispose methods.

Cet exemple est conçu pour être utilisé avec Windows Forms.This example is designed to be used with Windows Forms. Collez le code dans un formulaire et appelez la FillRegionExcludingPath méthode lors du traitement de l’événement du formulaire Paint , e en passant comme PaintEventArgs .Paste the code into a form and call the FillRegionExcludingPath method when handling the form's Paint event, passing e as PaintEventArgs.

private:
   void FillRegionExcludingPath( PaintEventArgs^ e )
   {
      // Create the region using a rectangle.
      System::Drawing::Region^ myRegion = gcnew System::Drawing::Region( Rectangle(20,20,100,100) );

      // Create the GraphicsPath.
      System::Drawing::Drawing2D::GraphicsPath^ path = gcnew System::Drawing::Drawing2D::GraphicsPath;

      // Add a circle to the graphics path.
      path->AddEllipse( 50, 50, 25, 25 );

      // Exclude the circle from the region.
      myRegion->Exclude( path );

      // Retrieve a Graphics object from the form.
      Graphics^ formGraphics = e->Graphics;

      // Fill the region in blue.
      formGraphics->FillRegion( Brushes::Blue, myRegion );

      // Dispose of the path and region objects.
      delete path;
      delete myRegion;
   }
private void FillRegionExcludingPath(PaintEventArgs e)
{

    // Create the region using a rectangle.
    Region myRegion = new Region(new Rectangle(20, 20, 100, 100));

    // Create the GraphicsPath.
    System.Drawing.Drawing2D.GraphicsPath path = 
        new System.Drawing.Drawing2D.GraphicsPath();

    // Add a circle to the graphics path.
    path.AddEllipse(50, 50, 25, 25);

    // Exclude the circle from the region.
    myRegion.Exclude(path);

    // Retrieve a Graphics object from the form.
    Graphics formGraphics = e.Graphics;

    // Fill the region in blue.
    formGraphics.FillRegion(Brushes.Blue, myRegion);

    // Dispose of the path and region objects.
    path.Dispose();
    myRegion.Dispose();
}
Private Sub FillRegionExcludingPath(ByVal e As PaintEventArgs)

    ' Create the region using a rectangle.
    Dim myRegion As New Region(New Rectangle(20, 20, 100, 100))

    ' Create the GraphicsPath.
    Dim path As New System.Drawing.Drawing2D.GraphicsPath

    ' Add a circle to the graphics path.
    path.AddEllipse(50, 50, 25, 25)

    ' Exclude the circle from the region.
    myRegion.Exclude(path)

    ' Retrieve a Graphics object from the form.
    Dim formGraphics As Graphics = e.Graphics

    ' Fill the region in blue.
    formGraphics.FillRegion(Brushes.Blue, myRegion)

    ' Dispose of the path and region objects.
    path.Dispose()
    myRegion.Dispose()

End Sub

S’applique à

Produit Introduit

Exclude(Rectangle)

Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas la structure Rectangle spécifiée.Updates this Region to contain only the portion of its interior that does not intersect with the specified Rectangle structure.

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

Paramètres

rect
Rectangle

Structure Rectangle à exclure de cet objet Region.The Rectangle structure to exclude from this Region.

Exemples

Pour obtenir un exemple de code, consultez la Exclude(RectangleF) méthode.For a code example, see the Exclude(RectangleF) method.

S’applique à

Produit Introduit

Exclude(RectangleF)

Met à jour cet objet Region pour contenir uniquement la partie de son intérieur qui ne croise pas la structure RectangleF spécifiée.Updates this Region to contain only the portion of its interior that does not intersect with the specified RectangleF structure.

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

Paramètres

rect
RectangleF

Structure RectangleF à exclure de cet objet Region.The RectangleF structure to exclude from this Region.

Exemples

L’exemple suivant est conçu pour être utilisé avec Windows Forms, et il nécessite PaintEventArgs e , qui est un paramètre du Paint Gestionnaire d’événements.The following example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Le code effectue les actions suivantes :The code performs the following actions:

  • Crée un rectangle et le dessine à l’écran en noirCreates a rectangle and draws it to the screen in black

  • Crée un deuxième rectangle qui croise le premier et le dessine à l’écran en rouge.Creates a second rectangle that intersects with the first and draws it to the screen in red.

  • Crée une région à l’aide du premier rectangle.Creates a region using the first rectangle.

  • Obtient la zone qui n’est pas exclue de la zone lorsqu’elle est combinée avec le deuxième rectangle.Gets the nonexcluded area of the region when combined with the second rectangle.

  • Remplit la zone qui n’est pas exclue en bleu et la dessine à l’écran.Fills the nonexcluded area with blue and draws it to the screen.

Notez que la zone de la zone de la région qui ne croise pas le rectangle est colorée en bleu.Notice that the area of the area of the region that does not intersect with the rectangle is colored blue.

public:
   void Exclude_RectF_Example( PaintEventArgs^ e )
   {
      // Create the first rectangle and draw it to the screen in black.
      Rectangle regionRect = Rectangle(20,20,100,100);
      e->Graphics->DrawRectangle( Pens::Black, regionRect );

      // Create the second rectangle and draw it to the screen in red.
      RectangleF complementRect = RectangleF(90,30,100,100);
      e->Graphics->DrawRectangle( Pens::Red, Rectangle::Round( complementRect ) );

      // Create a region using the first rectangle.
      System::Drawing::Region^ myRegion = gcnew System::Drawing::Region( regionRect );

      // Get the nonexcluded area of myRegion when combined with
      // complementRect.
      myRegion->Exclude( complementRect );
      
      // Fill the nonexcluded area of myRegion with blue.
      SolidBrush^ myBrush = gcnew SolidBrush( Color::Blue );
      e->Graphics->FillRegion( myBrush, myRegion );
   }
public void Exclude_RectF_Example(PaintEventArgs e)
{
             
    // Create the first rectangle and draw it to the screen in black.
    Rectangle regionRect = new Rectangle(20, 20, 100, 100);
    e.Graphics.DrawRectangle(Pens.Black, regionRect);
             
    // Create the second rectangle and draw it to the screen in red.
    RectangleF complementRect = new RectangleF(90, 30, 100, 100);
    e.Graphics.DrawRectangle(Pens.Red,
        Rectangle.Round(complementRect));
             
    // Create a region using the first rectangle.
    Region myRegion = new Region(regionRect);
             
    // Get the nonexcluded area of myRegion when combined with
             
    // complementRect.
    myRegion.Exclude(complementRect);
             
    // Fill the nonexcluded area of myRegion with blue.
    SolidBrush myBrush = new SolidBrush(Color.Blue);
    e.Graphics.FillRegion(myBrush, myRegion);
}
Public Sub Exclude_RectF_Example(ByVal e As PaintEventArgs)

    ' Create the first rectangle and draw it to the screen in black.
    Dim regionRect As New Rectangle(20, 20, 100, 100)
    e.Graphics.DrawRectangle(Pens.Black, regionRect)

    ' create the second rectangle and draw it to the screen in red.
    Dim complementRect As New RectangleF(90, 30, 100, 100)
    e.Graphics.DrawRectangle(Pens.Red, _
    Rectangle.Round(complementRect))

    ' Create a region using the first rectangle.
    Dim myRegion As New [Region](regionRect)

    ' Get the nonexcluded area of myRegion when combined with
    ' complementRect.
    myRegion.Exclude(complementRect)

    ' Fill the nonexcluded area of myRegion with blue.
    Dim myBrush As New SolidBrush(Color.Blue)
    e.Graphics.FillRegion(myBrush, myRegion)
End Sub

S’applique à

Produit Introduit