UIElement.StartBringIntoView Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
| StartBringIntoView() |
Initiates a request to the XAML framework to bring the element into view within any scrollable regions it is contained within. |
| StartBringIntoView(BringIntoViewOptions) |
Initiates a request to the XAML framework to bring the element into view using the specified options. |
Initiates a request to the XAML framework to bring the element into view within any scrollable regions it is contained within.
public:
virtual void StartBringIntoView() = StartBringIntoView;/// [Windows.Foundation.Metadata.Overload("StartBringIntoView")]
void StartBringIntoView();[Windows.Foundation.Metadata.Overload("StartBringIntoView")]
public void StartBringIntoView();function startBringIntoView()Public Sub StartBringIntoView ()- Attributes
Remarks
The request is fulfilled asynchronously as the framework initiates changes to the view of ScrollViewers that contain the element. The HorizontalOffset and VerticalOffset of those ScrollViewers may not be updated immediately upon returning from the call. However, in the process of servicing the request a ScrollViewer's ViewChanging and ViewChanged events will fire.
If you use the signature that does not specify any options, then the entire element size (its RenderSize) will be made visible and any changes to the viewports will be animated.
The StartBringIntoView method does not transmit any information about success or failure. Reasons for failure can include the element settings, such as Visibility being some value other than Visible.
See also
Applies to
Windows App SDK 1.6 and other versions
| Product | Versions |
|---|---|
| Windows App SDK | 0.8, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6 |
Initiates a request to the XAML framework to bring the element into view using the specified options.
public:
virtual void StartBringIntoView(BringIntoViewOptions ^ options) = StartBringIntoView;/// [Windows.Foundation.Metadata.Overload("StartBringIntoViewWithOptions")]
void StartBringIntoView(BringIntoViewOptions const& options);[Windows.Foundation.Metadata.Overload("StartBringIntoViewWithOptions")]
public void StartBringIntoView(BringIntoViewOptions options);function startBringIntoView(options)Public Sub StartBringIntoView (options As BringIntoViewOptions)Parameters
- options
- BringIntoViewOptions
An instance of BringIntoViewOptions.
- Attributes
Applies to
Windows App SDK 1.6 and other versions
| Product | Versions |
|---|---|
| Windows App SDK | 0.8, 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6 |