UIElement.DoubleTapped 事件

  • 參考

定義

命名空間:
Microsoft.UI.Xaml
編輯

發生于在此元素的點擊測試區域上發生未處理的 DoubleTap 互動時。

public:
 virtual event DoubleTappedEventHandler ^ DoubleTapped;
// Register
event_token DoubleTapped(DoubleTappedEventHandler const& handler) const;

// Revoke with event_token
void DoubleTapped(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::DoubleTapped_revoker DoubleTapped(auto_revoke_t, DoubleTappedEventHandler const& handler) const;
public event DoubleTappedEventHandler DoubleTapped;
function onDoubleTapped(eventArgs) { /* Your code */ }
uIElement.addEventListener("doubletapped", onDoubleTapped);
uIElement.removeEventListener("doubletapped", onDoubleTapped);
- or -
uIElement.ondoubletapped = onDoubleTapped;
Public Custom Event DoubleTapped As DoubleTappedEventHandler 
<uiElement DoubleTapped="eventhandler"/>

事件類型

DoubleTappedEventHandler

備註

DoubleTap互動只是兩個快速連續發生的點選互動。 系統透過系統設定將系統解譯為雙點選的確切時間可由使用者調整。

如需如何在應用程式設計中使用DoubleTap互動的詳細資訊，請參閱觸控互動設計。

如果使用者互動也會引發 ，則點選會先引發 DoubleTapped 來代表第一個點選，但第二個點選不會引發額外的 Tapped 。 如果您想要與 不同的邏輯 TappedDoubleTapped ，則 Tapped 處理常式可能需要使用應用程式特定的變數和計時器，以避免在最終解譯為 DoubleTap 動作的互動上執行。

事件 DoubleTapped 代表手勢， 而 PointerPressed 事件則是較低層級的輸入事件。 DoubleTapped 和 PointerPressed 事件可能會因為單一使用者互動而引發。 即使控制項已經處理控制項邏輯中的指標事件，或正在處理操作，也不會防止 DoubleTapped 引發。

事件 DoubleTapped 可能是多個指標點的結果。 對於較高層級的手勢事件，例如 DoubleTapped ，您不再需要立即存取 PointerPoint 詳細資料，例如個別 PointerId 值或個別座標。 您可以存取裝置類型 (PointerDeviceType) ，而您可以呼叫 GetPosition的座標，這會從多個指標點提供 DoubleTap 的座標平均值。

DoubleTapped 是路由事件。 此外，元素必須有 IsDoubleTapEnabled 成為 trueDoubleTapped 事件來源， (true 為預設) 。 即使位於父元素上，也可以處理 DoubleTapped 父元素，如果事件從事件來源子專案泡泡到父元素，其中 是 falseIsDoubleTapEnabled 。 falseIsDoubleTapEnabled 如需路由事件概念的詳細資訊，請參閱 事件和路由事件概觀。

對於觸控動作以及因為觸控動作而引發的互動特定或操作事件，元素必須具有點擊測試可見性，才能成為事件來源並引發與動作相關聯的事件。 UIElement.Visibility 必須是 可見的。 衍生型別的其他屬性也會影響點擊測試可見度。 如需詳細資訊，請參閱事件與路由事件概觀。

DoubleTapped 支援將事件處理常式附加至將叫用的路由的能力，即使事件的事件資料標示為 Handled也一樣。 請參閱 AddHandler。

特定Windows 執行階段控制項可能會有 DoubleTapped 輸入事件的類別型處理。 如果是，控制項可能具有 OnDoubleTapped方法的覆寫。 一般而言，事件會標示為由類別處理常式處理，而且 DoubleTapped 該控制項上的任何使用者程式碼處理常式都不會引發 事件來處理。 如需事件類別型處理運作方式的詳細資訊，請參閱 事件和路由事件概觀。

適用於

另請參閱