情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。
このトピックはまだ評価されていません - このトピックを評価する

DisplayRequest Class

表示要求を表します。

構文


public ref class DisplayRequest sealed 

属性

[MarshalingBehavior(None)]
[Threading(STA)]
[Version(0x06020000)]

メンバー

DisplayRequestクラス には次の種類のメンバーがあります。

コンストラクター

DisplayRequestクラス にはこれらのコンストラクターがあります。

コンストラクター説明
DisplayRequest Creates an instance of the DisplayRequest class.

 

メソッド

The DisplayRequest クラス には次のメソッドがあります。 With C#、Visual Basic、および C++ では、以下からもメソッドが継承されます。Object クラス.

メソッド説明
RequestActive Activates a display request.
RequestRelease Deactivates a display request.

 

解説

電力を節約し、バッテリ残量を延長するため、システムは一定の時間ユーザー アクティビティが検出されないと、コンピューターへの電力を減らします。システムの電源設定に応じて、まずディスプレイが暗くなり、スクリーン セーバーが表示され、最終的にシステムが低電力のスリープ状態に入ると、ディスプレイの電源が切れる場合があります。

ユーザーの入力なしで長時間実行されるかビデオを表示するアプリケーションは、DisplayRequest::RequestActive を呼び出して表示が保持されるように要求できます。表示要求がアクティブになると、デバイスのディスプレイはアプリケーションが表示されている間はオンのままです。アプリケーションをフォアグラウンドから移動する場合は、アプリケーションの表示要求を非アクティブ化し、アプリケーションがフォアグラウンドに戻ったら再アクティブ化します。

表示の要求は累積されます。各表示の要求は別個に DisplayRequest::RequestRelease を呼び出して解放する必要があります。アプリケーションは、表示を残す必要がなくなると、アクティブな表示要求の数を追跡し、すべてが解放されていることを確認します (それぞれ対応する DisplayRequest::RequestRelease を呼び出します)。詳細については、次のトピックを参照してください。

ディスプレイをオンに維持する表示要求を使用すると、多くの電力を消費します。これらのガイドラインは、表示の要求を使用するときに最適なアプリケーションの動作を得るために使用します。

  • 必要な場合にのみ表示要求を使用します。つまり、ユーザーの入力は必要ではないが、表示を残しておく場合です。たとえば、全画面表示でのプレゼンテーション中やユーザーが電子書籍を読んでいるときなどです。
  • 各表示要求を、それが必要なくなると同時に解除します。
  • アプリが中断されたときに、すべての表示要求を解除します。表示を残す必要がある場合、アプリケーションが再アクティブ化されたときに新しい表示要求を作成できます。

メモ  このクラスはアジャイルではありません。これは、そのスレッド モデルおよびマーシャリング動作を考慮する必要があることを意味しています。詳細については、「スレッド処理とマーシャリング (C++/CX)」および「Using Windows Runtime objects in a multithreaded environment (.NET) (マルチスレッド環境での Windows ランタイム オブジェクトの使用 (.NET))」を参照してください。

Windows Phone 8

この API は、ネイティブ アプリでのみサポートされます。

次のコード (累乗の表示状態のサンプルから取得) は、表示要求のアクティブ化、追跡、および解放方法を示します。

現在、コード例がないか、この言語はサポートされていません。

要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリのみ]

最小限サポートされる携帯電話

Windows Phone 8

名前空間

Windows.System.Display
Windows::System::Display [C++]

メタデータ

Windows.winmd

 

 

この情報は役に立ちましたか。
(残り 1500 文字)
フィードバックをいただき、ありがとうございました
表示:
© 2014 Microsoft. All rights reserved.