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