CustomStrokes.Item (Propiedad) (Int32)

Artículo
11/26/2008

Actualización: noviembre 2007

Obtiene la colección Strokes en el índice especificado dentro de la colección CustomStrokes.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public ReadOnly Property Item ( _
    index As Integer _
) As Strokes
'Uso
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 no admite propiedades indizadas.

Parámetros

index
Tipo: System.Int32
El índice de base cero de la colección Strokes que se va a obtener.

Valor de propiedad

Tipo: Microsoft.Ink.Strokes
La colección Strokes especificada incluida en la colección CustomStrokes.

Comentarios

Se genera una excepción System.ArgumentOutOfRangeException si el parámetro index no coincide con un miembro existente de la colección CustomStrokes. Si utiliza Windows XP (no la edición para Tablet PC) con fines de desarrollo con el SDK de Tablet PC instalado, y el parámetro index no coincide con un miembro existente de la colección CustomStrokes, se genera una excepción System.Runtime.Inter.

Nota

En C#, utilice el indizador de la colección, como se muestra en el ejemplo siguiente, en lugar de utilizar la propiedad Item de la colección.

Ejemplos

En este ejemplo, un método devuelve true si la colección CustomStrokes de un objeto Ink contiene una colección Strokes en el índice especificado. Si no existe ninguna colección Strokes en el índice especificado, se produce una excepción y el método devuelve 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;
}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.