Краткое описание

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

Осуществляемые интерфейсы

GtkComboBoxEntry осуществляет AtkImplementorIface, GtkCellEditable и GtkCellLayout.

Свойства

Описание

GtkComboBoxEntry это виджет который позволяет пользователю выбирать из списка доступных значений или вводить собственное значение. Это очень похоже на GtkComboBox, но отображает выбранное значение с возможностью его редактирования.

В отличие от GtkComboBox, основная модель GtkComboBoxEntry должна всегда иметь текстовую колонку (смотрите gtk_combo_box_entry_set_text_column()), и ввод отображает содержимое текстового столбца в выбранной строке. Для получения текста из ввода, используйте gtk_combo_box_get_active_text().

Сигнал изменения издается при вводе в GtkComboBoxEntry, также как при выборе пункта из списка GtkComboBoxEntry's. Используйте gtk_combo_box_get_active() или gtk_combo_box_get_active_iter() для обнаружения был ли пункт действительно выбран из списка.

Подключайте сигнал активизации GtkEntry (используя gtk_bin_get_child()) для определения когда пользователь действительно прекратит вводить текст.

API для создания простого текстового GtkComboBoxes может быть использовано также для GtkComboBoxEntrys который был создан с помощью gtk_combo_box_entry_new_text().

Детали

GtkComboBoxEntry

typedef struct _GtkComboBoxEntry GtkComboBoxEntry;

gtk_combo_box_entry_new ()
GtkWidget*  gtk_combo_box_entry_new         (void);

Создаёт новый GtkComboBoxEntry который
имеет дочерний GtkEntry.
После создания, вы должны установить
модель используя gtk_combo_box_set_model()
и text_column * используя
gtk_combo_box_entry_set_text_column().

	
	
	

		

			
Возвращает :
		
		

			
Новый GtkComboBoxEntry. 
			
		
	

Начиная с версии 2.4 


gtk_combo_box_entry_new_with_model ()
GtkWidget*  gtk_combo_box_entry_new_with_model
                                            (GtkTreeModel *model,
                                             gint text_column);

Создаёт новый GtkComboBoxEntry который
имеет дочерний GtkEntry и
список всплывающих строк. Вы можете
получить GtkEntry из
GtkComboBoxEntry используя GTK_ENTRY (GTK_BIN
(combo_box_entry)->child). Для добавления или
удаления строк из списка, просто измените
model используя её API для
обработки данных.

	
	
	

		

			
model :
		
		

			
 GtkTreeModel. 
			
		
	
	

		

			
text_column :
		
		

			
Столбец в  model для получения
			строк. 
			
		
	
	

		

			
Возвращает :
		
		

			
Новый GtkComboBoxEntry. 
			
		
	

Начиная с версии 2.4 


gtk_combo_box_entry_new_text ()
GtkWidget*  gtk_combo_box_entry_new_text    (void);

Удобная функция которая создаёт
изменяемый текст поля со списком, который
является GtkComboBoxEntry просто
отображающий строки. Если вы используете
эту функцию для создания поля со списком,
вы должны только манипулировать его
источником данных с помощью следующих
удобных функций: gtk_combo_box_append_text(),
gtk_combo_box_insert_text(),
gtk_combo_box_prepend_text()
и gtk_combo_box_remove_text().

	
	
	

		

			
Возвращает :
		
		

			
Новый текст GtkComboBoxEntry. 
			
		
	

Начиная с версии 2.4 


gtk_combo_box_entry_set_text_column ()
void        gtk_combo_box_entry_set_text_column
                                            (GtkComboBoxEntry *entry_box,
                                             gint text_column);

Устанавливает модель колонки которая
должна использовать  entry_box
для получения строк text_column.

	
	
	

		

			
entry_box :
		
		

			
 GtkComboBoxEntry. 
			
		
	
	

		

			
text_column :
		
		

			
Колонка в model для получения
			из неё строк. 
			
		
	

Начиная с версии 2.4. 


gtk_combo_box_entry_get_text_column ()
gint        gtk_combo_box_entry_get_text_column
                                            (GtkComboBoxEntry *entry_box);

Возвращает колонку entry_box
использует для получения из неё строк.

	
	
	

		

			
entry_box :
		
		

			
 GtkComboBoxEntry. 
			
		
	
	

		

			
Возвращает :
		
		

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

Начиная с версии 2.4 

Детали свойств
Свойство "text-column"
  "text-column"          gint                  : Read / Write

Колонка в источнике данных модели для
получения из неё строк.
Допустимые значения : >= -1
Значение по умолчанию : -1
Смотрите также
GtkComboBox