RealTimeStylus.GetStyluses メソッド

RealTimeStylus が検出した Stylus オブジェクトの配列を返します。

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

構文

'宣言
Public Function GetStyluses As Stylus()
'使用
Dim instance As RealTimeStylus
Dim returnValue As Stylus()

returnValue = instance.GetStyluses()

public Stylus[] GetStyluses()

public:
array<Stylus^>^ GetStyluses()

public Stylus[] GetStyluses()

public function GetStyluses() : Stylus[]

戻り値

型 : array<Microsoft.StylusInput.Stylus[]
RealTimeStylus が検出した Stylus オブジェクトの配列。

解説

RealTimeStylus と関連付けられた Tablet オブジェクトで Stylus オブジェクトがまだ検出されていない場合、このメソッドは空の配列を返します。

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

例

この C# の例は、メニュー項目の Click イベント ハンドラのスニペットです。このメニューは、TextBox オブジェクト theTextBox が定義されているフォームの一部です。RealTimeStylus オブジェクトが無効な場合、イベント ハンドラは終了します。それ以外の場合、イベント ハンドラは RealTimeStylus オブジェクトの GetStyluses メソッドを呼び出し、各タブレット ペンに関する情報を theTextBox に表示します。フォームのヘルパ メソッドである StylusDataToString は、指定されたスタイラスに関する情報を含む String オブジェクトを返します。

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;

// ...

// The GetStyluses menu item's ClickEventHandler
private void theMenuItemGetStyluses_Click(object sender, System.EventArgs e)
{
    // Can not call this method while the RealTimeStylus is disabled.
    if (!this.thePrimaryRealTimeStylus.Enabled)
    {
        MessageBox.Show("The GetStyluses method of the RealTimeStylus can only be called while the RealTimeStylus is enabled.");
        return;
    }

    this.theTextBox.Text = "The Styluses encountered so far:" + Environment.NewLine;
    foreach (Stylus theStylus in this.thePrimaryRealTimeStylus.GetStyluses())
    {
        this.theTextBox.Text +=
            this.StylusDataToString(theStylus) + Environment.NewLine;
    }
}

プラットフォーム

Windows Vista, Windows XP SP2, Windows Server 2003

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 3.0

参照

参照

RealTimeStylus クラス

RealTimeStylus メンバ

Microsoft.StylusInput 名前空間