Прочитать на английском

Поделиться через


ContentElement.Focus Метод

Определение

Попытка задать фокус для данного элемента.

C#
public bool Focus();

Возвращаемое значение

true если элемент может получить клавиатурный фокус; false если в результате вызова данного метода элемент фокус не получил.

Реализации

Примеры

В следующем примере показан обработчик событий с загрузкой страницы, который находит указанный именованный абзац в документе и устанавливает фокус на него. Абзацы по умолчанию не фокусируются; этот конкретный абзац имеет примененный (не показанный) стиль, который использовал стиль Setter , чтобы сделать его фокусируемым.

C#
void FocusOnParagraph(object sender, RoutedEventArgs e)
{
  ContentElement ce = this.FindName("focusableP") as ContentElement;
  ce.Focus();
}

Комментарии

Чтобы быть фокусируемым, Focusable и IsEnabled оба должны иметь значение true. Обратите внимание, что по ContentElement умолчанию не Focusable все производные классы.

Даже если элемент доступен для фокусировки и включен, обработка событий в определенном дереве (например, для составного элемента управления) может реагировать на события фокуса предварительного просмотра, не разрешая фокус, поэтому этот метод возвращает false.

Фокус в целом регулируется двумя отдельными понятиями: фокусом клавиатуры и логическим фокусом, которые не всегда идентичны. Этот метод задает логический фокус. Нет никаких программных средств для настройки фокуса клавиатуры; фокус клавиатуры определяется введенными пользователем данными. Дополнительные сведения см. в разделах Общие сведения о фокусе и Общие сведения о входных данных.

Если вызов Focus возвращает , IsKeyboardFocusedtrueи IsKeyboardFocusWithin также trueимеют значение .

Если связанные свойства еще trueне имеют значения , при вызове Focusвызывается одно или несколько из следующих событий в следующем порядке: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (источник — новый целевой объект фокуса), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (источник — это новый целевой объект фокуса).

Применяется к

Продукт Версии
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

См. также раздел