![]() |
![]() |
![]() |
Mx Toolkit Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Known Implementations |
enum MxFocusDirection; enum MxFocusHint; MxFocusable; struct MxFocusableIface; MxFocusable * mx_focusable_move_focus (MxFocusable *focusable
,MxFocusDirection direction
,MxFocusable *from
); MxFocusable * mx_focusable_accept_focus (MxFocusable *focusable
,MxFocusHint hint
); MxFocusHint mx_focus_hint_from_direction (MxFocusDirection direction
);
MxFocusable is implemented by MxBin, MxBoxLayout, MxButton, MxComboBox, MxDialog, MxEntry, MxExpander, MxFrame, MxItemView, MxKineticScrollView, MxListView, MxMenu, MxNotebook, MxOffscreen, MxPathBar, MxScrollBar, MxScrollView, MxSlider, MxStack, MxTable, MxToolbar and MxViewport.
typedef enum { MX_FOCUS_DIRECTION_OUT, MX_FOCUS_DIRECTION_UP, MX_FOCUS_DIRECTION_DOWN, MX_FOCUS_DIRECTION_LEFT, MX_FOCUS_DIRECTION_RIGHT, MX_FOCUS_DIRECTION_NEXT, MX_FOCUS_DIRECTION_PREVIOUS } MxFocusDirection;
typedef enum { MX_FOCUS_HINT_FIRST, MX_FOCUS_HINT_LAST, MX_FOCUS_HINT_PRIOR, MX_FOCUS_HINT_FROM_ABOVE, MX_FOCUS_HINT_FROM_BELOW, MX_FOCUS_HINT_FROM_LEFT, MX_FOCUS_HINT_FROM_RIGHT } MxFocusHint;
typedef struct _MxFocusable MxFocusable;
This is an opaque structure whose members cannot be directly accessed.
struct MxFocusableIface { GObjectClass parent_class; MxFocusable* (*accept_focus) (MxFocusable *focusable, MxFocusHint hint); MxFocusable* (*move_focus) (MxFocusable *focusable, MxFocusDirection direction, MxFocusable *from); };
MxFocusable * mx_focusable_move_focus (MxFocusable *focusable
,MxFocusDirection direction
,MxFocusable *from
);
Move the focus
|
A MxFocusable |
|
A MxFocusDirection |
|
focusable to move the focus from |
Returns : |
the newly focused focusable. [transfer none] |
MxFocusable * mx_focusable_accept_focus (MxFocusable *focusable
,MxFocusHint hint
);
Accept the focus
|
A MxFocusable |
|
A MxFocusHint |
Returns : |
the focusable. [transfer none] |
MxFocusHint mx_focus_hint_from_direction (MxFocusDirection direction
);
Transforms a focus direction to a focus hint. This is a convenience
function for actors that implement the MxFocusable interface, to
pass the correct MxFocusHint to their children when calling
mx_focusable_accept_focus()
.
MX_FOCUS_DIRECTION_UP
maps to MX_FOCUS_HINT_FROM_BELOW
,
MX_FOCUS_DIRECTION_DOWN
maps to MX_FOCUS_HINT_FROM_ABOVE
,
MX_FOCUS_DIRECTION_LEFT
maps to MX_FOCUS_HINT_FROM_RIGHT
,
MX_FOCUS_DIRECTION_RIGHT
maps to MX_FOCUS_HINT_FROM_LEFT
,
MX_FOCUS_DIRECTION_NEXT
maps to MX_FOCUS_HINT_FIRST
,
MX_FOCUS_DIRECTION_PREVIOUS
maps to MX_FOCUS_HINT_LAST
and
anything else maps to MX_FOCUS_HINT_PRIOR
.
|
A MxFocusDirection |
Returns : |
A MxFocusHint |
Since 1.2