DisplayRequest Class

표시 요청을 나타냅니다.

구문


public ref class DisplayRequest sealed 

특성

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

멤버

DisplayRequest클래스에는 다음과 같은 형식의 멤버가 있습니다.

생성자

DisplayRequest클래스에는 다음과 같은 생성자가 있습니다.

생성자Description
DisplayRequest Creates an instance of the DisplayRequest class.

 

메서드

The DisplayRequest 클래스 - 이러한 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음 위치의 메서드도 상속합니다. Object 클래스.

메서드Description
RequestActive Activates a display request.
RequestRelease Deactivates a display request.

 

설명

전원을 절약하고 배터리 수명을 연장하기 위해 특정 시간 동안 사용자 활동이 감지되지 않는 경우 시스템은 컴퓨터 전원을 줄입니다. 시스템 전원 설정에 따라 디스플레이가 우선 흐려진 다음 화면 보호기가 표시된 후 시스템이 절전 대기 상태로 전환되면서 꺼질 수 있습니다.

사용자 입력 없이 오래 동안 동영상을 표시하거나 실행되는 앱은 DisplayRequest::RequestActive를 호출하여 표시가 유지되도록 요청할 수 있습니다. 디스플레이 요청이 활성화되면 장치 디스플레이는 앱이 표시되어 있는 동안 계속 켜져 있습니다. 사용자가 포그라운드에서 앱을 이동하면 시스템은 앱의 표시 요청을 비활성화한 후 앱이 포그라운드로 돌아가는 경우 다시 활성화합니다.

디스플레이 요청은 누적되므로 각 디스플레이 요청을 DisplayRequest::RequestRelease에 대한 별도 호출로 해제해야 합니다. 앱은 활성 표시 요청 수를 추적하고 앱에서 더 이상 표시를 유지할 필요가 없으면 모든 표시가 해제되었는지(DisplayRequest::RequestRelease에 해당 호출이 있는 각 표시) 확인해야 합니다. 자세한 내용은 다음을 참조하십시오.

디스플레이 요청을 사용하여 디스플레이에서 계속 많은 전원을 소모합니다. 디스플레이 요청을 사용할 때 최상의 앱 동작을 위해 이 지침을 사용합니다.

  • 사용자 입력이 예상되지 않지만 디스플레이를 켜 두어야 하는 필요할 때만 디스플레이 요청을 사용합니다. 예를 들어 전체 화면 프레젠테이션 도중 또는 사용자가 전자책을 읽는 때입니다.
  • 더 이상 필요하지 않으면 각 표시 요청을 즉시 해제합니다.
  • 앱이 일시 중단되었을 때 모든 표시 요청을 해제합니다. 디스플레이를 계속 켜 두어야 할 경우 디스플레이가 비활성화되면 앱에서 새 디스플레이 요청을 만들 수 있습니다.

참고  클래스는 Agile 클래스가 아닙니다. 즉, 이 클래스의 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX)다중 스레드 환경에서 Windows 런타임 개체 사용(.NET)을 참조하십시오.

Windows Phone 8

이 API는 네이티브 앱에서만 지원됩니다.

예제

디스플레이 전원 상태 샘플에서 발췌한 다음 코드는 표시 요청을 활성화, 추적 및 해제하는 방법을 보여 줍니다.

현재 사용할 수 있는 코드 예가 없거나 이 언어가 지원되지 않습니다.

요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱만]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱만]

지원되는 최소 전화

Windows Phone 8

Namespace

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

Metadata

Windows.winmd

 

 

표시:
© 2014 Microsoft