RealTimeStylus.GetTabletFromTabletContextId メソッド

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

指定されたタブレットコンテキスト識別子と関連付けられた Tablet オブジェクトを返します。

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

構文

'宣言
Public Function GetTabletFromTabletContextId ( _
    tabletContextId As Integer _
) As Tablet
'使用
Dim instance As RealTimeStylus
Dim tabletContextId As Integer
Dim returnValue As Tablet

returnValue = instance.GetTabletFromTabletContextId(tabletContextId)

public Tablet GetTabletFromTabletContextId(
    int tabletContextId
)

public:
Tablet^ GetTabletFromTabletContextId(
    int tabletContextId
)

public Tablet GetTabletFromTabletContextId(
    int tabletContextId
)

public function GetTabletFromTabletContextId(
    tabletContextId : int
) : Tablet

パラメータ

tabletContextId
型 : System.Int32
関連付けられた Tablet オブジェクトが必要なタブレットコンテキスト識別子。

戻り値

型 : Microsoft.Ink.Tablet
指定されたタブレットコンテキスト識別子と関連付けられた Tablet オブジェクト。

解説

メモ :
タブレットコンテキスト識別子は RealTimeStylus オブジェクトに固有ですが、2 つの RealTimeStylus オブジェクトが同じ Tablet オブジェクトに対して異なるコンテキスト識別子を持つ場合があります。さらに、タブレットコンテキスト識別子は、RealTimeStylus オブジェクトが有効な場合のみ有効です。RealTimeStylus オブジェクトを無効にしてから有効にすると、各 Tablet オブジェクトのタブレットコンテキスト識別子は、RealTimeStylus オブジェクトが最初に有効であったときとは異なる値を持つ場合があります。

タブレットコンテキスト識別子は RealTimeStylus オブジェクトに固有ですが、2 つの RealTimeStylus オブジェクトが同じ Tablet オブジェクトに対して異なるコンテキスト識別子を持つ場合があります。さらに、タブレットコンテキスト識別子は、RealTimeStylus オブジェクトが有効な場合のみ有効です。RealTimeStylus オブジェクトを無効にしてから有効にすると、各 Tablet オブジェクトのタブレットコンテキスト識別子は、RealTimeStylus オブジェクトが最初に有効であったときとは異なる値を持つ場合があります。

RealTimeStylus が無効になっていたり破棄されていたりすると、このメソッドは例外をスローします。

メモ :
この関数は、特定のメッセージハンドラ内で呼び出された場合に再入力されることがあり、予期しない結果が生じる可能性があります。WM_ACTIVATE、WM_ACTIVATEAPP、WM_NCACTIVATE、WM_PAINT、wParam が SC_HOTKEY または SC_TASKLIST に設定されている場合のWM_SYSCOMMAND および WM_SYSKEYDOWN (Alt-Tab キーまたは Alt-Esc キーの組み合わせで処理される場合) のいずれかのメッセージを処理するときは、再入呼び出しを回避するように注意してください。これはシングルスレッドアパートメントモデルアプリケーションに関する問題です。

この関数は、特定のメッセージハンドラ内で呼び出された場合に再入力されることがあり、予期しない結果が生じる可能性があります。WM_ACTIVATE、WM_ACTIVATEAPP、WM_NCACTIVATE、WM_PAINT、wParam が SC_HOTKEY または SC_TASKLIST に設定されている場合のWM_SYSCOMMAND および WM_SYSKEYDOWN (Alt-Tab キーまたは Alt-Esc キーの組み合わせで処理される場合) のいずれかのメッセージを処理するときは、再入呼び出しを回避するように注意してください。これはシングルスレッドアパートメントモデルアプリケーションに関する問題です。

例

この C# の例は、IStylusAsyncPlugin インターフェイスの RealTimeStylusEnabled メソッドの実装のスニペットです。IStylusAsyncPlugin インターフェイスを実装するフォームには、TextBox オブジェクト theTextBox が含まれます。RealTimeStylusEnabled メソッドは、RealTimeStylus オブジェクトが有効になったときに使用可能なタブレットに関する情報を表示します。

using Microsoft.Ink;
using Microsoft.StylusInput;
using Microsoft.StylusInput.PluginData;

// ...

// 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;

// ...

// Called when the RealTimeStylus is enabled, or when the plug-in is added to
// a RealTimeStylus that is already enabled.
public void RealTimeStylusEnabled(RealTimeStylus sender,
    RealTimeStylusEnabledData data)
{
    // Display the list of available tablets.
    this.theTextBox.Text = string.Format(
        "RealTimeStylus enabled ({0} tablets attached):" + Environment.NewLine,
        data.Count);
    foreach (int theContextId in data)
    {
        Tablet theTablet =
            this.thePrimaryRealTimeStylus.GetTabletFromTabletContextId(theContextId);

        this.theTextBox.Text += string.Format(
            "  ContextId = {0}, Tablet.Name = {1}" + Environment.NewLine,
            theContextId, theTablet.Name);

        this.theTextBox.Text += "   Available packet properties:" + Environment.NewLine;

        foreach(TabletPropertyDescription theTabletPropertyDescription in
            this.thePrimaryRealTimeStylus.GetTabletPropertyDescriptionCollection(theContextId))
        {
            this.theTextBox.Text += string.Format("    {0}" + Environment.NewLine,
                this.GetPacketPropertyNameFromGuid(theTabletPropertyDescription.PacketPropertyId));
        }
    }
}