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 |