Поделиться через


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

Возвращает состояние физического нажатия клавиши, вызвавшей событие, полученное символом.

Применяется к

См. также раздел