Share via


IXRVisualTransition::GetTo (Compact 2013)

3/28/2014

This method retrieves the name of the visual state to transition to.

Syntax

virtual HRESULT STDMETHODCALLTYPE GetTo(
    __out BSTR* pTo
) = 0;

Parameters

  • pTo
    [out] Pointer to a string that contains the name of the visual state to transition to.

Return Value

Returns an HRESULT that indicates success or failure.

Remarks

Specifying a state to transition to, by calling IXRVisualTransition::SetTo, is optional. A visual transition can be restricted to apply to only certain states, or it can be applied any time that the control transitions between states. You restrict when an IXRVisualTransition object is applied to the control by calling IXRVisualTransition::SetTo and IXRVisualTransition::SetFrom.

The following table describes the levels of restriction, from most restrictive to least restrictive.

Kind of restriction

Value to set in SetFrom

Value to set in SetTo

From a specified state to another specified state

The Name of an IXRVisualState

The Name of an IXRVisualState

From any state to a specified state

Not set

The Name of an IXRVisualState

From a specified state to any state

The Name of an IXRVisualState

Not set

From any state to any other state

Not set

Note set

You can have multiple IXRVisualTransition objects in a collection that belongs to an IXRVisualStateGroup that refer to the same state. However, they will be used in the order that this table specifies.

Note

The contents of a ControlTemplate defined in Microsoft Silverlight 3 XAML cannot be accessed from C++. Therefore, visual transitions and visual-state groups that were defined in a ControlTemplate in the source XAML for your application cannot be accessed in XAML for Windows Embedded object tree.

.NET Framework Equivalent

System.Windows.VisualTransition.To

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

IXRVisualTransition
IXRVisualTransition::SetTo