다음을 통해 공유


CharacterReceivedEventArgs 클래스

정의

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

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
특성
구현

Windows 요구 사항

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

설명

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

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

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

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

문자 수신 이벤트를 발생시킨 물리적 키 누름의 상태 가져옵니다.

적용 대상

추가 정보