CoreWindow クラス

定義

名前空間:

Windows.UI.Core

入力イベントと基本的なユーザー インターフェイス動作を持つ UWP アプリを表します。

public ref class CoreWindow sealed : ICorePointerRedirector, ICoreWindow

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class CoreWindow final : ICorePointerRedirector, ICoreWindow

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class CoreWindow : ICorePointerRedirector, ICoreWindow

Public NotInheritable Class CoreWindow
Implements ICorePointerRedirector, ICoreWindow

継承

Object Platform::Object IInspectable CoreWindow

属性

ContractVersionAttribute MarshalingBehaviorAttribute

実装

ICoreWindow ICorePointerRedirector

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

このクラスの新しいインスタンスは、CoreApplication.CreateNewView を呼び出し、返された CoreApplicationView インスタンスの CoreWindow プロパティを調べることによって取得されます。 または、次の例に示すように、 CoreApplication.Views プロパティから、または CoreWindow.GetForCurrentThread を呼び出して、実行中のアプリの既存の CoreWindow インスタンスを取得することもできます。

// App.cpp
...
// An implementation of IFrameworkView::Run.
void Run()
{
    CoreWindow window{ CoreWindow::GetForCurrentThread() };
    window.Activate();

    CoreDispatcher dispatcher{ window.Dispatcher() };
    dispatcher.ProcessEvents(CoreProcessEventsOption::ProcessUntilQuit);
}

// The CoreApplication::Run call indirectly calls the App::Run function above.
int __stdcall wWinMain(HINSTANCE, HINSTANCE, PWSTR, int)
{
    CoreApplication::Run(App());
}

void MyCoreWindowEvents::Run() // this is an implementation of IFrameworkView::Run() used to show context
{
    CoreWindow::GetForCurrentThread()->Activate();

    /...

    CoreWindow::GetForCurrentThread()->Dispatcher->ProcessEvents(CoreProcessEventsOption::ProcessUntilQuit);
}

注意

このクラスはアジャイルではありません。つまり、スレッド モデルとマーシャリング動作を考慮する必要があります。 詳細については、「 スレッドとマーシャリング (C++/CX)」を参照してください。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1511	10586	PointerRoutedAway
1511	10586	PointerRoutedReleased
1511	10586	PointerRoutedTo
1607	14393	ClosestInteractiveBoundsRequested
1607	14393	GetCurrentKeyEventDeviceId
1703	15063	ResizeCompleted
1703	15063	ResizeStarted
1709	16299	ActivationMode
1709	16299	DispatcherQueue
1903	18362	UIContext

プロパティ

ActivationMode	ウィンドウのアクティブ化状態を示す値を取得します。
AutomationHostProvider	このウィンドウに割り当てられているオートメーション プロバイダーを取得します。
Bounds	デバイスに依存しないピクセル (DIP) で、ウィンドウのクライアント領域の原点、高さ、幅を含む Rect 値を取得します。
CustomProperties	ウィンドウのカスタム プロパティのセットを取得します。
Dispatcher	ウィンドウのイベント ディスパッチャーを取得します。
DispatcherQueue	ウィンドウの DispatcherQueue を取得します。
FlowDirection	ウィンドウの読み取り順序の配置の水平方向の原点を取得または設定します。 ユーザー インターフェイスで指定された言語が右揃え (アラビア語やヘブライ語など) の場合、ウィンドウの読み取りレイアウトの水平方向の原点は右端にあります。
IsInputEnabled	アプリに対して入力が有効かどうかを示す値を取得または設定します。
PointerCursor	アプリで使用されるポインター カーソルを取得または設定します。
PointerPosition	ポインターのクライアント座標を取得します。
UIContext	コア ウィンドウのコンテキスト識別子を取得します。
Visible	ウィンドウが表示されているかどうかを示す値を取得します。

メソッド

Activate()	ウィンドウをアクティブにします。 このメソッドは、画面にウィンドウを表示するために呼び出されます。
Close()	セカンダリ ウィンドウを閉じ、メッセージ ループを終了します。
GetAsyncKeyState(VirtualKey)	仮想キーの状態を非同期的に取得します。
GetCurrentKeyEventDeviceId()	このキー イベントを生成した入力デバイスの一意の ID を取得します。 GetCurrentKeyEventDeviceId は、すべての入力デバイスでサポートされていません。
GetForCurrentThread()	現在アクティブなスレッドの CoreWindow インスタンスを取得します。
GetKeyState(VirtualKey)	仮想キーの状態を取得します。
ReleasePointerCapture()	以前に SetPointerCapture を介して関連付けられている場合は、アプリからのポインター入力の関連付けを解除し、通常のポインター入力処理を復元します。
SetPointerCapture()	ポインター入力をアプリに関連付けます。 ポインターがキャプチャされると、そのポインターに関連付けられている後続のすべてのイベントがアプリによって発生します。

イベント

Activated	ウィンドウがアクティブ化または非アクティブ化を完了すると発生します。
AutomationProviderRequested	オートメーション ハンドラーの要求が生成されたときに発生します。
CharacterReceived	入力キューで新しい文字を受信すると発生します。
Closed	ウィンドウが閉じられる (またはアプリが完全に終了する) ときに発生します。
ClosestInteractiveBoundsRequested	注意 一般的な使用を目的としたものではありません。 フレームワーク入力マネージャーが、特定の外接する四角形内で、特定のポインターに最も近い対話型要素の外接する四角形を要求したときに発生します。
InputEnabled	アプリの入力が有効または無効になったときに発生します。
KeyDown	システム以外のキーが押されたときに発生するイベント。 このイベントのデリゲート型は TypedEventHandler<TSender,TResult> です。 TSender は CoreWindow 型で、 TResult は KeyEventArgs 型です。
KeyUp	システム以外のキーが押された後に解放されたときに発生するイベント。 このイベントのデリゲート型は TypedEventHandler<TSender,TResult> です。 TSender は CoreWindow 型で、 TResult は KeyEventArgs 型です。
PointerCaptureLost	ポインターが別のアプリに移動したときに発生します。 このイベントは PointerExited の後に発生し、このポインターに対してアプリによって受信される最終的なイベントです。
PointerEntered	ポインターがアプリの境界ボックスに移動したときに発生します。
PointerExited	ポインターがアプリの境界ボックスの外に移動したときに発生します。
PointerMoved	アプリの境界ボックス内でポインターが移動したときに発生します。
PointerPressed	アプリの外接する四角形内でマウス ボタンがクリックされたとき、またはデジタイザーサーフェイスが指またはペンでタッチされたときに発生します。 操作セッションは、1 つの連絡先が検出されたときに開始され、その連絡先と同じセッション内の後続のすべての連絡先が検出されなくなったときに終了します。 このイベントは、対話セッションで検出された最初の連絡先に対して発生します。 他のすべての同時連絡先ポインターの詳細は、PointerPointProperties オブジェクト (PointerPoint オブジェクトから Properties プロパティを取得することによって取得) を介して公開されます。
PointerReleased	押されたマウス ボタンが離されたとき、またはタッチまたはペンの接触がデジタイザー画面からアプリの外接する四角形内 (ポインターがキャプチャされている場合は外接する四角形の外側) に持ち上げられたときに発生します。
PointerRoutedAway	ポインターが別の入力オブジェクト (場合によっては別のプロセスで) にリダイレクトされるときに、ポインター入力を受け取る入力オブジェクトで発生します。
PointerRoutedReleased	入力オブジェクトに対して CoreIndependentInputSource.PointerReleased イベントを発生するポインターに関連付けられたが、現在入力を受信していないすべての入力オブジェクトで発生します。
PointerRoutedTo	キャプチャされたポインター入力が以前に別のオブジェクトに配信され、このオブジェクトに配信されるに遷移したときに発生します。
PointerWheelChanged	マウス ホイールが回転したときに発生するイベント。 このイベントのデリゲート型は TypedEventHandler<TSender,TResult> です。 TSender は CoreWindow 型で、 TResult は PointerEventArgs 型です。
ResizeCompleted	ユーザーがウィンドウのサイズ変更を完了したときに発生します。
ResizeStarted	ユーザーがウィンドウのサイズ変更を開始したときに発生します。
SizeChanged	ウィンドウ サイズが変更されたときに発生します。
TouchHitTesting	タッチ接触領域が、タッチ ヒット テスト用に登録されているウィンドウの外接する四角形 (または多角形) と交差する場合に発生します。
VisibilityChanged	ウィンドウの可視性が変更されたときに発生します。

こちらもご覧ください

• CoreApplicationView
• CreateNewView(IFrameworkViewSource)
• Views
• Direct2D カスタム イメージ効果のサンプル (Windows 10)