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 kapsam içindeki odaklanmış öğeyi ayarlamak için statik yöntemler, ekli özellikler ve olaylar kümesi 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 'de (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 trueayarlanmıştırIsKeyboardFocused. Keyboard.FocusedElement klavye odağı olan öğeyi döndürür.

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

Odak kapsamı, kapsamındaki öğesini FocusManager.FocusedElement izleyen bir kapsayıcı öğesidir. Varsayılan olarak, Window sınıfı , ContextMenuve ToolBar sınıfları gibi bir odak kapsamıdırMenu. Odak kapsamı olan bir öğe olarak trueayarlanmıştırIsFocusScope.

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 senaryo, ile ve içeren bir içeren wpf uygulamasında WindowTextBox klavye odağının ve Menu mantıksal odağın MenuItemnasıl değiştiğini gösterir. Klavye odağı'ndan TextBoxMenuItemöğesine değiştiğinde TextBox , klavye odağı kaybedildiğinde ancak 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, odak kapsamındaki mantıksal odaklı öğe Window klavye odağını alır ve bu durumda TextBoxda olur. Artık TextBox klavye odağı ve mantıksal odak vardır. Klavye MenuItem odağı kaybolur, ancak odak kapsamı için Menu mantıksal odağı korur.

, , ToolBarMenuve ContextMenu üzerindeki Windowvarsayılan değeri IsFocusScope şeklindedirtrue.

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

Alanlar

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

İliştirilmiş Özellikler

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

Yöntemler

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ış truebelirtilen öğenin IsFocusScope en yakın üst öğesini belirler.
GetIsFocusScope(DependencyObject)	Belirtilenin DependencyObject bir odak kapsamı olup olmadığını belirler.
RemoveGotFocusHandler(DependencyObject, RoutedEventHandler)	Ekli olay için GotFocus bir işleyici kaldırır.
RemoveLostFocusHandler(DependencyObject, RoutedEventHandler)	Ekli olay için LostFocus bir işleyici kaldırır.
SetFocusedElement(DependencyObject, IInputElement)	Mantıksal odağı belirtilen öğeye ayarlar.
SetIsFocusScope(DependencyObject, Boolean)	Belirtilen DependencyObject öğesini odak kapsamı olarak ayarlar.

İliştirilmiş Olaylar

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