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