Share via


IXRImageBrush::GetImageSource (Windows Embedded CE 6.0)

1/6/2010

This method retrieves the image displayed by this image brush.

Syntax

virtual HRESULT STDMETHODCALLTYPE GetImageSource(
    IXRImageSource** ppImageSource
) = 0;

Parameters

  • ppImageSource
    [out] Address of a pointer to an object derived from IXRImageSource that contains the image displayed by this image brush.

Return Value

Returns an HRESULT that indicates success or failure.

Remarks

The underlying IXRImageSource instance that represents the graphical image is usually an IXRBitmapImage, which is a derived class.

If the initial ImageSource attribute value in the source XAML for your application does not specify a valid source, the ImageFailed event can occur when this method is called.

To create an undisplayed placeholder, you can specify an initial value in Microsoft Silverlight 2 XAML of "" (empty string) and then set the value in C++ code later.

To use a specific interface pointer type, you can use the helper template version of this method that Silverlight for Windows Embedded provides. When you supply a derived type, this version automatically supplies a type-safe method that implicitly converts the returned type from a generic interface so you do not have to explicitly call QueryInterface to convert the generic interface into the required object type. For more information, see Type-Safety in Silverlight for Windows Embedded.

.NET Framework Equivalent

System.Windows.Media.ImageBrush.ImageSource

Requirements

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

See Also

Reference

IXRImageBrush
IXRImageBrush::SetImageSource