EekKey

EekKey — Base class of a key

Functions

Properties

int column Read / Write
guint keycode Read / Write
gulong oref Read / Write
int row Read / Write
EekSymbolMatrix * symbol-matrix Read / Write

Signals

void cancelled Run Last
void locked Run First
void pressed Run First
void released Run Last
void unlocked Run Last

Types and Values

  EekKey
struct EekKeyClass

Object Hierarchy

    GObject
    ╰── EekElement
        ╰── EekKey

Description

The EekKeyClass class represents a key.

Functions

eek_key_get_index ()

void
eek_key_get_index (EekKey *key,
                   gint *column,
                   gint *row);

Get the location of key in EekSection.

Parameters

key

an EekKey

 

column

pointer where the column index of key in EekSection will be stored.

[allow-none]

row

pointer where the row index of key in EekSection will be stored.

[allow-none]

eek_key_get_keycode ()

guint
eek_key_get_keycode (EekKey *key);

Get keycode of key .

Parameters

key

an EekKey

 

Returns

keycode or EEK_INVALID_KEYCODE on failure


eek_key_get_oref ()

guint
eek_key_get_oref (EekKey *key);

Get the outline id of key .

Parameters

key

an EekKey

 

Returns

unsigned integer


eek_key_get_symbol ()

EekSymbol *
eek_key_get_symbol (EekKey *key);

Get the current symbol of key .

Parameters

key

an EekKey

 

Returns

the current EekSymbol or NULL on failure.

[transfer none]


eek_key_get_symbol_at_index ()

EekSymbol *
eek_key_get_symbol_at_index (EekKey *key,
                             gint group,
                             gint level,
                             gint fallback_group,
                             gint fallback_level);

Get the symbol at (group , level ) in the symbol matrix of key .

Parameters

key

an EekKey

 

group

group index of the symbol matrix

 

level

level index of the symbol matrix

 

fallback_group

fallback group index

 

fallback_level

fallback level index

 

Returns

an EekSymbol at (group , level ), or NULL.

[transfer none]


eek_key_get_symbol_matrix ()

EekSymbolMatrix *
eek_key_get_symbol_matrix (EekKey *key);

Get the symbol matrix of key .

Parameters

key

an EekKey

 

Returns

EekSymbolMatrix or NULL.

[transfer none]


eek_key_get_symbol_with_fallback ()

EekSymbol *
eek_key_get_symbol_with_fallback (EekKey *key,
                                  gint fallback_group,
                                  gint fallback_level);

Get the current symbol of key .

Parameters

key

an EekKey

 

fallback_group

fallback group index

 

fallback_level

fallback level index

 

Returns

the current EekSymbol or NULL on failure.

[transfer none]


eek_key_is_locked ()

gboolean
eek_key_is_locked (EekKey *key);

Return TRUE if key is marked as locked.

Parameters

key

an EekKey

 

eek_key_is_pressed ()

gboolean
eek_key_is_pressed (EekKey *key);

Return TRUE if key is marked as pressed.

Parameters

key

an EekKey

 

eek_key_set_index ()

void
eek_key_set_index (EekKey *key,
                   gint column,
                   gint row);

Set the location of key in EekSection with column and row .

Parameters

key

an EekKey

 

column

column index of key in EekSection

 

row

row index of key in EekSection

 

eek_key_set_keycode ()

void
eek_key_set_keycode (EekKey *key,
                     guint keycode);

Set the keycode of key to keycode . Since typically the keycode value is used to find a key in a keyboard by calling eek_keyboard_find_key_by_keycode, it is not necessarily the same as the X keycode but it should be unique in the keyboard key belongs to.

Parameters

key

an EekKey

 

keycode

keycode

 

eek_key_set_oref ()

void
eek_key_set_oref (EekKey *key,
                  guint oref);

Set the outline id of key to oref .

Parameters

key

an EekKey

 

oref

outline id of key

 

eek_key_set_symbol_matrix ()

void
eek_key_set_symbol_matrix (EekKey *key,
                           EekSymbolMatrix *matrix);

Set the symbol matrix of key to matrix .

Parameters

key

an EekKey

 

matrix

an EekSymbolMatrix

 

Types and Values

EekKey

typedef struct _EekKey EekKey;

The EekKey structure contains only private data and should only be accessed using the provided API.


struct EekKeyClass

struct EekKeyClass {
    /* signals */
    void (* pressed)   (EekKey *key);
    void (* released)  (EekKey *key);
    void (* locked)    (EekKey *key);
    void (* unlocked)  (EekKey *key);
    void (* cancelled) (EekKey *key);
};

Members

pressed ()

class handler for “pressed” signal

 

released ()

class handler for “released” signal

 

locked ()

class handler for “locked” signal

 

unlocked ()

class handler for “unlocked” signal

 

cancelled ()

class handler for “cancelled” signal

 

Property Details

The “column” property

  “column”                   int

The column index of EekKey in the parent EekSection.

Owner: EekKey

Flags: Read / Write

Allowed values: >= -1

Default value: -1


The “keycode” property

  “keycode”                  guint

The keycode of EekKey.

Owner: EekKey

Flags: Read / Write

Default value: 0


The “oref” property

  “oref”                     gulong

The outline id of EekKey.

Owner: EekKey

Flags: Read / Write


The “row” property

  “row”                      int

The row index of EekKey in the parent EekSection.

Owner: EekKey

Flags: Read / Write

Allowed values: >= -1

Default value: -1


The “symbol-matrix” property

  “symbol-matrix”            EekSymbolMatrix *

The symbol matrix of EekKey.

Owner: EekKey

Flags: Read / Write

Signal Details

The “cancelled” signal

void
user_function (EekKey  *key,
               gpointer user_data)

The ::cancelled signal is emitted each time key is shifted to the cancelled state.

Parameters

key

an EekKey

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last


The “locked” signal

void
user_function (EekKey  *key,
               gpointer user_data)

The ::locked signal is emitted each time key is shifted to the locked state. The class handler runs before signal handlers to allow signal handlers to read the status of key with eek_key_is_locked().

Parameters

key

an EekKey

 

user_data

user data set when the signal handler was connected.

 

Flags: Run First


The “pressed” signal

void
user_function (EekKey  *key,
               gpointer user_data)

The ::pressed signal is emitted each time key is shifted to the pressed state. The class handler runs before signal handlers to allow signal handlers to read the status of key with eek_key_is_pressed().

Parameters

key

an EekKey

 

user_data

user data set when the signal handler was connected.

 

Flags: Run First


The “released” signal

void
user_function (EekKey  *key,
               gpointer user_data)

The ::released signal is emitted each time key is shifted to the released state.

Parameters

key

an EekKey

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last


The “unlocked” signal

void
user_function (EekKey  *key,
               gpointer user_data)

The ::unlocked signal is emitted each time key is shifted to the unlocked state.

Parameters

key

an EekKey

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last