CharacterReceivedEventArgs 클래스

정의

네임스페이스:

Windows.UI.Core

입력 큐에서 문자를 받을 때 발생하는 이벤트에서 반환되는 인수를 제공합니다.

public ref class CharacterReceivedEventArgs sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class CharacterReceivedEventArgs final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class CharacterReceivedEventArgs

Public NotInheritable Class CharacterReceivedEventArgs

상속

Object Platform::Object IInspectable CharacterReceivedEventArgs

특성

ContractVersionAttribute MarshalingBehaviorAttribute

구현

ICoreWindowEventArgs

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

Windows 10앱은 IME(입력 방법 편집기)가 사용하도록 설정된 경우 이 이벤트를 수신하지 않습니다. IME(입력 방법 편집기)는 모든 키보드 입력을 처리하고 Handled를true로 설정합니다.

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

이 개체는 다음 이벤트에 대해 등록된 대리자에서 반환됩니다.

• CoreWindow.CharacterReceived

void SetWindow(CoreWindow const& window)
{
    ...
    window.CharacterReceived({this, &App::OnCharacterReceived });
}

// Character received event data in CharacterReceivedEventArgs.
void OnCharacterReceived(
    Windows::UI::Core::CoreWindow const& /* sender */,
    Windows::UI::Core::CharacterReceivedEventArgs const& /* args */)
{
}

// returning character received events data through CharacterReceivedEventArgs

void MyCoreWindowEvents::SetWindow( // implementation called by CoreApplication::Run(), provided for context
    _In_ CoreWindow^ window
    )
{
    // ...
    window->CharacterReceived +=
        ref new TypedEventHandler<CoreWindow^, CharacterReceivedEventArgs^>(this, &CoreWindowEvents::OnCharacterReceived);
    // ...
}

참고

이 클래스는 민첩하지 않으므로 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX)을 참조하세요.

속성

Handled	문자 수신 이벤트가 처리되었는지 여부를 가져오거나 설정합니다.
KeyCode	입력 큐에서 받은 문자의 키 코드를 가져옵니다.
KeyStatus	문자 수신 이벤트를 발생시킨 물리적 키 누름의 상태 가져옵니다.

추가 정보

• CharacterReceived