CustomStrokes.Item, propriété (Int32)

Article
11/05/2008

Mise à jour : November 2007

Obtient la collection Strokes à l'index spécifié dans la collection CustomStrokes.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public ReadOnly Property Item ( _
    index As Integer _
) As Strokes
'Utilisation
Dim instance As CustomStrokes
Dim index As Integer
Dim value As Strokes

value = instance.Item(index)

public Strokes Item[
    int index
] { get; }

public:
property Strokes^ Item[int index] {
    Strokes^ get (int index);
}

/** @property */
public Strokes get_Item(
    int index
)

JScript ne prend pas en charge les propriétés indexées.

Paramètres

index
Type : System.Int32
Index de base zéro de la collection Strokes à obtenir.

Valeur de propriété

Type : Microsoft.Ink.Strokes
Collection Strokes spécifiée dans la collection CustomStrokes.

Notes

Une exception System.ArgumentOutOfRangeException (page pouvant être en anglais) est levée si le index ne correspond pas à un membre existant de la collection CustomStrokes. Si, pour des objectifs de développement, vous utilisez Windows XP (pas Édition Tablet) avec le Kit de développement logiciel (SDK) Tablet PC et que le index ne correspond pas à un membre existant de la collection CustomStrokes, une exception System.Runtime.Inter (page pouvant être en anglais) est levée.

Remarque :
En C#, utilisez l'indexeur de collection comme indiqué dans l'exemple suivant, au lieu d'utiliser la propriété Item de la collection.

Exemples

Dans cet exemple, une méthode retourne la valeur true si la collection CustomStrokes d'un objet Ink contient une collection Strokes à l'index spécifié. Si une collection Strokes n'existe pas à l'index spécifié, une exception est levée et la méthode retourne la valeur false.

Private Function CustomStrokesCollectionExists(ByVal mIndex As Integer, ByVal mInk As Ink) As Boolean
    Try
        Dim S As Strokes = mInk.CustomStrokes(mIndex)
        ' In VB, you can also access the named collections by using the Item property:
        ' Dim S As Strokes = mInk.CustomStrokes.Item(mIndex)
        '
        ' if the previous statement did not raise an exception, 
        ' the indexed Strokes collection exists
        Return True

    Catch E As System.Runtime.InteropServices.COMException
        ' For Windows XP (not Tablet Edition) with Tablet PC SDK installed for development purposes
        ' this exception is raised when the indexed collection does not exist

    Catch E As ArgumentOutOfRangeException
        ' For Windows XP Tablet Edition and Vista
        ' this exception is raised when the indexed collection does not exist

    Catch E As Exception
        ' in case another type of exception is raised

    End Try
    Return False
End Function

private bool CustomStrokesCollectionExists(int mIndex, Ink mInk)
{
    try
    {
        Strokes S = mInk.CustomStrokes[mIndex];
        // In C#, the Item property is not available. The following won't compile:
        // Strokes S = mInk.CustomStrokes.Item[mIndex];

        // if the previous statement did not throw an exception, 
        // the indexed Strokes collection exists
        return true;
    }

    catch (System.Runtime.InteropServices.COMException)
    {
        // For Windows XP (not Tablet Edition) with Tablet PC SDK installed for development purposes
        // this exception is raised when the indexed collection does not exist
    }
    catch (ArgumentOutOfRangeException)
    {
        // For Windows XP Tablet Edition and Vista
        // this exception is raised when the indexed collection does not exist
    }
    catch (Exception)
    {
        // in case another type of exception is raised
    }
    return false;
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.