ContentDialog.ShowAsync 方法

定義

命名空間:

Windows.UI.Xaml.Controls

多載

ShowAsync()	開始非同步作業以顯示對話方塊。
ShowAsync(ContentDialogPlacement)	開始非同步作業，以顯示具有指定位置的對話方塊。

ShowAsync()

開始非同步作業以顯示對話方塊。

public:
 virtual IAsyncOperation<ContentDialogResult> ^ ShowAsync() = ShowAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
/// [Windows.Foundation.Metadata.Overload("ShowAsync")]
IAsyncOperation<ContentDialogResult> ShowAsync();

[Windows.Foundation.Metadata.RemoteAsync]
[Windows.Foundation.Metadata.Overload("ShowAsync")]
public IAsyncOperation<ContentDialogResult> ShowAsync();

function showAsync()

Public Function ShowAsync () As IAsyncOperation(Of ContentDialogResult)

傳回

IAsyncOperation<ContentDialogResult>

顯示對話方塊的非同步作業。 完成時，會傳回 ContentDialogResult。

屬性

RemoteAsyncAttribute OverloadAttribute

ShowAsync(ContentDialogPlacement)

開始非同步作業，以顯示具有指定位置的對話方塊。

public:
 virtual IAsyncOperation<ContentDialogResult> ^ ShowAsync(ContentDialogPlacement placement) = ShowAsync;

/// [Windows.Foundation.Metadata.Overload("ShowAsyncWithPlacement")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<ContentDialogResult> ShowAsync(ContentDialogPlacement const& placement);

[Windows.Foundation.Metadata.Overload("ShowAsyncWithPlacement")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<ContentDialogResult> ShowAsync(ContentDialogPlacement placement);

function showAsync(placement)

Public Function ShowAsync (placement As ContentDialogPlacement) As IAsyncOperation(Of ContentDialogResult)

參數

placement

ContentDialogPlacement

值，指定對話方塊是否放在 PopupRoot 或其父系的視覺化樹狀結構中。

傳回

IAsyncOperation<ContentDialogResult>

顯示對話方塊的非同步作業。 完成時，會傳回 ContentDialogResult。

屬性

OverloadAttribute RemoteAsyncAttribute

Windows 需求

裝置系列	Windows 10 Fall Creators Update (已於 10.0.16299.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v5.0 引進)

備註

當您使用 ContentDialogPlacement.Popup 參數值呼叫這個方法時，對話方塊會根目錄在 XAML 視窗的 PopupRoot 元素中。 這是預設行為，而且與呼叫沒有參數的 ShowAsync 方法相等。

當您使用 ContentDialogPlacement.InPlace 參數值呼叫此方法時：

• 如果對話方塊有父元素，對話方塊就會根目錄在父系的視覺化樹狀結構中。 它會與父系的其他子項目一起內嵌顯示，並參與父容器的配置。
• 如果對話方塊沒有父代，對話方塊會回復為預設行為，並會顯示在 PopupRoot 中。