Share via


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

1/6/2010

This method retrieves the value of the specified attached property.

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

Syntax

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

Parameters

  • pDP
    [in] Pointer to a string that contains the name of the attached property that you want to retrieve.
  • pValue
    [out] On return, contains a pointer to a string that reflects the value of 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 retrieve 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 retrieve the value of an attached property in Silverlight, or to retrieve the value of a custom attached property that you create and register for a user-defined control.

Silverlight Equivalent

GetValue

Requirements

Header XamlRuntime.h
sysgen SYSGEN_XAML_RUNTIME
Windows Embedded CE Windows Embedded CE 6.0 R3

See Also

Reference

IXRDependencyObject::GetAttachedProperty
IXRDependencyObject