ExtendedProperties.Remove メソッド (Guid)

2008-10-28

ExtendedProperties コレクションから ExtendedProperty オブジェクトを削除します。

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

構文

'宣言
Public Sub Remove ( _
    id As Guid _
)
'使用
Dim instance As ExtendedProperties
Dim id As Guid

instance.Remove(id)

public void Remove(
    Guid id
)

public:
void Remove(
    Guid id
)

public void Remove(
    Guid id
)

public function Remove(
    id : Guid
)

パラメータ

id
型 : System.Guid
ExtendedProperties コレクションから削除する ExtendedProperty オブジェクトのグローバル一意識別子 (GUID)。

解説

このメソッドは、インクデータのスナップショットまたはインクデータへの参照からのみ ExtendedProperty オブジェクトを削除し、実際のインクデータからは ExtendedProperty を削除しません。

例

この例では、Strokes コレクションの各 Stroke オブジェクトを調べます。Stroke の ExtendedProperties に、特別なタイムスタンプ Guid オブジェクトに関連付けられているプロパティが含まれている場合は、ExtendedProperty がコレクションから削除されます。

Private Sub RemoveAllTimeStampProperties()
    ' STROKE_START_GUID and STROKE_END_GUID
    ' are class level string const set via GUID generator
    Dim strokeStartGuid As Guid = New Guid(STROKE_START_GUID)
    Dim strokeEndGuid As Guid = New Guid(STROKE_END_GUID)

    ' access the Strokes property via using statement
    ' to insure that the object mStrokes is disposed when finished
    ' Otherwise, you will have a memory leak
    Using mStrokes As Strokes = mInkObject.Ink.Strokes
        For Each S As Stroke In mStrokes
            If S.ExtendedProperties.Contains(strokeStartGuid) Then
                S.ExtendedProperties.Remove(strokeStartGuid)
            End If
            If S.ExtendedProperties.Contains(strokeEndGuid) Then
                S.ExtendedProperties.Remove(strokeEndGuid)
            End If
        Next
    End Using
End Sub

private void RemoveAllTimeStampProperties()
{
    // STROKE_START_GUID and STROKE_END_GUID
    // are class level string const set via GUID generator
    Guid strokeStartGuid = new Guid(STROKE_START_GUID);
    Guid strokeEndGuid = new Guid(STROKE_END_GUID);

    // access the Strokes property via using statement
    // to insure that the object mStrokes is disposed when finished
    // Otherwise, you will have a memory leak
    using (Strokes mStrokes = mInkObject.Ink.Strokes)
    {
        foreach (Stroke S in mStrokes)
        {
            if (S.ExtendedProperties.Contains(strokeStartGuid))
            {
                S.ExtendedProperties.Remove(strokeStartGuid);
            }
            if (S.ExtendedProperties.Contains(strokeEndGuid))
            {
                S.ExtendedProperties.Remove(strokeEndGuid);
            }
        }
    }
}