AnalysisRegion.Union メソッド (Rect)

2008-10-28

この AnalysisRegion の領域を、指定した四角形との結合により作成された領域に拡張します。

名前空間 : System.Windows.Ink
アセンブリ : IAWinFX (IAWinFX.dll 内)

構文

'宣言
Public Sub Union ( _
    rectangle As Rect _
)
'使用
Dim instance As AnalysisRegion
Dim rectangle As Rect

instance.Union(rectangle)

public void Union(
    Rect rectangle
)

public:
void Union(
    Rect rectangle
)

public void Union(
    Rect rectangle
)

public function Union(
    rectangle : Rect
)

パラメータ

rectangle
型 : System.Windows.Rect
インク空間座標における、結合する四角形。

解説

rectangle が MinXY と MaxXY で定義された境界の外側にある場合、Union メソッドは ArgumentOutOfRangeException をスローします。

例

この例では、2 つの AnalysisRegion オブジェクトを作成します。Intersect、Union メソッドおよび Exclude メソッドを使用して、オブジェクトの領域を変更します。

' Create an infinite AnalysisRegion.
Dim theFirstAnalysisRegion As New AnalysisRegion()
' Create a finite AnalysisRegion.
Dim theSecondAnalysisRegion As New AnalysisRegion(New Rect(100, 100, 200, 200))
' Extend an AnalysisRegion using the Union method and an AnalysisRegion.
theFirstAnalysisRegion.Union(theSecondAnalysisRegion)

' Extend an AnalysisRegion using the Union method and a rectangle.
theFirstAnalysisRegion.Union(New Rect(100, 100, 200, 200))

' Restrict an AnalysisRegion using the Intersect method and an AnalysisRegion.
theFirstAnalysisRegion.Intersect(theSecondAnalysisRegion)

' Restrict an AnalysisRegion using the Intersect method and a rectangle.
theFirstAnalysisRegion.Intersect(New Rect(100, 100, 200, 200))

' Modify an AnalysisRegion using the Exclude method and an AnalysisRegion.
theFirstAnalysisRegion.Exclude(theSecondAnalysisRegion)

' Modify an AnalysisRegion using the Exclude method and a rectangle.
theFirstAnalysisRegion.Exclude(New Rect(100, 100, 200, 200))

// Create an infinite AnalysisRegion.
AnalysisRegion theFirstAnalysisRegion =
    new AnalysisRegion();

// Create a finite AnalysisRegion.
AnalysisRegion theSecondAnalysisRegion =
    new AnalysisRegion(
        new Rect(100, 100, 200, 200));

// Extend an AnalysisRegion using the Union method and an AnalysisRegion.
theFirstAnalysisRegion.Union(theSecondAnalysisRegion);

// Extend an AnalysisRegion using the Union method and a rectangle.
theFirstAnalysisRegion.Union(new Rect(100, 100, 200, 200));

// Restrict an AnalysisRegion using the Intersect method and an AnalysisRegion.
theFirstAnalysisRegion.Intersect(theSecondAnalysisRegion);

// Restrict an AnalysisRegion using the Intersect method and a rectangle.
theFirstAnalysisRegion.Intersect(new Rect(100, 100, 200, 200));

// Modify an AnalysisRegion using the Exclude method and an AnalysisRegion.
theFirstAnalysisRegion.Exclude(theSecondAnalysisRegion);

// Modify an AnalysisRegion using the Exclude method and a rectangle.
theFirstAnalysisRegion.Exclude(new Rect(100, 100, 200, 200));