次の方法で共有


DesktopWindowXamlSource クラス

定義

デスクトップ アプリケーション (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
属性
実装

注釈

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 を呼び出す必要があります。

DesktopWindowXamlSourceIClosable から派生しているため、終了したら閉じる (.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 キーを押します)。

適用対象

こちらもご覧ください