Method

RotulusReactionsadd

Declaration [src]

void
rotulus_reactions_add (
  RotulusReactions* self,
  const char* key,
  guint count,
  gboolean mine,
  const char* label
)

Description [src]

Adds a chip after those already added. A NULL key, or one that isn’t UTF-8, is left out now, since the key is the reaction’s identity and comes back as it was given; a label that isn’t is read with its bad bytes replaced. A key that is empty, too long, holds a line break, or repeats an earlier one is left out when the reactions are set, and so is any past the 64th.

Parameters

key

Type: const char*

The reaction, drawn as text and handed back by RotulusView::reaction-activated; at most 32 code points.

The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
count

Type: guint

How many made it; 0 shows the key alone.

mine

Type: gboolean

Whether one of them is the reader’s.

label

Type: const char*

What a screen reader calls it, such as “thumbs up”; NULL reads the key.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.