Control.Region プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ソース:

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