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 互動就是快速連續發生的兩次 Tap 互動。 系統判定為雙重點擊的確切時間，使用者可透過系統設定調整。

關於如何在應用程式設計中使用 DoubleTap 互動的更多資訊，請參閱觸控互動設計。

如果使用者互動也觸發 DoubleTapped， Tapped 會先觸發，代表第一次點擊，但第二次點擊不會觸發額外的 Tapped點擊。 如果你想要對 versus DoubleTapped有不同的邏輯Tapped，處理器Tapped可能需要使用應用程式專屬變數和計時器，以避免在最終被解讀為 DoubleTap 動作的互動上執行。

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

事件 DoubleTapped 可能是多個指標點的結果。 對於像你這類高階手勢事件 DoubleTapped ，已經無法立即存取 PointerPoint 的細節，例如個別 PointerId 值或個別座標。 你可以存取裝置類型（PointerDeviceType），對於座標你可以呼叫 GetPosition，它會得到來自多個指標點的 DoubleTap 座標平均值。

DoubleTapped 是路由事件。 此外，元素必須有 IsDoubleTapEnabled 為 true 事件 DoubleTapped 來源（true 預設為 ）。 即使 IsDoubleTapEnabled 在父元素上，false若事件從事件來源子元素冒泡到父元素，且 IsDoubleTapEnabled 是 false，仍可處理DoubleTapped父元素。 欲了解更多路由事件概念，請參閱 事件與路由事件總覽。

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

DoubleTapped 支援即使事件資料標記 為已處理，也能將事件處理器附加到將被呼叫的路由上。 請參見 AddHandler。

特定的 Windows 執行階段 控制項可能對輸入事件採取類別式處理DoubleTapped。 如果是這樣，控制項大概有覆蓋 OnDoubleTapped 的方法。 通常該事件會被類別處理器標記為已處理，且 DoubleTapped 該事件不會被該控制項上的使用者程式碼處理器來處理。 關於基於類別的事件處理方式，請參閱 事件與路由事件總覽。

適用於

另請參閱