HoldingRoutedEventArgs Класс

Определение

Пространство имен:

Microsoft.UI.Xaml.Input

Предоставляет данные события для события Holding .

C#

[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HoldingRoutedEventArgs : RoutedEventArgs

Наследование

Object RoutedEventArgs HoldingRoutedEventArgs

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Примеры

Следующие фрагменты кода относятся к сценарию 1 . Входные событияпримера базовых входных данных.

C#

public Scenario1()
{
    this.InitializeComponent();

    // pointer press/release handlers
    pressedTarget.PointerPressed += new PointerEventHandler(target_PointerPressed);
    pressedTarget.PointerReleased += new PointerEventHandler(target_PointerReleased);

    // pointer enter/exit handlers
    enterExitTarget.PointerEntered += new PointerEventHandler(target_PointerEntered);
    enterExitTarget.PointerExited += new PointerEventHandler(target_PointerExited);

    // gesture handlers
    tapTarget.Tapped += new TappedEventHandler(target_Tapped);
    tapTarget.DoubleTapped += new DoubleTappedEventHandler(target_DoubleTapped);
    holdTarget.Holding += new HoldingEventHandler(target_Holding);
    holdTarget.RightTapped += new RightTappedEventHandler(target_RightTapped);
}

void target_Holding(object sender, HoldingRoutedEventArgs e)
{
    if (e.HoldingState == Windows.UI.Input.HoldingState.Started)
    {
        holdTarget.Background = new SolidColorBrush(Windows.UI.Colors.DeepSkyBlue);
        holdTargetText.Text = "Holding";
    }
    else if (e.HoldingState == Windows.UI.Input.HoldingState.Completed)
    {
        holdTarget.Background = new SolidColorBrush(Windows.UI.Colors.LightGray);
        holdTargetText.Text = "Held";
    }
    else
    {
        holdTarget.Background = new SolidColorBrush(Windows.UI.Colors.LightGray);
        holdTargetText.Text = "Hold Canceled";
    }
}

Комментарии

Событие удержания отправляется всякий раз, когда палец, перо или аналогичное указывающее устройство нажаты и удерживаются на объекте.

По истечении короткого порогового значения событие отправляется с состоянием HoldingState типа Started.

При снятии устройства (после события удержания) отправляется другое событие удержания с типом Completed (Завершено) с состоянием HoldingState.

Если пользователь отменяет удержание после запуска, но до его завершения, событие holding отправляется с состоянием HoldingState типа Canceled.

Конструкторы

HoldingRoutedEventArgs()

Инициализирует новый экземпляр класса HoldingRoutedEventArgs .

Свойства

Handled	Возвращает или задает значение, которое помечает перенаправленное событие как обработанное. Значение true для Handled предотвращает повторную обработку того же события большинством обработчиков по маршруту события.
HoldingState	Возвращает базовый объект HoldingState для взаимодействия.
OriginalSource	Возвращает ссылку на объект, вызвав которому событие. Часто это шаблонная часть элемента управления, а не элемент, объявленный в пользовательском интерфейсе приложения. (Унаследовано от RoutedEventArgs)
PointerDeviceType	Возвращает значение PointerDeviceType для устройства указателя, которое инициировало связанное событие ввода.

Методы

GetPosition(UIElement)

Возвращает координаты x и y позиции указателя, при необходимости вычисляемые по координатам источника указанного элемента UIElement.

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

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

• RoutedEventArgs
• Пример базового ввода