DesktopWindowXamlSource クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
デスクトップ アプリケーション (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.IDisposablePublic Class DesktopWindowXamlSource
Implements 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 キーを押します)。 |