Tablets.TabletsEnumerator.Current プロパティ

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

列挙子が指している Tablets コレクション内の Tablet オブジェクトを取得します。

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

構文

'宣言
Public ReadOnly Property Current As Tablet
'使用
Dim instance As Tablets..::.TabletsEnumerator
Dim value As Tablet

value = instance.Current

public Tablet Current { get; }

public:
property Tablet^ Current {
    Tablet^ get ();
}

/** @property */
public Tablet get_Current()

public function get Current () : Tablet

プロパティ値

型 : Microsoft.Ink.Tablet
列挙子が指している Tablets コレクション内の Tablet オブジェクト。

解説

Tablets.TabletsEnumerator 列挙子を作成した後や Reset メソッドを呼び出した後に、コレクションの最初の要素に列挙子を進めるためには、Current プロパティの値を読み取る前に MoveNext メソッドを呼び出す必要があります。そうしない場合、Current プロパティは未定義になります。

MoveNext メソッドの前回の呼び出しで false が返された場合、Current プロパティにより例外がスローされます。MoveNext メソッドの前回の呼び出しで false が返された場合、列挙子は Tablets コレクションの末尾に到達します。

Current プロパティは、列挙子の位置を移動しません。Current プロパティを連続して呼び出した場合、MoveNext メソッドまたは Reset メソッドが呼び出されるまでは同じオブジェクトが返されます。

コレクションが変更されない限り、列挙子は有効なままです。要素の追加、変更、削除などの変更がコレクションに対して実行されると、列挙子は回復不可能な無効状態になります。MoveNext メソッドまたは Reset メソッドの次の呼び出しで、InvalidOperationException 例外がスローされます。コレクションが MoveNext メソッドの呼び出しと Current プロパティの呼び出しとの間で変更された場合は、列挙子が既に無効になっていても、Current プロパティは設定した要素を返します。

例

この例では、Tablets コレクションの IEnumerator を使用して、Tablets コレクション allTablets を反復処理し、システムにアタッチされている各タブレットデバイスの名前を使用して、ListBox オブジェクト listBoxTablets を設定します。

' Calling the constructor automatically fills the 
' Tablets collection with the available Tablet objects.
Dim allTablets As Tablets = New Tablets()

' clear the list box
Me.listBoxTablets.Items.Clear()

' populate the list box with the name of each tablet
' version using GetEnumerator()
Dim theTabletsEnumerator As IEnumerator = allTablets.GetEnumerator()
While (theTabletsEnumerator.MoveNext())
    Dim T As Tablet = theTabletsEnumerator.Current
    Me.listBoxTablets.Items.Add(T.Name)
End While

// Calling the constructor automatically fills the 
// Tablets collection with the available Tablet objects.
Tablets allTablets = new Tablets();

// clear the list box
this.listBoxTablets.Items.Clear();

// populate the list box with the name of each tablet
// version using GetEnumerator()
IEnumerator theTabletsEnumerator = allTablets.GetEnumerator();
while (theTabletsEnumerator.MoveNext())
{
    Tablet T = (Tablet)theTabletsEnumerator.Current;
    this.listBoxTablets.Items.Add(T.Name);
}