DrawingAttributes.GetPropertyData(Guid) Yöntem

Tanım

Belirtilen özel özelliğin değerini alır, bununla ilişkili Guid .Gets the value of the custom property associated with the specified Guid.

public:
 System::Object ^ GetPropertyData(Guid propertyDataId);
public object GetPropertyData (Guid propertyDataId);
member this.GetPropertyData : Guid -> obj
Public Function GetPropertyData (propertyDataId As Guid) As Object

Parametreler

propertyDataId
Guid

GuidAlınacak özel özellik ile ilişkili.The Guid associated with the custom property to get.

Döndürülenler

Object

Belirtilen özel özelliğin değeri Guid .The value of the custom property associated with the specified Guid.

Özel durumlar

propertyDataId nesnenin özel bir özelliği ile ilişkilendirilmemiş DrawingAttributes .propertyDataId is not associated with a custom property of the DrawingAttributes object.

Örnekler

Aşağıdaki örnek nesnesinden özel bir özelliğin nasıl ekleneceğini ve alınacağını gösterir DrawingAttributes .The following example demonstrates how to add and retrieve a custom property from the DrawingAttributes object. Örnek, nesnenin bir kalem mi yoksa bir vurgulayıcı mi olduğunu gösteren bir özellik ekler DrawingAttributes .The example adds a property that indicates whether the DrawingAttributes object is a pen or a highlighter. ChangeColors_ClickOlay işleyicisindeki kod, nesnesini kullanan üzerinde vuruş için yeni bir renk işler InkCanvas DrawingAttributes , inkDA .The code in the ChangeColors_Click event handler renders a new color for strokes on the InkCanvas that use the DrawingAttributes object, inkDA. Bu örnek, adlı bir adlandırılmış olduğunu InkCanvas inkCanvas1 ve adında iki nesne olduğunu varsayar DrawingAttributes inkDA ve highlighterDA.This example assumes that there is an InkCanvas named inkCanvas1, and that there are two DrawingAttributes objects named inkDA, and highlighterDA.

Guid purposeGuid = new Guid("12345678-9012-3456-7890-123456789012");
string penValue = "pen";
string highlighterValue = "highlighter";

// Add a property to each DrawingAttributes object to 
// specify its use.
private void AssignDrawingAttributesInstrument()
{
    inkDA.AddPropertyData(purposeGuid, penValue);
    highlighterDA.AddPropertyData(purposeGuid, highlighterValue);
}

// Change the color of the ink that on the InkCanvas that used the pen.
void ChangeColors_Click(Object sender, RoutedEventArgs e)
{
    foreach (Stroke s in inkCanvas1.Strokes)
    {
        if (s.DrawingAttributes.ContainsPropertyData(purposeGuid))
        {
            object data = s.DrawingAttributes.GetPropertyData(purposeGuid);

            if ((data is string) && ((string)data == penValue))
            {
                s.DrawingAttributes.Color = Colors.Black;
            }
        }
    }
}
Private purposeGuid As New Guid("12345678-9012-3456-7890-123456789012")
Private penValue As String = "pen"
Private highlighterValue As String = "highlighter"

' Add a property to each DrawingAttributes object to 
' specify its use.
Private Sub AssignDrawingAttributesInstrument()

    inkDA.AddPropertyData(purposeGuid, penValue)
    highlighterDA.AddPropertyData(purposeGuid, highlighterValue)

End Sub

' Change the color of the ink that on the InkCanvas that used the pen.
Private Sub ChangeColors_Click(ByVal sender As [Object], _
        ByVal e As RoutedEventArgs)

    Dim s As Stroke

    For Each s In inkCanvas1.Strokes
        If s.DrawingAttributes.ContainsPropertyData(purposeGuid) Then

            Dim data As Object = s.DrawingAttributes.GetPropertyData(purposeGuid)

            If TypeOf data Is String AndAlso CStr(data) = penValue Then
                s.DrawingAttributes.Color = Colors.Black
            End If

        End If
    Next s

End Sub

Açıklamalar

GetPropertyDataNesnesine eklediğiniz özel özelliklere erişmek için yöntemini kullanın DrawingAttributes .Use the GetPropertyData method to access custom properties you added to a DrawingAttributes object. GetPropertyData bir değer ayarlanmamışsa, yerleşik özelliğin varsayılan değerini döndürür.GetPropertyData returns the default value for the built-in property if a value has not been set.

Şunlara uygulanır

Ayrıca bkz.