Share via


IXRVisualTransition::GetTo (Windows Embedded CE 6.0)

1/6/2010

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

Syntax

virtual HRESULT STDMETHODCALLTYPE GetTo(
    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

The following list shows examples of visual states that can be specified in the pTo parameter:

  • Checked
  • Disabled
  • Focused
  • Indeterminate
  • MouseOver
  • Normal
  • Pressed
  • Unchecked
  • Unfocused

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 x: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.

.NET Framework Equivalent

System.Windows.VisualTransition.To

Requirements

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

See Also

Reference

IXRVisualTransition
IXRVisualTransition::SetTo