CustomStrokes.RemoveAt-Methode

Artikel
10/28/2008

Entfernt eine Strokes-Auflistung am angegebenen Index aus der CustomStrokes-Auflistung.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Sub RemoveAt ( _
    i As Integer _
)
'Usage
Dim instance As CustomStrokes
Dim i As Integer

instance.RemoveAt(i)

public void RemoveAt(
    int i
)

public:
void RemoveAt(
    int i
)

public void RemoveAt(
    int i
)

public function RemoveAt(
    i : int
)

Parameter

i
Typ: System.Int32
Der Index der Strokes-Auflistung, die aus der CustomStrokes-Auflistung entfernt werden soll.

Hinweise

Eine CustomStrokes-Auflistung ist ein Verweis auf Freihanddaten, nicht jedoch die tatsächlichen Daten selbst. Diese Methode entfernt nur die entsprechende Auflistung aus einem Snapshot der Freihanddaten oder aus einem Verweis auf die Freihanddaten. Sie entfernt nicht die tatsächlichen Freihanddaten. Rufen Sie die Ink.DeleteStrokes-Methode auf, um die Auflistung aus den tatsächlichen Freihanddaten zu löschen.

Eine System.ArgumentOutOfRangeException wird ausgelöst, wenn der Parameter index keinem vorhandenen Member der CustomStrokes-Auflistung entspricht. Wenn Sie für Entwicklungszwecke Windows XP (nicht die Tablet Edition) mit installiertem Tablet PC SDK verwenden und der Parameter index keinem vorhandenen Member der CustomStrokes-Auflistung entspricht, wird eine System.Runtime.InteropServices-Ausnahme ausgelöst.

Beispiele

In diesem Beispiel wird die Strokes-Auflistung entfernt, die unter dem angegebenen Index in einer CustomStrokes-Auflistung gespeichert ist. Wenn keine Strokes-Auflistung unter dem angegebenen Index vorhanden ist, wird eine Ausnahme ausgelöst.

Private Sub RemoveCustomStrokes(ByVal mIndex As Integer, ByVal mInk As Ink)
    Try
        ' if the indexed position does not exist, an exception will be raised
        mInk.CustomStrokes.RemoveAt(mIndex)

    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
    End Try
End Sub

private void RemoveCustomStrokes(int mIndex, Ink mInk)
{
    try
    {
        // if the indexed position does not exist, an exception will be raised
        mInk.CustomStrokes.RemoveAt(mIndex);
    }
    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
    }

}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

CustomStrokes-Klasse

CustomStrokes-Member

Microsoft.Ink-Namespace

Freigeben über