ClaimedLineDisplay.TryCreateWindowAsync(Rect, Size) Methode

Definition

Versucht, ein LineDisplayWindow asynchron zu erstellen.

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)

Parameter

viewport
Rect

Die Zeile des Ursprungsgeräts des Viewports, die Spalte des Ursprungsgeräts, die Breite in Zeilen und die Höhe in Spalten.

windowSize
Size

Die Anzahl der Zeilen und die Anzahl der Spalten im Fenster.

Gibt zurück

Ein neues LineDisplayWindow-Objekt , das ein neues Fenster für das Gerät darstellt.

Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v5.0)

Hinweise

Wenn LineDisplayCapabilities.SupportedWindows größer als 0 ist, kann diese Methode aufgerufen werden, um ein neues LineDisplayWindow-Objekt zu erstellen, das ein neues Fenster für das Gerät darstellt. Das neue Fenster wird beim Erstellen nicht automatisch als aktuelles Fenster festgelegt, um dieses Fenster als aktuell festzulegen, legen Sie die LineDisplayAttributes.CurrentWindow-Eigenschaft so fest, dass sie auf dieses LineDisplayWindow-Objekt verweist, oder rufen Sie auf das gleiche LineDisplayWindow-Objekt die TryRefreshAsync-Methode auf.

Das Aufrufen dieser Methode, wenn LineDisplayCapabilities.SupportedWindows den Wert 0 aufweist, führt zu einer Ausnahme.

Die Fenstergröße muss mindestens so groß wie die Viewportgröße sein, und sie darf in höchstens einer Richtung größer als sein Viewport sein. Wenn LineDisplayCapabilities.IsVerticalMarqueeSupported auf True festgelegt ist, ist das Fenster möglicherweise größer als der Viewport in der vertikalen Dimension. Wenn LineDisplayCapabilities.IsHorizontalMarqueeSupported auf True festgelegt ist, ist das Fenster möglicherweise größer als der Viewport in der horizontalen Dimension.

Gilt für: