InkOverlay.SetWindowInputRectangle メソッド

[アーティクル]
10/28/2008

インクが描画される四角形のウィンドウ (ピクセル単位) を設定します。

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

構文

'宣言
Public Sub SetWindowInputRectangle ( _
    windowInputRectangle As Rectangle _
)
'使用
Dim instance As InkOverlay
Dim windowInputRectangle As Rectangle

instance.SetWindowInputRectangle(windowInputRectangle)

public void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public:
void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public function SetWindowInputRectangle(
    windowInputRectangle : Rectangle
)

パラメータ

windowInputRectangle
型 : System.Drawing.Rectangle
入力する四角形。

解説

既定では、ウィンドウ入力の四角形は {0,0,0,0} に設定されます。この既定の四角形はウィンドウ全体のサイズにマップされます。

ウィンドウ入力の四角形を既定の座標を使用する空の四角形にリセットするには、nullnull 参照 (Visual Basic では Nothing) (Microsoft Visual Basic .NET では Nothing) ではなく {0,0,0,0} を SetWindowInputRectangle メソッドの呼び出しで渡します。

Right プロパティの値が Left プロパティの値よりも小さい場合、または Bottom プロパティの値が Top プロパティの値よりも小さい場合には、四角形を渡すことはできません。たとえば、パラメータが {500, 500, 400, 400} の四角形は有効ではありません。

負の座標空間の四角形を指定できますが、意味がありません。結果は常に、インクを使用できないウィンドウになるからです。

注意 :
ウィンドウ入力の四角形を Splitter コントロール、またはウィンドウの境界線と重なるよう設定した場合、ウィンドウのサイズを変更したときに予期しない結果が生じる可能性があります。

例

この C# の例では、SetWindowInputRectangle メソッドを呼び出し、インク入力領域を、結合される InkOverlay オブジェクト theInkOverlay のウィンドウ全体のサイズに設定します。

using Microsoft.Ink;
//...
InkOverlay theInkCollector;
public Form1()
{
    // Initialization
    theInkCollector = new InkOverlay(Handle);
    Rectangle theRect = new Rectangle(0,0,0,0);
    theInkOverlay.SetWindowInputRectangle(theRect);
    //...
}

この Visual Basic .NET の例では、SetWindowInputRectangle メソッドを呼び出し、インク入力領域を、結合される InkOverlay オブジェクト theInkOverlay のウィンドウ全体のサイズに設定します。

Imports Microsoft.Ink
Dim theInkOverlay As InkOverlay
Public Sub Form1()
    'Initialization
    Dim theRect As Rectangle
    theInkOverlay = New InkOverlay(Handle)
    theRect = New Rectangle(0,0,0,0)
    theInkOverlay.SetWindowInputRectangle(theRect)
    '...
End Sub