IXRUIElement::GetCacheMode (Compact 2013)

3/28/2014

This method retrieves a value that indicates whether this UI element will use bitmap caching and hardware-accelerated graphics when it is displayed at run time.

Syntax

virtual HRESULT STDMETHODCALLTYPE GetCacheMode(
    IXRCacheMode** ppCacheMode
) = 0;

Parameters

  • ppCacheMode
    [out] Address of a pointer that will point to an IXRCacheMode-derived object if this UI element will use bitmap caching and hardware-accelerated graphics at run time.

Return Value

Returns an HRESULT that indicates success or failure.

Remarks

You can use bitmap caching for a UI element if it implements one of the following features:

  • Transformations (such as translating, rotating, or stretching)
  • Clipping
  • Blending
  • Resources or child objects that are animation storyboards

To use a specific interface pointer type, you can use the helper template version of this method that XAML 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.

.NET Framework Equivalent

None.

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

IXRUIElement
IXRUIElement::SetCacheMode