ClaimedLineDisplay.TryCreateWindowAsync(Rect, Size) Method
Definition
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.
Attempts to asynchronously create a LineDisplayWindow.
public:
virtual IAsyncOperation<LineDisplayWindow ^> ^ TryCreateWindowAsync(Rect viewport, Size windowSize) = TryCreateWindowAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<LineDisplayWindow> TryCreateWindowAsync(Rect const& viewport, Size const& windowSize);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<LineDisplayWindow> TryCreateWindowAsync(Rect viewport, Size windowSize);function tryCreateWindowAsync(viewport, windowSize)Public Function TryCreateWindowAsync (viewport As Rect, windowSize As Size) As IAsyncOperation(Of LineDisplayWindow)Parameters
- viewport
- Rect
The viewport’s origin device row, origin device column, width in rows and height in columns.
- windowSize
- Size
The numbers of rows and the number of columns in the window.
Returns
A new LineDisplayWindow object, representing a new window for the device.
- Attributes
Windows requirements
| Device family |
Windows 10 Fall Creators Update (introduced in 10.0.16299.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v5.0)
|
Remarks
When LineDisplayCapabilities.SupportedWindows is greater than 0 this method can be called to create a new LineDisplayWindow object representing a new window for the device. The new window is not automatically set as the current window when it is created, to set that window as current set the LineDisplayAttributes.CurrentWindow property to point to this LineDisplayWindow object, or on that same LineDisplayWindow object call its TryRefreshAsync method.
Calling this method when LineDisplayCapabilities.SupportedWindows is 0 will result in an exception.
The window size must be at least as large as the viewport size, and it may be larger than its viewport in at most one direction. When LineDisplayCapabilities.IsVerticalMarqueeSupported is True, the window may be larger than the viewport in the vertical dimension. When LineDisplayCapabilities.IsHorizontalMarqueeSupported is True, the window may be larger than the viewport in the horizontal dimension.