DrawingAttributes.AddPropertyData(Guid, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
DrawingAttributes オブジェクトにカスタム プロパティを追加します。
public:
void AddPropertyData(Guid propertyDataId, System::Object ^ propertyData);public void AddPropertyData (Guid propertyDataId, object propertyData);member this.AddPropertyData : Guid * obj -> unitPublic Sub AddPropertyData (propertyDataId As Guid, propertyData As Object)パラメーター
- propertyData
- Object
カスタム プロパティの値。
propertyData には、Char、Byte、Int16、UInt16、Int32、UInt32、Int64、UInt64、Single、Double、DateTime、Boolean、String、Decimal の各型の値、またはこれらのデータ型 (String の配列は除く) の配列を指定する必要があります。
例外
propertyData が nullです。
例
次の例では、 オブジェクトからカスタム プロパティを追加および取得する方法を DrawingAttributes 示します。 この例では、オブジェクトがペンか蛍光ペンかを DrawingAttributes 示すプロパティを追加します。 イベント ハンドラーのChangeColors_Clickコードは、 inkDAオブジェクト を使用する のストロークのInkCanvas新しい色をDrawingAttributesレンダリングします。 この例では、 という名前の InkCanvas があり、 と という名前highlighterDAinkCanvas1inkDAの 2 つのDrawingAttributesオブジェクトがあることを前提としています。
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
注釈
AddPropertyDataメソッドを使用すると、カスタム プロパティを オブジェクトにDrawingAttributes追加できます。 これは、独自のストロークをレンダリングし、追加情報を提供する場合に便利です。
適用対象
.NET