InkPicture.Tablet プロパティ

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

InkPicture コントロールが入力を収集するために現在使用しているタブレットデバイスを取得します。

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

構文

'宣言
<BrowsableAttribute(False)> _
Public ReadOnly Property Tablet As Tablet
'使用
Dim instance As InkPicture
Dim value As Tablet

value = instance.Tablet

[BrowsableAttribute(false)]
public Tablet Tablet { get; }

[BrowsableAttribute(false)]
public:
property Tablet^ Tablet {
    Tablet^ get ();
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public Tablet get_Tablet()

public function get Tablet () : Tablet

プロパティ値

型 : Microsoft.Ink.Tablet
InkPicture コントロールが入力を収集するために現在使用しているタブレットデバイス。

解説

メモ :
このプロパティは、InkPicture コントロールが 1 つのタブレットのみからインクを収集している場合にのみ有効です。すべてのタブレットからインクを収集する InkPicture のこのプロパティにアクセスすると、例外が生成されます。

例

この例では、InkPicture オブジェクト mInkObject によって参照されている Tablet オブジェクトのプロパティに関するレポートを返します。

Public Function InkObjectTabletReport() As String
    Dim Result As StringBuilder = New StringBuilder(512)
    ' Wrap access to the Tablet object in a try/catch block. 
    ' If mInkObject is in All Tablets mode, an exception will be 
    ' thrown when accessing the Tablet property.
    Try
        Result.AppendLine("The tablet associated mInkObject has the following properties:")
        ' accessing mInkObject.Tablet will throw an exception if in All Tablets mode
        ' mInkObject can be InkCollector, InkOverlay, or InkPicture
        Dim mTablet As Tablet = mInkObject.Tablet
        Result.AppendLine("Tablet Name: " + mTablet.Name)
        Result.AppendLine("Tablet PNP ID: " + mTablet.PlugAndPlayId)
        Result.AppendLine("Tablet Max Rect: " + mTablet.MaximumInputRectangle.ToString())
        Result.AppendLine("Tablet Capabilities: " + mTablet.HardwareCapabilities)

    Catch ex As System.Exception
        Result.AppendLine("mInkObject is in all tablets mode.")
        Result.AppendLine("The tablet report cannot be generated.")
    End Try

    Return Result.ToString()
End Function

public string InkObjectTabletReport()
{
    StringBuilder Result = new StringBuilder(512);

    // Wrap access to the Tablet object in a try/catch block. 
    // If mInkObject is in All Tablets mode, an exception will be 
    // thrown when accessing the Tablet property.
    try
    {
        Result.AppendLine("The  tablet associated with mInkObject has the following properties:");
        // accessing mInkObject.Tablet will throw an exception if in All Tablets mode
        // mInkObject can be InkCollector, InkOverlay, or InkPicture
        Tablet mTablet = mInkObject.Tablet;
        Result.AppendLine("Tablet Name: " + mTablet.Name);
        Result.AppendLine("Tablet PNP ID: " + mTablet.PlugAndPlayId);
        Result.AppendLine("Tablet Max Rect: " + mTablet.MaximumInputRectangle.ToString());
        Result.AppendLine("Tablet Capabilities: " + mTablet.HardwareCapabilities);
    }
    catch (System.Exception)
    {
        Result.AppendLine("mInkObject is in all tablets mode.");
        Result.AppendLine("The tablet report cannot be generated.");
    }

    return Result.ToString();
}