IXRDependencyObject::SetAttachedProperty(const WCHAR*, WCHAR*) (Windows Embedded CE 6.0)

1/6/2010

This method sets the value of the specified attached property.

Use this method if the specified attached property has a string type.

Syntax

virtual HRESULT STDMETHODCALLTYPE SetAttachedProperty(
    const WCHAR *pDP,
    WCHAR * pValue
) = 0;

Parameters

• pDP
  [in] Pointer to a string that contains the name of the attached property that you want to set for this object.

• pValue
  [in] Pointer to a string that reflects the new value to set for the property that you specified in pDP.

Return Value

Returns an HRESULT that indicates success or failure.

Returns XR_E_INVALID_PROPERTY if this method was unable to locate the property requested.

Remarks

Attached properties are a concept that is part of the XAML language. You can set an attached property on objects or XAML elements, even if that property is not conventionally defined in the properties list that belongs to the setting object. For attached properties such as Canvas.Top, the object.property notation does not work because the two "dots" in the syntax create ambiguity. Instead, you set attached properties in Silverlight by using a (C++) string that defines the full dotted name of the attached property (for example, L"Canvas.Top"). In the pDP parameter, the "." (dot) is considered part of the property name/identifier.

You can use this method to set the value of attached properties in Silverlight for Windows Embedded, such as Canvas.Left. In this case, the attached property name consists of the owner class name for the attached property, a dot, and the attached property name ("ownerType.propertyName").

You can call this method to set the value of an attached property in Silverlight, or to set the value of a custom attached property that you created and registered for a user-defined control.

Example

The following lines of C++ code demonstrate the correct syntax for using this method to set the Storyboard.TargetName attached property for the inheriting IXRTimeline derived object:

WCHAR* pElementName = "myElement";
myAnimation->SetAttachedProperty(L"Storyboard.TargetName", &pElementName));

Silverlight Equivalent

SetValue

Requirements

See Also

Reference

IXRDependencyObject::SetAttachedProperty
IXRDependencyObject