DesktopWindowXamlSource クラス

  • リファレンス

定義

名前空間:
Windows.UI.Xaml.Hosting
編集

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

/// [Windows.Foundation.Metadata.ContractVersion(Windows.UI.Xaml.Hosting.HostingContract, 196608)]
/// [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(Windows.UI.Xaml.Hosting.HostingContract), 196608)]
[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

Windows の要件

デバイス ファミリ
Windows Desktop Extension SDK (10.0.17763.0 で導入)
API contract
Windows.UI.Xaml.Hosting.HostingContract (v3.0 で導入)

注釈

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

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

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

コンストラクター

DesktopWindowXamlSource()

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

プロパティ

Content

デスクトップ アプリケーションでホストする Windows.UI.Xaml.UIElement オブジェクトを取得または設定します。
HasFocus

DesktopWindowXamlSource が現在デスクトップ アプリケーションにフォーカスを置いているかどうかを示す値を取得します。

メソッド

Close()

この DesktopWindowXamlSource で使用されるすべてのリソースを閉じて解放します。
Dispose()

アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
NavigateFocus(XamlSourceFocusNavigationRequest)

デスクトップ アプリケーションの DesktopWindowXamlSource にプログラムによってフォーカスを与えようとします。

イベント

GotFocus

DesktopWindowXamlSource がデスクトップ アプリケーションでフォーカスを取得したときに発生します (たとえば、DesktopWindowXamlSource の直前の要素にフォーカスがあるときに、ユーザーが Tab キーを押します)。
TakeFocusRequested

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

適用対象

こちらもご覧ください