CursorButtons.CursorButtonsEnumerator.Current 屬性

發行項
10/29/2008

取得列舉值指向之 CursorButtons 集合中的 CursorButton 物件。

命名空間： Microsoft.Ink
組件： Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public ReadOnly Property Current As CursorButton
'用途
Dim instance As CursorButtons..::.CursorButtonsEnumerator
Dim value As CursorButton

value = instance.Current

public CursorButton Current { get; }

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

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

public function get Current () : CursorButton

屬性值

型別：Microsoft.Ink.CursorButton
列舉值指向之 CursorButtons 集合中的 CursorButton 物件。

備註

在建立 CursorButtons.CursorButtonsEnumerator 列舉值或呼叫 Reset 方法之後，必須呼叫 MoveNext 方法使列舉值向前移至集合的第一個項目，才能讀取 Current 屬性的值，否則 Current 屬性會是未定義的。

如果上次呼叫 MoveNext 方法傳回 false，則 Current 屬性會擲回例外狀況 (Exception)。如果上次呼叫 MoveNext 方法傳回 false，表示列舉值已經到達 CursorButtons 集合的結尾。

Current 屬性不會移動列舉值的位置。在呼叫 MoveNext 或 Reset 方法之前，對 Current 屬性的連續呼叫都會傳回相同的物件。

只要集合保持不變，列舉值將保持有效。如果對集合進行變更，例如加入、修改或刪除項目，則列舉值將失效且無法復原。下次呼叫 MoveNext 或 Reset 方法會擲回 System.InvalidOperationException (英文) 例外狀況。如果在呼叫 MoveNext 方法和呼叫 Current 屬性之間修改了集合，則 Current 屬性會傳回其所設定的項目，即使列舉值已經失效也一樣。

範例

這個範例會取得 CursorButtons 集合的 System.Collections.IEnumerator (英文)，並用來列舉集合的每個項目。CursorButtons 集合是由 Cursor.Buttons 屬性傳回。

Dim names As ArrayList = New ArrayList()
Dim ienum As IEnumerator = cursor.Buttons.GetEnumerator()
ienum.Reset()
While ienum.MoveNext()
    Dim theButton As CursorButton = DirectCast(ienum.Current, CursorButton)
    names.Add(theButton.Name)
End While

ArrayList names = new ArrayList();
IEnumerator ienum = cursor.Buttons.GetEnumerator();
ienum.Reset();
while (ienum.MoveNext())
{
    CursorButton theButton = (CursorButton)ienum.Current;
    names.Add(theButton.Name);
}