UIElement.PointerReleased 事件

  • 參考

定義

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

發生于先前起始 按下 動作的指標裝置放開時，同時在此元素內。 請注意， 按下動作的 結尾不保證會引發 PointerReleased 事件;其他事件可能會改為引發。 如需詳細資訊，請參閱。

public:
 virtual event PointerEventHandler ^ PointerReleased;
// Register
event_token PointerReleased(PointerEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::PointerReleased_revoker PointerReleased(auto_revoke_t, PointerEventHandler const& handler) const;
public event PointerEventHandler PointerReleased;
function onPointerReleased(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerreleased", onPointerReleased);
uIElement.removeEventListener("pointerreleased", onPointerReleased);
- or -
uIElement.onpointerreleased = onPointerReleased;
Public Custom Event PointerReleased As PointerEventHandler 
<uiElement PointerReleased="eventhandler"/>

事件類型

PointerEventHandler

備註

觸控、滑鼠和手寫筆/手寫筆互動會在應用程式中接收、處理及管理為指標輸入。 這些互動中的任何一個 PointerReleased 都可以產生事件。 如需詳細資訊，請參閱 處理指標輸入。

其他事件 PointerReleased 可能會引發動作結尾，例如 PointerCanceled 或 PointerCaptureLost。 請勿依賴 PointerPressed ，而且 PointerReleased 事件一律以配對方式發生。 若要正常運作，您的應用程式必須接聽並處理代表 按下 動作可能結論的所有事件。 您可能會收到下列其中一 PointerReleased 些原因：

  • 特定硬體如何處理觸控動作和 按下 動作的差異
  • 從不同指標擷取程式設計指標
  • 變更顯示區域關聯性的使用者動作，例如變更解析度或監視設定
  • 輸入互動，例如觸控與先前觸控動作相同表面的手寫筆

一開始引發 PointerReleased 事件的使用者動作可能會導致 Tapped 事件，或也可能在 RightTapped 每部裝置不同的情況下產生。 如需詳細資訊，請參閱 點選 和 RightTapped。

滑鼠輸入會與第一次偵測到滑鼠輸入時指派的單一指標相關聯。 按一下滑鼠按鈕 (左鍵、滾輪或右鍵) 會透過 PointerPressed 事件建立指標與該按鈕的次要關聯。 PointerReleased只有在釋放相同的滑鼠按鍵 (沒有其他按鈕可以與指標相關聯時，才會引發事件，直到此事件完成) 為止。 由於這個專屬關聯的關係，其他滑鼠按鈕的按一下都會經由 PointerMoved 事件進行路由。 您可以在處理此事件時測試滑鼠按鍵狀態，如下列範例所示。

PointerReleased 是路由事件。 如需路由事件概念的詳細資訊，請參閱 事件和路由事件概觀。

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

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

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

控制項也可能有 PointerUpThemeAnimation 個人化動畫，與事件無關。

適用於

另請參閱