File: ZDefaultWidgetManager.rst

package info (click to toggle)
tuiwidgets 0.2.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 16,852 kB
  • sloc: cpp: 70,959; python: 655; sh: 39; makefile: 24
file content (33 lines) | stat: -rw-r--r-- 1,250 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
.. _ZDefaultWidgetManager:

ZDefaultWidgetManager
=====================

In dialogs there is often a default widget that can be activated even if focus is on another widget using :kbd:`Enter`.
This facet of the dialog window widget is used to coordinate this.

Implementations of this facet stores a pointer to the default widget and implement logic to determine if the
default widget is active and will receive :kbd:`Enter` events or if the focused widget will handle the :kbd:`Enter` key.

See also: :cpp:class:`Tui::ZBasicDefaultWindowManager`

.. rst-class:: tw-facet
.. cpp:class:: Tui::ZDefaultWidgetManager : public QObject

   Policy facet for default widget handling.

   .. rst-class:: tw-pure-virtual
   .. cpp:function:: void setDefaultWidget(ZWidget *w)

      Saves the given widget ``w`` as the default widget for the dialog.

   .. rst-class:: tw-pure-virtual
   .. cpp:function:: ZWidget *defaultWidget() const

      Returns the current default widget of the dialog if any, or :cpp:expr:`nullptr`.

   .. rst-class:: tw-pure-virtual
   .. cpp:function:: bool isDefaultWidgetActive() const

      Determines if given the currently focused widget and possibly other state if the default widget will handle the
      :kbd:`Enter` key.