На этом шаге мы рассмотрим методы, управляющие фокусом ввода.
В один момент времени только один компонент (или вообще ни одного) может иметь фокус ввода. Для управления фокусом ввода предназначены следующие методы класса QWidget:
- setFocus ([<Причина>]) - устанавливает фокус ввода, если компонент находится в активном окне. В параметре <Причина> можно указать
причину изменения фокуса ввода в виде одного из следующих атрибутов класса Qtcore.Qt:
- MouseFocusReason (или 0) - фокус изменен с помощью мыши;
- TabFocusReason (или 1) - нажата клавиша Tab;
- BacktabFocusReason (или 2) - нажата комбинация клавиш Shift+Tab;
- ActiveWindowFocusReason (или 3) - окно стало активным или неактивным;
- PopupFocusReason (или 4) - открыто или закрыто всплывающее окно;
- ShortcutFocusReason (или 5) - нажата комбинация клавиш быстрого доступа;
- MenuBarFocusReason (или 6) - фокус изменился из-за меню;
- OtherFocusReason (или 7) - другая причина;
- clearFocus () - убирает фокус ввода с компонента;
- hasFocus () - возвращает значение True, если компонент имеет фокус ввода, и False - в противном случае;
- focusWidget () - возвращает ссылку на последний компонент, для которого вызывался метод setFocus(). Для компонентов верхнего уровня возвращается ссылка на
компонент, который получит фокус после того, как окно станет активным;
- setFocusProxy (<Qwidget>) - позволяет указать ссылку на компонент, который будет получать фокус ввода вместо текущего компонента;
- focusProxy () - возвращает ссылку на компонент, который обрабатывает фокус ввода вместо текущего компонента. Если такого компонента нет, метод возвращает значение None;
- focusNextChild () - находит следующий компонент, которому можно передать фокус, и передает фокус ему. Фактически, работает аналогично нажатию клавиши Tab.
Возвращает значение True, если компонент найден, и False - в противном случае;
- focusPreviousChild() - находит предыдущий компонент, которому можно передать фокус, и передает фокус ему. Работает аналогично нажатию комбинации клавиш
Shift+Tab. Возвращает значение True, если компонент найден, и False - в противном случае;
- focusNextPrevChild (<Флаг>) - если в параметре указано значение True, работает аналогично методу focusNextChild(),
если указано False - аналогично методу focusPreviousChild(). Возвращает значение True, если компонент найден, и False - в противном случае;
- setTabOrder (<Компонент1>, <Компонент2>) - позволяет задать последовательность смены фокуса при нажатии клавиши Tab. Метод является статическим.
В параметре <Компонент2> указывается ссылка на компонент, на который переместится фокус с компонента <Компонент1>.
Если компонентов много, то метод вызывается несколько раз.
Пример указания цепочки перехода widget1 -> widget2 -> widget3 -> widget4:
QtWidgets.QWidget.setTabOrder(widget1, widget2) QtWidgets.QWidget.setTabOrder(widget2, widget3) QtWidgets.QWidget.setTabOrder(widget3, widget4)
- setFocusPolicy (<Сnocoб>) - задает способ получения фокуса компонентом в виде одного из следующих атрибутов класса Qtcore.Qt:
- NoFocus (или 0) - компонент не может получать фокус;
- TabFocus (или 1) - получает фокус с помощью клавиши Tab;
- ClickFocus (или 2) - получает фокус с помощью щелчка мышью;
- StrongFocus (или 11) - получает фокус с помощью клавиши Tab и щелчка мышью;
- WheelFocus (или 15) - получает фокус с помощью клавиши Tab, щелчка мышью и колесика мыши;
- focusPolicy () - возвращает текущий способ получения фокуса;
- grabKeyboard () - захватывает ввод с клавиатуры. Другие компоненты не будут получать события клавиатуры, пока не будет вызван метод releaseKeyboard();
- releaseKeyboard () - освобождает захваченный ранее ввод с клавиатуры.
Получить ссылку на компонент, находящийся в фокусе ввода, позволяет статический метод focusWidget() класса QApplication. Если ни один компонент не имеет фокуса ввода, метод возвращает значение None. He путайте этот метод с одноименным методом из класса QWidget.
На следующем шаге мы закончим изучение этого вопроса. В частности, рассмотрим обработку получения и потери фокуса ввода.
