UIElement.ManipulationStarting 事件

  • 參考

定義

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

發生於第一次建立操作處理器時。

public:
 virtual event ManipulationStartingEventHandler ^ ManipulationStarting;
// Register
event_token ManipulationStarting(ManipulationStartingEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::ManipulationStarting_revoker ManipulationStarting(auto_revoke_t, ManipulationStartingEventHandler const& handler) const;
public event ManipulationStartingEventHandler ManipulationStarting;
function onManipulationStarting(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationstarting", onManipulationStarting);
uIElement.removeEventListener("manipulationstarting", onManipulationStarting);
- or -
uIElement.onmanipulationstarting = onManipulationStarting;
Public Custom Event ManipulationStarting As ManipulationStartingEventHandler 
<uiElement ManipulationStarting="eventhandler"/>

事件類型

ManipulationStartingEventHandler

備註

如需自訂控制項和互動體驗，請參閱 GestureRecognizer。

元素必須具有或 System 以外的 NoneManipulationMode值，才能成為操作事件來源。 的 ManipulationMode 預設值是 System ，可讓內建控制項邏輯處理操作，但不允許應用程式程式碼處理操作事件。 如果您想要處理操作，請將 設定 ManipulationMode 為 All 或特定的 ManipulationModes 值。 如需詳細資訊，請參閱 ManipulationMode。

ManipulationStarting 基本上，每當指標與元素啟用操作的專案互動時，就會引發 。 這包括將操作解譯為手勢，而指標永遠不會移動的情況，例如 點選 或 按住 手勢。 如果指標確實移動， ManipulationStarted 通常會在之後引發。

ManipulationStarting 是路由事件。 如果事件因為未處理而允許反升至父元素，則即使 ManipulationMode 為 None 或 System 父元素，也可以處理父元素上的事件。 如需路由事件概念的詳細資訊，請參閱 事件和路由事件概觀。

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

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

適用於

另請參閱