Spec-Zone.ru › GTK 3.22

GtkEntryBuffer

GtkEntryBuffer — Буфер текста для GtkEntry

Функции

GtkEntryBuffer * gtk_entry_buffer_new ()
const gchar * gtk_entry_buffer_get_text ()
void gtk_entry_buffer_set_text ()
gsize gtk_entry_buffer_get_bytes ()
guint gtk_entry_buffer_get_length ()
gint gtk_entry_buffer_get_max_length ()
void gtk_entry_buffer_set_max_length ()
guint gtk_entry_buffer_insert_text ()
guint gtk_entry_buffer_delete_text ()
void gtk_entry_buffer_emit_deleted_text ()
void gtk_entry_buffer_emit_inserted_text ()

Свойства

guint длина Чтение
gint максимальная длина Чтение / Запись
gchar * текст Чтение / Запись

Сигналы

void удаленный текст Запускается первым
void вставленный текст Запускается первым

Типы и значения

struct GtkEntryBuffer

Иерархия объектов

    GObject
    ╰── GtkEntryBuffer

Файлы

#include <gtk/gtk.h>

Описание

Класс GtkEntryBuffer содержит фактический текст, отображаемый в виджете GtkEntry.

Один объект GtkEntryBuffer может быть совместно использован несколькими виджетами GtkEntry, которые в таком случае будут совместно использовать содержимое текста, но не позицию курсора, атрибуты видимости, значки и т.д.

Класс GtkEntryBuffer может быть унаследован. Такой унаследованный класс может позволять хранить текст в другом месте, например, в нестраничной памяти, что полезно в случае с важными паролями. Или унаследованный класс может интегрироваться с концепцией «отменить/повторить» приложения.

Функции

gtk_entry_buffer_new ()

GtkEntryBuffer *
gtk_entry_buffer_new (const gchar *initial_chars,
                      gint n_initial_chars);

Создаёт новый объект GtkEntryBuffer.

Необязательно, можно указать начальный текст для буфера.

Параметры

initial_chars

начальный текст буфера, или NULL.

[allow-none]

n_initial_chars

количество символов в initial_chars, или -1

Возвращает

Новый объект GtkEntryBuffer.

С: 2.18

gtk_entry_buffer_get_text ()

const gchar *
gtk_entry_buffer_get_text (GtkEntryBuffer *buffer);

Возвращает содержимое буфера.

Указатель на память, возвращённый этим вызовом, не изменится, пока этот объект не выпустит сигнал или не завершит свою работу.

Параметры

buffer

объект GtkEntryBuffer

Возвращает

указатель на содержимое виджета в виде строки. Эта строка указывает на память, выделенную внутри буфера, и не должна освобождаться, изменяться или сохраняться.

С: 2.18

gtk_entry_buffer_set_text ()

void
gtk_entry_buffer_set_text (GtkEntryBuffer *buffer,
                           const gchar *chars,
                           gint n_chars);

Устанавливает текст в буфере.

Приблизительно эквивалентно вызову gtk_entry_buffer_delete_text() и gtk_entry_buffer_insert_text().

Обратите внимание, что n_chars указывается в символах, а не в байтах.

Параметры

buffer

объект GtkEntryBuffer

chars

новый текст

n_chars

количество символов в text, или -1

С: 2.18

gtk_entry_buffer_get_bytes ()

gsize
gtk_entry_buffer_get_bytes (GtkEntryBuffer *buffer);

Возвращает длину буфера в байтах. См. gtk_entry_buffer_get_length().

Параметры

buffer

объект GtkEntryBuffer

Возвращает

Длину буфера в байтах.

С: 2.18

gtk_entry_buffer_get_length ()

guint
gtk_entry_buffer_get_length (GtkEntryBuffer *buffer);

Возвращает длину буфера в символах.

Параметры

buffer

объект GtkEntryBuffer

Возвращает

Количество символов в буфере.

С: 2.18

gtk_entry_buffer_get_max_length ()

gint
gtk_entry_buffer_get_max_length (GtkEntryBuffer *buffer);

Возвращает максимальную разрешённую длину текста в buffer. См. gtk_entry_buffer_set_max_length().

Параметры

buffer

объект GtkEntryBuffer

Возвращает

максимальное разрешённое количество символов в GtkEntryBuffer, или 0, если максимальная длина не задана.

С: 2.18

gtk_entry_buffer_set_max_length ()

void
gtk_entry_buffer_set_max_length (GtkEntryBuffer *buffer,
                                 gint max_length);

Устанавливает максимальную разрешённую длину содержимого буфера. Если текущее содержимое длиннее, чем заданная длина, оно будет усечено.

Параметры

buffer

объект GtkEntryBuffer

max_length

максимальная длина буфера, или 0 для отсутствия максимальной длины. (кроме максимальной длины записей.) Переданное значение будет ограничено диапазоном от 0 до 65536.

С: 2.18

gtk_entry_buffer_insert_text ()

guint
gtk_entry_buffer_insert_text (GtkEntryBuffer *buffer,
                              guint position,
                              const gchar *chars,
                              gint n_chars);

Вставляет n_chars символов из chars в содержимое буфера по позиции position.

Если n_chars отрицательно, символы из chars будут вставляться до обнаружения нулевого терминатора. Если position или n_chars выходят за пределы, или максимальная длина текста буфера превышена, они приводятся к разумным значениям.

Обратите внимание, что позиция и длина указываются в символах, а не в байтах.

Параметры

buffer

объект GtkEntryBuffer

position

позиция для вставки текста.

chars

текст для вставки в буфер.

n_chars

длина текста в символах, или -1

Возвращает

Количество реально вставленных символов.

С: 2.18

gtk_entry_buffer_delete_text ()

guint
gtk_entry_buffer_delete_text (GtkEntryBuffer *buffer,
                              guint position,
                              gint n_chars);

Удаляет последовательность символов из буфера. n_chars символов удаляются, начиная с position. Если n_chars отрицательно, удаляются все символы до конца текста.

Если position или n_chars выходят за пределы, они приводятся к разумным значениям.

Обратите внимание, что позиции указаны в символах, а не в байтах.

Параметры

buffer

объект GtkEntryBuffer

position

позиция для удаления текста

n_chars

количество символов для удаления

Возвращает

Количество удалённых символов.

С: 2.18

gtk_entry_buffer_emit_deleted_text ()

void
gtk_entry_buffer_emit_deleted_text (GtkEntryBuffer *buffer,
                                    guint position,
                                    guint n_chars);

Используется при наследовании от GtkEntryBuffer

Параметры

buffer

объект GtkEntryBuffer

position

позиция, по которой был удалён текст

n_chars

количество удалённых символов

С: 2.18

gtk_entry_buffer_emit_inserted_text ()

void
gtk_entry_buffer_emit_inserted_text (GtkEntryBuffer *buffer,
                                     guint position,
                                     const gchar *chars,
                                     guint n_chars);

Используется при наследовании от GtkEntryBuffer

Параметры

buffer

объект GtkEntryBuffer

position

позиция, в которую был вставлен текст

chars

вставленный текст

n_chars

количество вставленных символов

С: 2.18

Типы и значения

struct GtkEntryBuffer

struct GtkEntryBuffer;

Подробности свойств

Свойство “length”

  “length”                   guint

Длина текста в буфере (в символах).

Флаги: Чтение

Допустимые значения: <= 65535

Значение по умолчанию: 0

С: 2.18

Свойство “max-length”

  “max-length”               gint

Максимальная длина текста в буфере (в символах).

Флаги: Чтение / Запись

Допустимые значения: [0,65535]

Значение по умолчанию: 0

С: 2.18

Свойство “text”

  “text”                     gchar *

Содержимое буфера.

Флаги: Чтение / Запись

Значение по умолчанию: ""

С: 2.18

Подробности сигналов

Сигнал “deleted-text”

void
user_function (GtkEntryBuffer *buffer,
               guint           position,
               guint           n_chars,
               gpointer        user_data)

Этот сигнал испускается после удаления текста из буфера.

Параметры

buffer

объект GtkEntryBuffer

position

позиция удаленного текста.

n_chars

Количество удаленных символов.

user_data

пользовательские данные, установленные при подключении обработчика сигнала.

Флаги: Выполняется первым

С: 2.18

Сигнал “inserted-text”

void
user_function (GtkEntryBuffer *buffer,
               guint           position,
               gchar          *chars,
               guint           n_chars,
               gpointer        user_data)

Этот сигнал испускается после вставки текста в буфер.

Параметры

buffer

объект GtkEntryBuffer

position

позиция вставки текста.

chars

Вставленный текст.

n_chars

Количество вставленных символов.

user_data

пользовательские данные, установленные при подключении обработчика сигнала.

Флаги: Выполняется первым

С: 2.18

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.22/GtkEntryBuffer.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API