Virtual Method

GtkEntryBufferinsert_text

since: 2.18

Declaration [src]

guint
insert_text (
  GtkEntryBuffer* buffer,
  guint position,
  const gchar* chars,
  guint n_chars
)

Description [src]

Inserts n_chars characters of chars into the contents of the buffer, at position position.

If n_chars is negative, then characters from chars will be inserted until a null-terminator is found. If position or n_chars are out of bounds, or the maximum buffer text length is exceeded, then they are coerced to sane values.

Note that the position and length are in characters, not in bytes.

Available since: 2.18

Parameters

position

Type: guint

The position at which to insert text.

chars

Type: const gchar*

The text to insert into the buffer.

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

Type: guint

The length of the text in characters, or -1.

Return value

Type: guint

The number of characters actually inserted.