DesktopWindowXamlSource クラス

定義

名前空間:

Microsoft.UI.Xaml.Hosting

デスクトップ アプリケーション (WPF やWindows フォーム アプリケーションなど) が、ウィンドウ ハンドル (HWND) に関連付けられている任意の UI 要素で WinUI コントロールをホストできるようにします。

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DesktopWindowXamlSource : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class DesktopWindowXamlSource : System.IDisposable

Public Class DesktopWindowXamlSource
Implements IDisposable

継承

Object IInspectable DesktopWindowXamlSource

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装

IClosable IDisposable

注釈

DesktopWindowXamlSource は、Windows アプリ SDK XAML ホスティング API のプライマリ クラスです。 この API を使用すると、WASDK 以外のデスクトップ アプリケーションは、ウィンドウ ハンドル (HWND) に関連付けられている UI 要素で 、Microsoft.UI.Xaml.UIElement から派生したコントロールをホストできます。 この API は、WPF、Windows フォーム、および Windows API (Win32) を使用して構築されたデスクトップ アプリケーションで使用できます。

ホストされる UIElement オブジェクトを作成する前に DesktopWindowXamlSource オブジェクトを作成すると、UIElement コンテンツをホストするためのフレームワークによって、すべてのオブジェクトが同じスレッドに初期化されます。 UIElement オブジェクトがホストされる DesktopWindowXamlSource オブジェクトを作成する前に UIElement オブジェクトを作成する場合は、UIElement オブジェクトをインスタンス化する前に Microsoft.UI.Xaml.Hosting.WindowsXamlManager.InitializeForCurrentThread を呼び出す必要があります。

DesktopWindowXamlSource は IClosable から派生しているため、終了したら閉じる (.NET で破棄する) ことをお勧めします。

コンストラクター

DesktopWindowXamlSource()

DesktopWindowXamlSource クラスの新しいインスタンスを初期化します。

プロパティ

Content	デスクトップ アプリケーションでホストする Microsoft.UI.Xaml.UIElement オブジェクトを取得または設定します。
HasFocus	DesktopWindowXamlSource が現在デスクトップ アプリケーションにフォーカスを置いているかどうかを示す値を取得します。
ShouldConstrainPopupsToWorkArea	ポップアップのような動作を持つコントロールを作業領域に制限するかどうかを示す値を取得または設定します。
SiteBridge	DesktopSiteBridgeこの DesktopWindowXamlSource オブジェクトに関連付けられている を取得します。
SystemBackdrop	マイカやアクリルなどのマテリアルをレンダリングするために使用されるシステムの背景を取得または設定します。

メソッド

Close()	この DesktopWindowXamlSource で使用されるすべてのリソースを閉じて解放します。
Dispose()	アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
Initialize(WindowId)	DesktopWindowXamlSource クラスの新しいインスタンスを初期化します。
NavigateFocus(XamlSourceFocusNavigationRequest)	プログラムによってデスクトップ アプリケーションの DesktopWindowXamlSource にフォーカスを設定しようとします。

イベント

GotFocus	DesktopWindowXamlSource がデスクトップ アプリケーションでフォーカスを取得したときに発生します (DesktopWindowXamlSource の直前の要素にフォーカスがあるときにユーザーが Tab キーを押したときなど)。
TakeFocusRequested	ホスト デスクトップ アプリケーションが DesktopWindowXamlSource オブジェクトからフォーカスを取り戻す要求を受け取ったときに発生します (たとえば、ユーザーは DesktopWindowXamlSource の最後のフォーカス可能な要素に移動し、 Tab キーを押します)。

こちらもご覧ください

• C++ デスクトップ (Win32) アプリでの WinRT XAML ホスティング API の使用