ContentElement 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供內容項目的 WPF 核心層級基底類別。 內容項目是專為流程樣式表示所設計，其使用直覺式標記導向配置模型以及刻意保持簡單的物件模型。
public ref class ContentElement : System::Windows::DependencyObject, System::Windows::IInputElement, System::Windows::Media::Animation::IAnimatablepublic class ContentElement : System.Windows.DependencyObject, System.Windows.IInputElement, System.Windows.Media.Animation.IAnimatabletype ContentElement = class
inherit DependencyObject
interface IInputElement
interface IAnimatablePublic Class ContentElement
Inherits DependencyObject
Implements IAnimatable, IInputElement- 繼承
- 衍生
- 實作
備註
ContentElement 定義下列常見的內容特性：
輸入：所有 ContentElement 衍生類別都支援從鍵盤、滑鼠、拖放作業、手寫筆控制項和快速鍵擷取的基本輸入擷取。
焦點：所有 ContentElement 衍生類別都可能成為焦點。 不過， (基類的預設可焦點狀態 ContentElement 為
false。如需如何讓 ContentElement 焦點成為可焦點的詳細資訊，請參閱 Focusable .) 此外，此類別包含可用來跨相關元素周遊焦點的 API。事件： ContentElement 包含與輸入和焦點相關的事件;它也包含狀態變更的事件。 在許多情況下，事件 ContentElement 都是路由事件。 在某些情況下，路由事件同時具有通道和反升路由策略，以作為個別事件引發，以回應相同的狀態或條件。 此外， ContentElement 定義可引發路由事件的 API，以及可新增或移除事件的處理常式。
ContentElement 與 UIElement 共用許多常見的 API。 這些常見的 API 不是來自共用類別繼承。 但是，它們確實會共用每個類別中常見的命名、類似的行為，以及類似的 API 內部實作。 相似性是因為 ContentElement 和 UIElement 是專案基底的每個類別，雖然每個類別都有其標記物件模型行為的不同意圖。
特別是， UIElement 會從 Visual 提供較低層級的圖形支援，將 ContentElement 轉譯為複合視窗內的矩形區域，而 ContentElement 延遲轉譯，讓檔案例更常見的概念，例如流程和包裝，更容易受到支援。 這兩個相關的類別也會實作通用介面 IInputElement 和 IAnimatable 。
繼承者的注意事項
類別 ContentElement 尚未定義流程樣式簡報完整內容專案的所有層面。 FrameworkContentElement 是 的 ContentElement 立即衍生類別。 FrameworkContentElement 包含一組更完整的其他成員，可支援 FrameworkContentElement 在內容主機內轉譯，以及使用 WPF 架構層級版面配置系統。
建構函式
| ContentElement() |
初始化 ContentElement 類別的新執行個體。 |
欄位
屬性
| AllowDrop |
取得或設定值，這個值表示這個項目是否可以作為拖放作業的目標。 |
| AreAnyTouchesCaptured |
取得值，這個值表示是否至少有一個觸控擷取至這個項目。 |
| AreAnyTouchesCapturedWithin |
取得值，這個值表示是否至少有一個觸控擷取至這個項目或其視覺化樹狀結構中的任何子項目。 |
| AreAnyTouchesDirectlyOver |
取得值，這個值表示是否至少有一個觸控在這個項目上按下。 |
| AreAnyTouchesOver |
取得值，這個值表示是否至少有一個觸控在這個項目或其視覺化樹狀結構中的任何子項目上按下。 |
| CommandBindings |
取得與這個項目關聯之 CommandBinding 物件的集合。 |
| DependencyObjectType |
取得包裝 DependencyObjectType 這個實例 CLR 型別的 。 (繼承來源 DependencyObject) |
| Dispatcher |
取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 DispatcherObject) |
| Focusable |
取得或設定元素是否能夠接收焦點的值。 |
| HasAnimatedProperties |
取得值，指出這個項目是否有任何動畫屬性。 |
| InputBindings |
取得與這個項目關聯的輸入繫結集合。 |
| IsEnabled |
取得或設定值，指出使用者介面中是否啟用這個專案， (UI) 。 |
| IsEnabledCore |
取得值，這個值會成為衍生類別中 IsEnabled 的傳回值。 |
| IsFocused |
取得值，決定這個項目是否具有邏輯焦點。 |
| IsInputMethodEnabled |
取得值，這個值表示是否已啟用輸入法系統，例如輸入法編輯器 (輸入法) ，以便處理這個專案的輸入。 |
| IsKeyboardFocused |
取得值，指出這個項目是否具有鍵盤焦點。 |
| IsKeyboardFocusWithin |
取得值，這個值表示鍵盤焦點是否在項目內或子項目內的任意處。 |
| IsMouseCaptured |
取得值，這個值表示滑鼠是否由這個項目所捕捉。 |
| IsMouseCaptureWithin |
取得值，決定滑鼠捕捉是否由這個項目或其項目樹狀結構中的子項目所保留。 |
| IsMouseDirectlyOver |
取得值，指出滑鼠指標位置是否與點擊測試結果對應，該結果會將複合項目納入考量。 |
| IsMouseOver |
取得值，這個值表示滑鼠指標是否位於這個項目上方 (包括視覺子項目或其複合控制項)。 |
| IsSealed |
取得值，這個值表示此執行個體目前是否已密封 (唯讀)。 (繼承來源 DependencyObject) |
| IsStylusCaptured |
取得值，指出是否將手寫筆擷取至這個項目。 |
| IsStylusCaptureWithin |
取得值，這個值決定手寫筆捕捉是否由這個項目 (包括子項目和複合控制項) 保有。 |
| IsStylusDirectlyOver |
取得值，指出手寫筆位置是否與點擊測試結果相對應，該結果會將複合項目納入考量。 |
| IsStylusOver |
取得值，這個值表示手寫筆是否位於這個項目上方 (包括視覺化子項目)。 |
| TouchesCaptured |
取得已擷取至這個項目的所有觸控裝置。 |
| TouchesCapturedWithin |
取得已擷取至這個項目或其視覺化樹狀結構中之任何子項目的所有觸控裝置。 |
| TouchesDirectlyOver |
取得在這個項目上停留的所有觸控裝置。 |
| TouchesOver |
取得在這個項目或其視覺化樹狀結構中之任何子項目上停留的所有觸控裝置。 |
方法
事件
| DragEnter |
輸入系統報告其下以此項目作為拖曳目標的拖曳事件時發生。 |
| DragLeave |
輸入系統報告其下以此項目作為拖曳來源的拖曳事件時發生。 |
| DragOver |
在輸入系統回報以此項目作為可能置放目標的基礎拖曳事件時發生。 |
| Drop |
輸入系統報告其下以這個項目作為置放目標的置放事件時發生。 |
| FocusableChanged |
發生於 Focusable 屬性的值變更時。 |
| GiveFeedback |
輸入系統報告其下牽涉此元素的拖放事件時發生。 |
| GotFocus |
此元素取得邏輯焦點時發生。 |
| GotKeyboardFocus |
鍵盤以此元素為焦點時發生。 |
| GotMouseCapture |
此元素擷取滑鼠時發生。 |
| GotStylusCapture |
此元素擷取手寫筆時發生。 |
| GotTouchCapture |
當觸控擷取至這個項目時發生。 |
| IsEnabledChanged |
當這個項目的 IsEnabled 屬性值變更時發生。 |
| IsKeyboardFocusedChanged |
當這個項目的 IsKeyboardFocused 屬性值變更時發生。 |
| IsKeyboardFocusWithinChanged |
當這個項目的 IsKeyboardFocusWithinChanged 屬性值變更時發生。 |
| IsMouseCapturedChanged |
當這個項目的 IsMouseCaptured 屬性值變更時發生。 |
| IsMouseCaptureWithinChanged |
當這個項目的 IsMouseCaptureWithinProperty 值變更時發生。 |
| IsMouseDirectlyOverChanged |
當這個項目的 IsMouseDirectlyOver 屬性值變更時發生。 |
| IsStylusCapturedChanged |
當這個項目的 IsStylusCaptured 屬性值變更時發生。 |
| IsStylusCaptureWithinChanged |
當這個項目的 IsStylusCaptureWithin 屬性值變更時發生。 |
| IsStylusDirectlyOverChanged |
當這個項目的 IsStylusDirectlyOver 屬性值變更時發生。 |
| KeyDown |
焦點在這個項目上方且按下按鍵時發生。 |
| KeyUp |
焦點在這個項目上方且放開按鍵時發生。 |
| LostFocus |
此元素失去邏輯焦點時發生。 |
| LostKeyboardFocus |
鍵盤不再以此元素為焦點時發生。 |
| LostMouseCapture |
此元素失去滑鼠擷取時發生。 |
| LostStylusCapture |
此元素失去手寫筆擷取時發生。 |
| LostTouchCapture |
當這個項目失去觸控擷取時發生。 |
| MouseDown |
指標在此元素上方且按下任何滑鼠按鈕時發生。 |
| MouseEnter |
滑鼠指標進入此元素的邊界時發生。 |
| MouseLeave |
滑鼠指標離開此元素的邊界時發生。 |
| MouseLeftButtonDown |
滑鼠指標在此元素上方且按下滑鼠左按鈕時發生。 |
| MouseLeftButtonUp |
滑鼠指標在此元素上方且放開滑鼠左按鈕時發生。 |
| MouseMove |
滑鼠指標在此元素上方移動時發生。 |
| MouseRightButtonDown |
滑鼠指標在此元素上方且按下滑鼠右按鈕時發生。 |
| MouseRightButtonUp |
滑鼠指標在此元素上方且放開滑鼠右按鈕時發生。 |
| MouseUp |
在此元素上方放開任何滑鼠按鈕時發生。 |
| MouseWheel |
滑鼠指標在此元素上方且使用者滾動滑鼠滾輪時發生。 |
| PreviewDragEnter |
輸入系統報告其下以此項目作為拖曳目標的拖曳事件時發生。 |
| PreviewDragLeave |
輸入系統報告其下以此項目作為拖曳來源的拖曳事件時發生。 |
| PreviewDragOver |
在輸入系統回報以此項目作為可能置放目標的基礎拖曳事件時發生。 |
| PreviewDrop |
輸入系統報告其下以這個項目作為置放目標的置放事件時發生。 |
| PreviewGiveFeedback |
拖放操作開始時發生。 |
| PreviewGotKeyboardFocus |
鍵盤以此元素為焦點時發生。 |
| PreviewKeyDown |
鍵盤以此元素為焦點且按下按鍵時發生。 |
| PreviewKeyUp |
鍵盤以此元素為焦點且放開按鍵時發生。 |
| PreviewLostKeyboardFocus |
鍵盤不再以此元素為焦點時發生。 |
| PreviewMouseDown |
指標在此元素上方且按下任何滑鼠按鈕時發生。 |
| PreviewMouseLeftButtonDown |
滑鼠指標在此元素上方且按下滑鼠左按鈕時發生。 |
| PreviewMouseLeftButtonUp |
滑鼠指標在此元素上方且放開滑鼠左按鈕時發生。 |
| PreviewMouseMove |
滑鼠指標在此元素上方且移動滑鼠指標時發生。 |
| PreviewMouseRightButtonDown |
滑鼠指標在此元素上方且按下滑鼠右按鈕時發生。 |
| PreviewMouseRightButtonUp |
滑鼠指標在此元素上方且放開滑鼠右按鈕時發生。 |
| PreviewMouseUp |
滑鼠指標在此元素上方且放開任何滑鼠按鈕時發生。 |
| PreviewMouseWheel |
滑鼠指標在此元素上方且使用者滾動滑鼠滾輪時發生。 |
| PreviewQueryContinueDrag |
拖放操作期間，鍵盤或滑鼠按鈕狀態變更時發生。 |
| PreviewStylusButtonDown |
手寫筆指標在此元素上方且按下手寫筆按鈕時發生。 |
| PreviewStylusButtonUp |
手寫筆指標在此元素上方且放開手寫筆按鈕時發生。 |
| PreviewStylusDown |
手寫筆在此項目上方且碰觸數位板時發生。 |
| PreviewStylusInAirMove |
手寫筆在項目上方移動，但沒有真正碰觸數位板時發生。 |
| PreviewStylusInRange |
手寫筆在此項目上方，且夠靠近數位板而被偵測到時發生。 |
| PreviewStylusMove |
手寫筆在項目上方移動時發生。 手寫筆必須在受到數位板偵測時移動才能引發此事件，否則會改為引發 PreviewStylusInAirMove。 |
| PreviewStylusOutOfRange |
手寫筆遠離數位板而無法被偵測到時發生。 |
| PreviewStylusSystemGesture |
使用者執行其中一種手寫筆筆勢時發生。 |
| PreviewStylusUp |
手寫筆在此項目上方，且使用者將手寫筆舉起離開數位板時發生。 |
| PreviewTextInput |
此元素以一種與裝置無關的方式取得文字時發生。 |
| PreviewTouchDown |
手指在這個項目上方且在螢幕上觸控時發生。 |
| PreviewTouchMove |
手指在這個項目上方且在螢幕上移動時發生。 |
| PreviewTouchUp |
手指在這個項目上方且離開螢幕時發生。 |
| QueryContinueDrag |
拖放操作期間，鍵盤或滑鼠按鈕狀態變更時發生。 |
| QueryCursor |
要求顯示游標時發生。 每當滑鼠指標移動至新位置時，都會引發此事件，這意謂游標物件可能會根據其新位置而變更。 |
| StylusButtonDown |
手寫筆指標在此元素上方且按下手寫筆按鈕時發生。 |
| StylusButtonUp |
手寫筆指標在此元素上方且放開手寫筆按鈕時發生。 |
| StylusDown |
手寫筆在此項目上方且碰觸數位板時發生。 |
| StylusEnter |
手寫筆進入此元素的邊界時發生。 |
| StylusInAirMove |
手寫筆在項目上方移動，但沒有真正碰觸數位板時發生。 |
| StylusInRange |
手寫筆在此項目上方，且夠靠近數位板而被偵測到時發生。 |
| StylusLeave |
手寫筆離開元素的邊界時發生。 |
| StylusMove |
當手寫筆移至此項目上方時發生。 手寫筆在數位板上必須移動才會引發這個事件。 否則，會改為引發 StylusInAirMove。 |
| StylusOutOfRange |
手寫筆在此項目上方，且遠離數位板而無法被偵測到時發生。 |
| StylusSystemGesture |
使用者執行其中一種手寫筆筆勢時發生。 |
| StylusUp |
手寫筆在此項目上方，且使用者將手寫筆舉起離開數位板時發生。 |
| TextInput |
此元素以一種與裝置無關的方式取得文字時發生。 |
| TouchDown |
手指在這個項目上方且在螢幕上觸控時發生。 |
| TouchEnter |
當觸控從這個項目的界限外部移至內部時發生。 |
| TouchLeave |
當觸控從這個項目的界限內部移至外部時發生。 |
| TouchMove |
手指在這個項目上方且在螢幕上移動時發生。 |
| TouchUp |
手指在這個項目上方且離開螢幕時發生。 |
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應