Control.Region 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

Source:

Control.cs

获取或设置与控件关联的窗口区域。

C#

[System.ComponentModel.Browsable(false)]
public System.Drawing.Region? Region { get; set; }

属性值

Region

与控件关联的窗口 Region。

属性

BrowsableAttribute

示例

下面的代码示例演示如何通过创建圆形按钮来使用 Region 属性。 若要运行该示例，请将以下代码粘贴到包含名为 的按钮的 roundButton窗体中。 此示例要求事件 Paint 连接到示例中定义的事件处理程序。

C#

// This method will change the square button to a circular button by 
// creating a new circle-shaped GraphicsPath object and setting it 
// to the RoundButton objects region.
private void roundButton_Paint(object sender, 
    System.Windows.Forms.PaintEventArgs e)
{

    System.Drawing.Drawing2D.GraphicsPath buttonPath = 
        new System.Drawing.Drawing2D.GraphicsPath();

    // Set a new rectangle to the same size as the button's 
    // ClientRectangle property.
    System.Drawing.Rectangle newRectangle = roundButton.ClientRectangle;

    // Decrease the size of the rectangle.
    newRectangle.Inflate(-10, -10);
    
    // Draw the button's border.
    e.Graphics.DrawEllipse(System.Drawing.Pens.Black, newRectangle);

    // Increase the size of the rectangle to include the border.
    newRectangle.Inflate( 1,  1);

    // Create a circle within the new rectangle.
    buttonPath.AddEllipse(newRectangle);
            
    // Set the button's Region property to the newly created 
    // circle region.
    roundButton.Region = new System.Drawing.Region(buttonPath);
}

注解

窗口区域是操作系统允许绘制的窗口中像素的集合。 操作系统不会显示位于窗口区域外部的窗口的任何部分。 控件区域的坐标相对于控件的左上角，而不是控件的工作区。

备注

区域中包含的像素集合可能不连续。

适用于

另请参阅

• ClientRectangle
• Bounds