InkPicture.SetWindowInputRectangle メソッド

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

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

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

構文

'宣言
Public Sub SetWindowInputRectangle ( _
    windowInputRectangle As Rectangle _
)
'使用
Dim instance As InkPicture
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) ではなく、SetWindowInputRectangle メソッドの呼び出しで {0,0,0,0} を渡します。

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

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

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

例

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

[C#]

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

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

[Visual Basic]

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