FocusManager Sınıf

Tanım

Ad Alanı:

System.Windows.Input

Bütünleştirilmiş Kod:

PresentationCore.dll

Odak kapsamlarını belirlemek ve ayarlamak ve odaklanmış öğeyi kapsam içinde ayarlamak için bir dizi statik yöntem, ekli özellik ve olay sağlar.

public ref class FocusManager abstract sealed

public static class FocusManager

type FocusManager = class

Public Class FocusManager

Devralma

Object

FocusManager

Açıklamalar

Windows Presentation Foundation'da (WPF) odakla ilgili iki kavram vardır: klavye odağı ve mantıksal odak.

Klavye odağı, şu anda klavye girişi alan öğeyle ilgilidir. Klavye odağı olan tek bir öğe olabilir. Klavye odağı olan bu öğe olarak IsKeyboardFocusedayarlanmıştırtrue. Keyboard.FocusedElement klavye odağı olan öğesini döndürür.

Mantıksal odak belirli bir odak kapsamı içinde ile FocusManager.FocusedElement ilgili.

Odak alanı, alanı içerisindeki FocusManager.FocusedElement'ı takip eden bir kapsayıcı öğedir. Varsayılan olarak, Window sınıfı , Menuve ContextMenu sınıfları gibi bir odak kapsamıdırToolBar. Odak kapsamı olan bir öğe olarak IsFocusScopeayarlanmıştırtrue.

Mantıksal odağı olan birden çok öğe olabilir, ancak tek bir odak kapsamında mantıksal odağı olan yalnızca bir öğe olabilir. Mantıksal odağı olan bir öğenin klavye odağı olması gerekmez, ancak klavye odağı olan bir öğenin mantıksal odağı olur. Odak kapsamı içinde bir odak kapsamı tanımlamak mümkündür. Bu durumda, hem üst odak kapsamı hem de alt odak kapsamı bir FocusManager.FocusedElementolabilir.

Aşağıdaki senaryoda, ile ve içeren bir olan bir WPF uygulamasında WindowTextBox klavye odağının ve Menu mantıksal odağın nasıl değiştiği gösterilmektedir MenuItem. Klavye odağı uygulamasından TextBoxMenuItemöğesine değiştiğinde TextBox , klavye odağı kaybedildiğinde, odak kapsamı için Window mantıksal odağı korur. klavye MenuItem odağını alır ve odak kapsamı için Menu mantıksal odağı alır. Klavye odağı köküne Windowdöndüğünde, mantıksal odak ile odak kapsamındaki Window öğe klavye odağını alır ve bu durumda olur TextBox. Artık TextBox klavye odağı ve mantıksal odak vardır. klavye MenuItem odağını kaybeder, ancak odak kapsamı için Menu mantıksal odağı korur.

, , IsFocusScopeve üzerindeki varsayılan değeridirWindowMenu.ToolBarContextMenutrue

Odak hakkında daha fazla bilgi için bkz. Girişe Genel Bakış ve Odaklanmaya Genel Bakış.

Alanlar

Name	Description
FocusedElementProperty	Ekli özelliği tanımlar FocusedElement .
GotFocusEvent	Ekli GotFocus olayı tanımlar.
IsFocusScopeProperty	Ekli özelliği tanımlar IsFocusScope .
LostFocusEvent	Ekli LostFocus olayı tanımlar.

İliştirilmiş Özellikler

Name	Description
FocusedElement	Bu özelliğin bağlı olduğu öğenin mantıksal odağı olup olmadığını belirler.
IsFocusScope	Bu özelliğin ekli olduğu öğenin bir odak kapsamı olup olmadığını belirler.

Yöntemler

Name	Description
AddGotFocusHandler(DependencyObject, RoutedEventHandler)	Ekli olay için GotFocus bir işleyici ekler.
AddLostFocusHandler(DependencyObject, RoutedEventHandler)	Ekli olay için LostFocus bir işleyici ekler.
GetFocusedElement(DependencyObject)	Belirtilen odak kapsamında mantıksal odağı olan öğesini alır.
GetFocusScope(DependencyObject)	olarak ayarlanmış IsFocusScopebelirtilen öğenin true en yakın üst öğesini belirler.
GetIsFocusScope(DependencyObject)	Belirtilenin DependencyObject bir odak kapsamı olup olmadığını belirler.
RemoveGotFocusHandler(DependencyObject, RoutedEventHandler)	Ekli olay için bir işleyici kaldırır GotFocus .
RemoveLostFocusHandler(DependencyObject, RoutedEventHandler)	Ekli olay için bir işleyici kaldırır LostFocus .
SetFocusedElement(DependencyObject, IInputElement)	Mantıksal odağı belirtilen öğeye ayarlar.
SetIsFocusScope(DependencyObject, Boolean)	Belirtileni DependencyObject odak kapsamı olarak ayarlar.

İliştirilmiş Olaylar

Name	Description
GotFocus	Bir öğe odak aldığında gerçekleşir.
LostFocus	Bir öğe odağı kaybettiğinde gerçekleşir.