UIElement.Focus 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
嘗試將焦點設定至此項目。
public:
virtual bool Focus();
public bool Focus ();
abstract member Focus : unit -> bool
override this.Focus : unit -> bool
Public Function Focus () As Boolean
傳回
如果邏輯與鍵盤焦點設定至此項目,則為 true
,如果只有邏輯焦點設為此項目,或是呼叫此方法並未強制焦點變更,則為 false
。
實作
範例
下列範例會將焦點設定為 TextBox 所 Name 參考的 ,然後調整 游標在 內 TextBox 的位置。
void OnClickMoveToStart(object sender, RoutedEventArgs e)
{
tbPositionCursor.Focus();
tbPositionCursor.Select(0, 0);
}
Private Sub OnClickMoveToStart(ByVal sender As Object, ByVal e As RoutedEventArgs)
tbPositionCursor.Focus()
tbPositionCursor.Select(0, 0)
End Sub
備註
若要成為焦點, Focusable 而且 IsEnabled 兩者都必須是 true
。
即使元素為可焦點且有效, Focus
預覽事件仍可在特定樹狀結構中處理,而且在複合控制項) 中,可能不允許將焦點放在該元素 (。
在這種情況下,這個方法會傳 false
回 。
一般而言,焦點是由兩個不同的概念所控制:鍵盤焦點和邏輯焦點。 這兩個概念不一定相同。 如需詳細資訊,請參閱 焦點摘要 和 輸入概觀。
如果呼叫 會傳 true
Focus 回 , IsKeyboardFocused 而且 IsKeyboardFocusWithin 也是 true
。
如果相關的屬性還 true
不是 ,當您呼叫 Focus 時,會依下列順序引發一或多個下列事件: PreviewLostKeyboardFocus 、 PreviewGotKeyboardFocus (來源是新的焦點目標) 、 IsKeyboardFocusedChanged 、 IsKeyboardFocusWithinChanged 、、 LostKeyboardFocus (GotKeyboardFocus 來源是新的焦點目標) 。
為了讓此呼叫成功,應用程式中的一些其他元素先前需要有焦點。
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將推出:在 2024 年,我們將隨著內容的意見反應機制逐步淘汰 GitHub 問題,並以新的意見反應系統來取代。 如需詳細資訊,請參閱提交並檢視相關的意見反應