次の方法で共有


CoreWindow クラス

定義

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

public ref class CoreWindow sealed : ICoreWindow
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 : 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 : 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 ICoreWindow
Public NotInheritable Class CoreWindow
Implements ICorePointerRedirector, ICoreWindow
継承
Object Platform::Object IInspectable CoreWindow
属性
実装

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> です。 TSenderCoreWindow 型で、 TResultKeyEventArgs 型です

KeyUp

システム以外のキーが押された後に解放されたときに発生するイベント。

このイベントのデリゲート型は TypedEventHandler<TSender,TResult> です。 TSenderCoreWindow 型で、 TResultKeyEventArgs 型です

PointerCaptureLost

ポインターが別のアプリに移動したときに発生します。 このイベントは PointerExited の後に発生し、このポインターに対してアプリによって受信される最終的なイベントです。

PointerEntered

ポインターがアプリの境界ボックスに移動したときに発生します。

PointerExited

ポインターがアプリの境界ボックスの外に移動したときに発生します。

PointerMoved

アプリの境界ボックス内でポインターが移動したときに発生します。

PointerPressed

アプリの外接する四角形内でマウス ボタンがクリックされたとき、またはデジタイザーサーフェイスが指またはペンでタッチされたときに発生します。

操作セッションは、1 つの連絡先が検出されたときに開始され、その連絡先と同じセッション内の後続のすべての連絡先が検出されなくなったときに終了します。

このイベントは、対話セッションで検出された最初の連絡先に対して発生します。 他のすべての同時連絡先ポインターの詳細は、PointerPointProperties オブジェクト (PointerPoint オブジェクトから Properties プロパティを取得することによって取得) を介して公開されます。

PointerReleased

押されたマウス ボタンが離されたとき、またはタッチまたはペンの接触がデジタイザー画面からアプリの外接する四角形内 (ポインターがキャプチャされている場合は外接する四角形の外側) に持ち上げられたときに発生します。

PointerRoutedAway

ポインターが別の入力オブジェクト (場合によっては別のプロセスで) にリダイレクトされるときに、ポインター入力を受け取る入力オブジェクトで発生します。

PointerRoutedReleased

入力オブジェクトに対して CoreIndependentInputSource.PointerReleased イベントを発生するポインターに関連付けられたが、現在入力を受信していないすべての入力オブジェクトで発生します。

PointerRoutedTo

キャプチャされたポインター入力が以前に別のオブジェクトに配信され、このオブジェクトに配信されるに遷移したときに発生します。

PointerWheelChanged

マウス ホイールが回転したときに発生するイベント。

このイベントのデリゲート型は TypedEventHandler<TSender,TResult> です。 TSenderCoreWindow 型で、 TResultPointerEventArgs 型です

ResizeCompleted

ユーザーがウィンドウのサイズ変更を完了したときに発生します。

ResizeStarted

ユーザーがウィンドウのサイズ変更を開始したときに発生します。

SizeChanged

ウィンドウ サイズが変更されたときに発生します。

TouchHitTesting

タッチ接触領域が、タッチ ヒット テスト用に登録されているウィンドウの外接する四角形 (または多角形) と交差する場合に発生します。

VisibilityChanged

ウィンドウの可視性が変更されたときに発生します。

適用対象

こちらもご覧ください