![]() |
![]() |
![]() |
libeek Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties | Signals |
EekKeyboard; struct EekKeyboardClass; EekModifierKey; guint eek_keyboard_add_outline (EekKeyboard *keyboard
,EekOutline *outline
); EekSection * eek_keyboard_create_section (EekKeyboard *keyboard
); EekKey * eek_keyboard_find_key_by_keycode (EekKeyboard *keyboard
,guint keycode
); EekModifierType eek_keyboard_get_alt_gr_mask (EekKeyboard *keyboard
); EekLayout * eek_keyboard_get_layout (EekKeyboard *keyboard
); GList * eek_keyboard_get_locked_keys (EekKeyboard *keyboard
); EekModifierBehavior eek_keyboard_get_modifier_behavior (EekKeyboard *keyboard
); EekModifierType eek_keyboard_get_modifiers (EekKeyboard *keyboard
); EekModifierType eek_keyboard_get_num_lock_mask (EekKeyboard *keyboard
); EekOutline * eek_keyboard_get_outline (EekKeyboard *keyboard
,guint oref
); GList * eek_keyboard_get_pressed_keys (EekKeyboard *keyboard
); void eek_keyboard_get_size (EekKeyboard *keyboard
,gdouble *width
,gdouble *height
); EekKeyboard * eek_keyboard_new (EekLayout *layout
,gdouble initial_width
,gdouble initial_height
); void eek_keyboard_set_alt_gr_mask (EekKeyboard *keyboard
,EekModifierType alt_gr_mask
); void eek_keyboard_set_modifier_behavior (EekKeyboard *keyboard
,EekModifierBehavior modifier_behavior
); void eek_keyboard_set_modifiers (EekKeyboard *keyboard
,EekModifierType modifiers
); void eek_keyboard_set_num_lock_mask (EekKeyboard *keyboard
,EekModifierType num_lock_mask
); void eek_keyboard_set_size (EekKeyboard *keyboard
,gdouble width
,gdouble height
);
"layout" EekLayout* : Read / Write / Construct Only "modifier-behavior" EekModifierBehavior : Read / Write
"key-cancelled" :Run Last
"key-locked" :Run Last
"key-pressed" :Run Last
"key-released" :Run Last
"key-unlocked" :Run Last
The EekKeyboardClass class represents a keyboard, which consists of one or more sections of the EekSectionClass class.
typedef struct _EekKeyboard EekKeyboard;
The EekKeyboard structure contains only private data and should only be accessed using the provided API.
struct EekKeyboardClass { EekSection *(* create_section) (EekKeyboard *self); EekKey *(* find_key_by_keycode) (EekKeyboard *self, guint keycode); /* signals */ void (* key_pressed) (EekKeyboard *self, EekKey *key); void (* key_released) (EekKeyboard *self, EekKey *key); /* signals */ void (* key_locked) (EekKeyboard *self, EekKey *key); void (* key_unlocked) (EekKeyboard *self, EekKey *key); void (* key_cancelled) (EekKeyboard *self, EekKey *key); };
virtual function for creating a section | |
virtual function for finding a key in the keyboard by keycode | |
class handler for "key-pressed" signal | |
class handler for "key-released" signal | |
class handler for "key-locked" signal | |
class handler for "key-unlocked" signal | |
class handler for "key-cancelled" signal |
typedef struct { EekModifierType modifiers; EekKey *key; } EekModifierKey;
Entry which associates modifier mask to a key. This is returned by
eek_keyboard_get_locked_keys()
.
EekModifierType |
an EekModifierType which key triggers |
EekKey * |
an EekKey |
guint eek_keyboard_add_outline (EekKeyboard *keyboard
,EekOutline *outline
);
Register an outline of keyboard
.
|
an EekKeyboard |
|
an EekOutline |
Returns : |
an unsigned integer ID of the registered outline, for later reference |
EekSection * eek_keyboard_create_section (EekKeyboard *keyboard
);
Create an EekSection instance and append it to keyboard
. This
function is rarely called by application but called by EekLayout
implementation.
|
an EekKeyboard |
EekKey * eek_keyboard_find_key_by_keycode (EekKeyboard *keyboard
,guint keycode
);
Find an EekKey whose keycode is keycode
.
|
an EekKeyboard |
|
a keycode |
Returns : |
EekKey whose keycode is keycode . [transfer none]
|
EekModifierType eek_keyboard_get_alt_gr_mask (EekKeyboard *keyboard
);
Get modifier mask used as Alt_Gr.
|
an EekKeyboard |
Returns : |
an EekModifierType |
EekLayout * eek_keyboard_get_layout (EekKeyboard *keyboard
);
Get the layout used to create keyboard
.
|
an EekKeyboard |
Returns : |
an EekLayout |
GList * eek_keyboard_get_locked_keys (EekKeyboard *keyboard
);
Get locked keys.
|
an EekKeyboard |
Returns : |
A list of locked keys. [transfer container][element-type Eek.ModifierKey] |
EekModifierBehavior eek_keyboard_get_modifier_behavior (EekKeyboard *keyboard
);
Get the modifier handling mode of keyboard
.
|
an EekKeyboard |
Returns : |
EekModifierBehavior |
EekModifierType eek_keyboard_get_modifiers (EekKeyboard *keyboard
);
Get the current modifier status of keyboard
.
|
an EekKeyboard |
Returns : |
EekModifierType |
EekModifierType eek_keyboard_get_num_lock_mask (EekKeyboard *keyboard
);
Get modifier mask used as Num_Lock.
|
an EekKeyboard |
Returns : |
an EekModifierType |
EekOutline * eek_keyboard_get_outline (EekKeyboard *keyboard
,guint oref
);
Get an outline associated with oref
in keyboard
.
|
an EekKeyboard |
|
ID of the outline |
Returns : |
an EekOutline, which should not be released |
GList * eek_keyboard_get_pressed_keys (EekKeyboard *keyboard
);
Get pressed keys.
|
an EekKeyboard |
Returns : |
A list of pressed keys. [transfer container][element-type EekKey] |
void eek_keyboard_get_size (EekKeyboard *keyboard
,gdouble *width
,gdouble *height
);
Get the size of keyboard
.
|
an EekKeyboard |
|
width of keyboard
|
|
height of keyboard
|
EekKeyboard * eek_keyboard_new (EekLayout *layout
,gdouble initial_width
,gdouble initial_height
);
Create a new EekKeyboard based on layout
.
|
an EekLayout |
|
initial width of the keyboard |
|
initial height of the keyboard |
void eek_keyboard_set_alt_gr_mask (EekKeyboard *keyboard
,EekModifierType alt_gr_mask
);
Set modifier mask used as Alt_Gr.
|
an EekKeyboard |
|
an EekModifierType |
void eek_keyboard_set_modifier_behavior (EekKeyboard *keyboard
,EekModifierBehavior modifier_behavior
);
Set the modifier handling mode of keyboard
.
|
an EekKeyboard |
|
modifier behavior of keyboard
|
void eek_keyboard_set_modifiers (EekKeyboard *keyboard
,EekModifierType modifiers
);
void eek_keyboard_set_num_lock_mask (EekKeyboard *keyboard
,EekModifierType num_lock_mask
);
Set modifier mask used as Num_Lock.
|
an EekKeyboard |
|
an EekModifierType |
void eek_keyboard_set_size (EekKeyboard *keyboard
,gdouble width
,gdouble height
);
"layout"
property"layout" EekLayout* : Read / Write / Construct Only
The layout used to create this EekKeyboard.
"modifier-behavior"
property"modifier-behavior" EekModifierBehavior : Read / Write
The modifier handling mode of EekKeyboard.
Default value: EEK_MODIFIER_BEHAVIOR_NONE
"key-cancelled"
signalvoid user_function (EekKeyboard *keyboard,
EekKey *key,
gpointer user_data) : Run Last
The ::key-cancelled signal is emitted each time a key in keyboard
is shifted to the cancelled state.
|
an EekKeyboard |
|
an EekKey |
|
user data set when the signal handler was connected. |
"key-locked"
signalvoid user_function (EekKeyboard *keyboard,
EekKey *key,
gpointer user_data) : Run Last
The ::key-locked signal is emitted each time a key in keyboard
is shifted to the locked state.
|
an EekKeyboard |
|
an EekKey |
|
user data set when the signal handler was connected. |
"key-pressed"
signalvoid user_function (EekKeyboard *keyboard,
EekKey *key,
gpointer user_data) : Run Last
The ::key-pressed signal is emitted each time a key in keyboard
is shifted to the pressed state.
|
an EekKeyboard |
|
an EekKey |
|
user data set when the signal handler was connected. |
"key-released"
signalvoid user_function (EekKeyboard *keyboard,
EekKey *key,
gpointer user_data) : Run Last
The ::key-released signal is emitted each time a key in keyboard
is shifted to the released state.
|
an EekKeyboard |
|
an EekKey |
|
user data set when the signal handler was connected. |
"key-unlocked"
signalvoid user_function (EekKeyboard *keyboard,
EekKey *key,
gpointer user_data) : Run Last
The ::key-unlocked signal is emitted each time a key in keyboard
is shifted to the unlocked state.
|
an EekKeyboard |
|
an EekKey |
|
user data set when the signal handler was connected. |