RealTimeStylus.WindowInputRectangle プロパティ
RealTimeStylus オブジェクトの入力の四角形を取得または設定します。
名前空間 : Microsoft.StylusInput
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)
構文
'宣言
Public Property WindowInputRectangle As Rectangle
'使用
Dim instance As RealTimeStylus
Dim value As Rectangle
value = instance.WindowInputRectangle
instance.WindowInputRectangle = value
public Rectangle WindowInputRectangle { get; set; }
public:
property Rectangle WindowInputRectangle {
Rectangle get ();
void set (Rectangle value);
}
/** @property */
public Rectangle get_WindowInputRectangle()
/** @property */
public void set_WindowInputRectangle(Rectangle value)
public function get WindowInputRectangle () : Rectangle
public function set WindowInputRectangle (value : Rectangle)
プロパティ値
型 : System.Drawing.Rectangle
RealTimeStylus オブジェクトの入力の四角形 (ピクセル単位)。
値 |
説明 |
|---|---|
(0, 0, 0, 0) |
入力の四角形はウィンドウの境界にマップされます。 |
System.Drawing.Rectangle |
入力の四角形は Rectangle オブジェクトにマップされます。 |
解説
入力の四角形は、ウィンドウ境界とこのプロパティの値の交差部分です。このプロパティを空の四角形に設定すると、RealTimeStylus オブジェクトは、ウィンドウのサイズが変更されてもウィンドウ全体で収集します。
RealTimeStylus オブジェクトがタブレット ペン データの収集をいったん開始すると、スタイラスが入力領域外に移動しても、スタイラスが離れるまでデータ収集を続けます。入力領域外で収集されるタブレット ペン データは、アタッチされた IStylusSyncPlugin オブジェクトまたはアタッチされた IStylusAsyncPlugin オブジェクトで個別に処理できます。
このプロパティは、次の条件において例外をスローします。
RealTimeStylus オブジェクトが破棄されている。
このプロパティが、RealTimeStylus() コンストラクタで作成された RealTimeStylus オブジェクトで設定されている。
.gif "メモ") メモ : |
|---|
特定のメッセージ ハンドラ内で使用されている場合、プロパティの設定または取得によって再入呼び出しが行われ、予期しない結果が生じる可能性があります。WM_ACTIVATE、WM_ACTIVATEAPP、WM_NCACTIVATE、WM_PAINT、wParam が SC_HOTKEY または SC_TASKLIST に設定されている場合のWM_SYSCOMMAND および WM_SYSKEYDOWN (Alt-Tab キーまたは Alt-Esc キーの組み合わせで処理される場合) のいずれかのメッセージを処理するときは、再入呼び出しを回避するように注意してください。これはシングル スレッド アパートメント モデル アプリケーションに関する問題です。 |
例
この Microsoft Visual C# .NET の例は、フォームの Load イベント ハンドラのスニペットです。これにより、GestureRecognizer、DynamicRenderer、および 2 つの RealTimeStylus オブジェクトを作成し、カスケードされた RealTimeStylus モデルのオブジェクトをアタッチして、RealTimeStylus オブジェクトを介して動的レンダリング、ジェスチャ認識、タブレット ペン データの収集を有効にします。GestureRecognizer オブジェクトは、単一ストロークのジェスチャを認識し、ApplicationGesture、ApplicationGesture、および ApplicationGesture アプリケーション ジェスチャだけを認識するように設定されます。プライマリ RealTimeStylus オブジェクトの WindowInputRectangle プロパティは、RealTimeStylus オブジェクトがアタッチされたコントロール全体を使用するように明示的に設定されます。フォーム自体が IStylusAsyncPlugin インターフェイスを実装し、RealTimeStylus オブジェクトにアタッチされます。
using Microsoft.Ink;
using Microsoft.StylusInput;
using Microsoft.StylusInput.PluginData;
// ...
// The panel where the tablet pen data is collected.
private System.Windows.Forms.Panel thePanel;
// Declare the RealTimeStylus objects, the GestureRecognizer plugin,
// and the DynamicRenderer plug-in.
private Microsoft.StylusInput.RealTimeStylus thePrimaryRealTimeStylus = null;
private Microsoft.StylusInput.RealTimeStylus theSecondaryRealTimeStylus = null;
private Microsoft.StylusInput.GestureRecognizer theGestureRecognizer = null;
private Microsoft.StylusInput.DynamicRenderer theDynamicRenderer = null;
// The form's Load event handler.
private void theForm_Load(object sender, System.EventArgs e)
{
// ...
// Create a DynamicRenderer attached to the drawing area ,
// and enable dynamic rendering.
this.theDynamicRenderer = new DynamicRenderer(this.thePanel);
this.theDynamicRenderer.Enabled = true;
// Create a GestureRecognizer, and set it to recognize single-stroke gestures.
this.theGestureRecognizer = new GestureRecognizer();
this.theGestureRecognizer.MaxStrokeCount = 1;
// Allow gesture recognition for specific gestures.
this.theGestureRecognizer.EnableGestures( new ApplicationGesture[]
{
ApplicationGesture.Right,
ApplicationGesture.ChevronRight,
ApplicationGesture.ArrowRight
} );
// Enable gesture recognition.
this.theGestureRecognizer.Enabled = true;
// Create the primary and secondary RealTimeStylus objects.
this.thePrimaryRealTimeStylus = new RealTimeStylus(this.thePanel);
this.theSecondaryRealTimeStylus = new RealTimeStylus();
// Add the secondary RealTimeStylus to the primary's asynchronous plug-in collection.
this.thePrimaryRealTimeStylus.AsyncPluginCollection.Add(
this.theSecondaryRealTimeStylus);
// Add the dynamic renderer to the primary's synchronous plug-in collection.
this.thePrimaryRealTimeStylus.SyncPluginCollection.Add(this.theDynamicRenderer);
// Add the gesture recognizer to the secondary's synchronous plug-in collection.
this.theSecondaryRealTimeStylus.SyncPluginCollection.Add(this.theGestureRecognizer);
// Add the form to the secondary's asynchronous plug-in colleciton.
this.theSecondaryRealTimeStylus.AsyncPluginCollection.Add(this);
// Set the input rectangle to the entire panel for the RealTimeStylus.
this.thePrimaryRealTimeStylus.WindowInputRectangle = new Rectangle(0,0,0,0);
// Enable the RealTimeStylus, which allows notifications to flow to the plug-ins.
this.thePrimaryRealTimeStylus.Enabled = true;
// ...
}
プラットフォーム
Windows Vista, Windows XP SP2, Windows Server 2003
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0