2519 lines
123 KiB
HTML
2519 lines
123 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
<title>GtkComboBox: GTK+ 3 Reference Manual</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
||
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
|
||
<link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
|
||
<link rel="prev" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
|
||
<link rel="next" href="GtkComboBoxText.html" title="GtkComboBoxText">
|
||
<meta name="generator" content="GTK-Doc V1.33.0 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
|
||
<td width="100%" align="left" class="shortcuts">
|
||
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
||
<a href="#GtkComboBox.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
|
||
<a href="#GtkComboBox.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span>
|
||
<a href="#GtkComboBox.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span>
|
||
<a href="#GtkComboBox.properties" class="shortcut">Properties</a></span><span id="nav_style_properties"> <span class="dim">|</span>
|
||
<a href="#GtkComboBox.style-properties" class="shortcut">Style Properties</a></span><span id="nav_signals"> <span class="dim">|</span>
|
||
<a href="#GtkComboBox.signals" class="shortcut">Signals</a></span>
|
||
</td>
|
||
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
||
<td><a accesskey="u" href="MenusAndCombos.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
||
<td><a accesskey="p" href="MenusAndCombos.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="n" href="GtkComboBoxText.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
||
</tr></table>
|
||
<div class="refentry">
|
||
<a name="GtkComboBox"></a><div class="titlepage"></div>
|
||
<div class="refnamediv"><table width="100%"><tr>
|
||
<td valign="top">
|
||
<h2><span class="refentrytitle"><a name="GtkComboBox.top_of_page"></a>GtkComboBox</span></h2>
|
||
<p>GtkComboBox — A widget used to choose from a list of items</p>
|
||
</td>
|
||
<td class="gallery_image" valign="top" align="right"><img src="combo-box.png"></td>
|
||
</tr></table></div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.functions"></a><h2>Functions</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="functions_proto_type">
|
||
<col class="functions_proto_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-new" title="gtk_combo_box_new ()">gtk_combo_box_new</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-new-with-entry" title="gtk_combo_box_new_with_entry ()">gtk_combo_box_new_with_entry</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-new-with-model" title="gtk_combo_box_new_with_model ()">gtk_combo_box_new_with_model</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-new-with-model-and-entry" title="gtk_combo_box_new_with_model_and_entry ()">gtk_combo_box_new_with_model_and_entry</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-new-with-area" title="gtk_combo_box_new_with_area ()">gtk_combo_box_new_with_area</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-new-with-area-and-entry" title="gtk_combo_box_new_with_area_and_entry ()">gtk_combo_box_new_with_area_and_entry</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-wrap-width" title="gtk_combo_box_get_wrap_width ()">gtk_combo_box_get_wrap_width</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-wrap-width" title="gtk_combo_box_set_wrap_width ()">gtk_combo_box_set_wrap_width</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-row-span-column" title="gtk_combo_box_get_row_span_column ()">gtk_combo_box_get_row_span_column</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-row-span-column" title="gtk_combo_box_set_row_span_column ()">gtk_combo_box_set_row_span_column</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-column-span-column" title="gtk_combo_box_get_column_span_column ()">gtk_combo_box_get_column_span_column</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-column-span-column" title="gtk_combo_box_set_column_span_column ()">gtk_combo_box_set_column_span_column</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-active" title="gtk_combo_box_get_active ()">gtk_combo_box_get_active</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-active" title="gtk_combo_box_set_active ()">gtk_combo_box_set_active</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-active-iter" title="gtk_combo_box_get_active_iter ()">gtk_combo_box_get_active_iter</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-active-iter" title="gtk_combo_box_set_active_iter ()">gtk_combo_box_set_active_iter</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-id-column" title="gtk_combo_box_get_id_column ()">gtk_combo_box_get_id_column</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-id-column" title="gtk_combo_box_set_id_column ()">gtk_combo_box_set_id_column</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-active-id" title="gtk_combo_box_get_active_id ()">gtk_combo_box_get_active_id</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-active-id" title="gtk_combo_box_set_active_id ()">gtk_combo_box_set_active_id</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="returnvalue">GtkTreeModel</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-model" title="gtk_combo_box_get_model ()">gtk_combo_box_get_model</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-model" title="gtk_combo_box_set_model ()">gtk_combo_box_set_model</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-popup-for-device" title="gtk_combo_box_popup_for_device ()">gtk_combo_box_popup_for_device</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-popup" title="gtk_combo_box_popup ()">gtk_combo_box_popup</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-popdown" title="gtk_combo_box_popdown ()">gtk_combo_box_popdown</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a href="/usr/share/gtk-doc/html/atk/AtkObject.html#AtkObject-struct"><span class="returnvalue">AtkObject</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-popup-accessible" title="gtk_combo_box_get_popup_accessible ()">gtk_combo_box_get_popup_accessible</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkTreeView.html#GtkTreeViewRowSeparatorFunc" title="GtkTreeViewRowSeparatorFunc ()"><span class="returnvalue">GtkTreeViewRowSeparatorFunc</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-row-separator-func" title="gtk_combo_box_get_row_separator_func ()">gtk_combo_box_get_row_separator_func</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-row-separator-func" title="gtk_combo_box_set_row_separator_func ()">gtk_combo_box_set_row_separator_func</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-add-tearoffs" title="gtk_combo_box_set_add_tearoffs ()">gtk_combo_box_set_add_tearoffs</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-add-tearoffs" title="gtk_combo_box_get_add_tearoffs ()">gtk_combo_box_get_add_tearoffs</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-title" title="gtk_combo_box_set_title ()">gtk_combo_box_set_title</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">const <span class="returnvalue">gchar</span> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-title" title="gtk_combo_box_get_title ()">gtk_combo_box_get_title</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-focus-on-click" title="gtk_combo_box_set_focus_on_click ()">gtk_combo_box_set_focus_on_click</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-focus-on-click" title="gtk_combo_box_get_focus_on_click ()">gtk_combo_box_get_focus_on_click</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-button-sensitivity" title="gtk_combo_box_set_button_sensitivity ()">gtk_combo_box_set_button_sensitivity</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<a class="link" href="GtkRange.html#GtkSensitivityType" title="enum GtkSensitivityType"><span class="returnvalue">GtkSensitivityType</span></a>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-button-sensitivity" title="gtk_combo_box_get_button_sensitivity ()">gtk_combo_box_get_button_sensitivity</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-has-entry" title="gtk_combo_box_get_has_entry ()">gtk_combo_box_get_has_entry</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-entry-text-column" title="gtk_combo_box_set_entry_text_column ()">gtk_combo_box_set_entry_text_column</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gint</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-entry-text-column" title="gtk_combo_box_get_entry_text_column ()">gtk_combo_box_get_entry_text_column</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">void</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-popup-fixed-width" title="gtk_combo_box_set_popup_fixed_width ()">gtk_combo_box_set_popup_fixed_width</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">
|
||
<span class="returnvalue">gboolean</span>
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-get-popup-fixed-width" title="gtk_combo_box_get_popup_fixed_width ()">gtk_combo_box_get_popup_fixed_width</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.properties"></a><h2>Properties</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="properties_type">
|
||
<col width="300px" class="properties_name">
|
||
<col width="200px" class="properties_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--active" title="The “active” property">active</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--active-id" title="The “active-id” property">active-id</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--add-tearoffs" title="The “add-tearoffs” property">add-tearoffs</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><a class="link" href="GtkRange.html#GtkSensitivityType" title="enum GtkSensitivityType"><span class="type">GtkSensitivityType</span></a></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--button-sensitivity" title="The “button-sensitivity” property">button-sensitivity</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--cell-area" title="The “cell-area” property">cell-area</a></td>
|
||
<td class="property_flags">Read / Write / Construct Only</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--column-span-column" title="The “column-span-column” property">column-span-column</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--entry-text-column" title="The “entry-text-column” property">entry-text-column</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--has-entry" title="The “has-entry” property">has-entry</a></td>
|
||
<td class="property_flags">Read / Write / Construct Only</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--has-frame" title="The “has-frame” property">has-frame</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--id-column" title="The “id-column” property">id-column</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *</td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--model" title="The “model” property">model</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--popup-fixed-width" title="The “popup-fixed-width” property">popup-fixed-width</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--popup-shown" title="The “popup-shown” property">popup-shown</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--row-span-column" title="The “row-span-column” property">row-span-column</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type">
|
||
<span class="type">char</span> *</td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--tearoff-title" title="The “tearoff-title” property">tearoff-title</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--wrap-width" title="The “wrap-width” property">wrap-width</a></td>
|
||
<td class="property_flags">Read / Write</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.style-properties"></a><h2>Style Properties</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="style_properties_type">
|
||
<col width="300px" class="style_properties_name">
|
||
<col width="200px" class="style_properties_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="property_type"><span class="type">gboolean</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--s-appears-as-list" title="The “appears-as-list” style property">appears-as-list</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">float</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--s-arrow-scaling" title="The “arrow-scaling” style property">arrow-scaling</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><span class="type">int</span></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--s-arrow-size" title="The “arrow-size” style property">arrow-size</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="property_type"><a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a></td>
|
||
<td class="property_name"><a class="link" href="GtkComboBox.html#GtkComboBox--s-shadow-type" title="The “shadow-type” style property">shadow-type</a></td>
|
||
<td class="property_flags">Read</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.signals"></a><h2>Signals</h2>
|
||
<div class="informaltable"><table class="informaltable" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="signal_proto_type">
|
||
<col width="300px" class="signal_proto_name">
|
||
<col width="200px" class="signal_proto_flags">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkComboBox.html#GtkComboBox-changed" title="The “changed” signal">changed</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type">
|
||
<span class="returnvalue">char</span>*</td>
|
||
<td class="signal_name"><a class="link" href="GtkComboBox.html#GtkComboBox-format-entry-text" title="The “format-entry-text” signal">format-entry-text</a></td>
|
||
<td class="signal_flags">Run Last</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkComboBox.html#GtkComboBox-move-active" title="The “move-active” signal">move-active</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkComboBox.html#GtkComboBox-popdown" title="The “popdown” signal">popdown</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="signal_type"><span class="returnvalue">void</span></td>
|
||
<td class="signal_name"><a class="link" href="GtkComboBox.html#GtkComboBox-popup" title="The “popup” signal">popup</a></td>
|
||
<td class="signal_flags">Action</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.other"></a><h2>Types and Values</h2>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="other_proto_type">
|
||
<col class="other_proto_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="GtkComboBox.html#GtkComboBox-struct" title="struct GtkComboBox">GtkComboBox</a></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="GtkComboBox.html#GtkComboBoxClass" title="struct GtkComboBoxClass">GtkComboBoxClass</a></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
||
<pre class="screen"> GObject
|
||
<span class="lineart">╰──</span> GInitiallyUnowned
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
|
||
<span class="lineart">╰──</span> GtkComboBox
|
||
<span class="lineart">├──</span> <a class="link" href="GtkAppChooserButton.html" title="GtkAppChooserButton">GtkAppChooserButton</a>
|
||
<span class="lineart">╰──</span> <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText">GtkComboBoxText</a>
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
|
||
<p>
|
||
GtkComboBox implements
|
||
AtkImplementorIface, <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>, <a class="link" href="GtkCellLayout.html" title="GtkCellLayout">GtkCellLayout</a> and <a class="link" href="GtkCellEditable.html" title="GtkCellEditable">GtkCellEditable</a>.</p>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.includes"></a><h2>Includes</h2>
|
||
<pre class="synopsis">#include <gtk/gtk.h>
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.description"></a><h2>Description</h2>
|
||
<p>A GtkComboBox is a widget that allows the user to choose from a list of
|
||
valid choices. The GtkComboBox displays the selected choice. When
|
||
activated, the GtkComboBox displays a popup which allows the user to
|
||
make a new choice. The style in which the selected value is displayed,
|
||
and the style of the popup is determined by the current theme. It may
|
||
be similar to a Windows-style combo box.</p>
|
||
<p>The GtkComboBox uses the model-view pattern; the list of valid choices
|
||
is specified in the form of a tree model, and the display of the choices
|
||
can be adapted to the data in the model by using cell renderers, as you
|
||
would in a tree view. This is possible since GtkComboBox implements the
|
||
<a class="link" href="GtkCellLayout.html" title="GtkCellLayout"><span class="type">GtkCellLayout</span></a> interface. The tree model holding the valid choices is
|
||
not restricted to a flat list, it can be a real tree, and the popup will
|
||
reflect the tree structure.</p>
|
||
<p>To allow the user to enter values not in the model, the “has-entry”
|
||
property allows the GtkComboBox to contain a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>. This entry
|
||
can be accessed by calling <a class="link" href="GtkBin.html#gtk-bin-get-child" title="gtk_bin_get_child ()"><code class="function">gtk_bin_get_child()</code></a> on the combo box.</p>
|
||
<p>For a simple list of textual choices, the model-view API of GtkComboBox
|
||
can be a bit overwhelming. In this case, <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> offers a
|
||
simple alternative. Both GtkComboBox and <a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a> can contain
|
||
an entry.</p>
|
||
<div class="refsect2">
|
||
<a name="id-1.3.13.2.11.6"></a><h3>CSS nodes</h3>
|
||
<div class="informalexample">
|
||
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
||
<tbody>
|
||
<tr>
|
||
<td class="listing_lines" align="right"><pre>1
|
||
2
|
||
3
|
||
4
|
||
5
|
||
6
|
||
7</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="n">combobox</span>
|
||
<span class="err">├──</span> <span class="n">box</span><span class="p">.</span><span class="n">linked</span>
|
||
<span class="err">│</span> <span class="err">╰──</span> <span class="n">button</span><span class="p">.</span><span class="n">combo</span>
|
||
<span class="err">│</span> <span class="err">╰──</span> <span class="n">box</span>
|
||
<span class="err">│</span> <span class="err">├──</span> <span class="n">cellview</span>
|
||
<span class="err">│</span> <span class="err">╰──</span> <span class="n">arrow</span>
|
||
<span class="err">╰──</span> <span class="n">window</span><span class="p">.</span><span class="n">popup</span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
<p>A normal combobox contains a box with the .linked class, a button
|
||
with the .combo class and inside those buttons, there are a cellview and
|
||
an arrow.</p>
|
||
<div class="informalexample">
|
||
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
||
<tbody>
|
||
<tr>
|
||
<td class="listing_lines" align="right"><pre>1
|
||
2
|
||
3
|
||
4
|
||
5
|
||
6
|
||
7</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="n">combobox</span>
|
||
<span class="err">├──</span> <span class="n">box</span><span class="p">.</span><span class="n">linked</span>
|
||
<span class="err">│</span> <span class="err">├──</span> <span class="n">entry</span><span class="p">.</span><span class="n">combo</span>
|
||
<span class="err">│</span> <span class="err">╰──</span> <span class="n">button</span><span class="p">.</span><span class="n">combo</span>
|
||
<span class="err">│</span> <span class="err">╰──</span> <span class="n">box</span>
|
||
<span class="err">│</span> <span class="err">╰──</span> <span class="n">arrow</span>
|
||
<span class="err">╰──</span> <span class="n">window</span><span class="p">.</span><span class="n">popup</span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
<p>A GtkComboBox with an entry has a single CSS node with name combobox. It
|
||
contains a box with the .linked class. That box contains an entry and a
|
||
button, both with the .combo class added.
|
||
The button also contains another node with name arrow.</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.functions_details"></a><h2>Functions</h2>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-new"></a><h3>gtk_combo_box_new ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_combo_box_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
||
<p>Creates a new empty <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-new.returns"></a><h4>Returns</h4>
|
||
<p> A new <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-new-with-entry"></a><h3>gtk_combo_box_new_with_entry ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_combo_box_new_with_entry (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
|
||
<p>Creates a new empty <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> with an entry.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-new-with-entry.returns"></a><h4>Returns</h4>
|
||
<p> A new <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</p>
|
||
</div>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-new-with-model"></a><h3>gtk_combo_box_new_with_model ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_combo_box_new_with_model (<em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);</pre>
|
||
<p>Creates a new <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> with the model initialized to <em class="parameter"><code>model</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-new-with-model.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>model</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-new-with-model.returns"></a><h4>Returns</h4>
|
||
<p> A new <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-new-with-model-and-entry"></a><h3>gtk_combo_box_new_with_model_and_entry ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_combo_box_new_with_model_and_entry
|
||
(<em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);</pre>
|
||
<p>Creates a new empty <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> with an entry
|
||
and with the model initialized to <em class="parameter"><code>model</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-new-with-model-and-entry.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>model</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-new-with-model-and-entry.returns"></a><h4>Returns</h4>
|
||
<p> A new <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p>
|
||
</div>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-new-with-area"></a><h3>gtk_combo_box_new_with_area ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_combo_box_new_with_area (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>);</pre>
|
||
<p>Creates a new empty <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> using <em class="parameter"><code>area</code></em>
|
||
to layout cells.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-new-with-area.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>area</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> to use to layout cell renderers</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-new-with-area.returns"></a><h4>Returns</h4>
|
||
<p> A new <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-new-with-area-and-entry"></a><h3>gtk_combo_box_new_with_area_and_entry ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
|
||
gtk_combo_box_new_with_area_and_entry (<em class="parameter"><code><a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *area</code></em>);</pre>
|
||
<p>Creates a new empty <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> with an entry.</p>
|
||
<p>The new combo box will use <em class="parameter"><code>area</code></em>
|
||
to layout cells.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-new-with-area-and-entry.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>area</p></td>
|
||
<td class="parameter_description"><p>the <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> to use to layout cell renderers</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-new-with-area-and-entry.returns"></a><h4>Returns</h4>
|
||
<p> A new <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-wrap-width"></a><h3>gtk_combo_box_get_wrap_width ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_combo_box_get_wrap_width (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Returns the wrap width which is used to determine the number of columns
|
||
for the popup menu. If the wrap width is larger than 1, the combo box
|
||
is in table mode.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-wrap-width.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-wrap-width.returns"></a><h4>Returns</h4>
|
||
<p> the wrap width.</p>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-wrap-width"></a><h3>gtk_combo_box_set_wrap_width ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_wrap_width (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> width</code></em>);</pre>
|
||
<p>Sets the wrap width of <em class="parameter"><code>combo_box</code></em>
|
||
to be <em class="parameter"><code>width</code></em>
|
||
. The wrap width is basically
|
||
the preferred number of columns when you want the popup to be layed out
|
||
in a table.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-wrap-width.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>width</p></td>
|
||
<td class="parameter_description"><p>Preferred number of columns</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-row-span-column"></a><h3>gtk_combo_box_get_row_span_column ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_combo_box_get_row_span_column (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Returns the column with row span information for <em class="parameter"><code>combo_box</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-row-span-column.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-row-span-column.returns"></a><h4>Returns</h4>
|
||
<p> the row span column.</p>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-row-span-column"></a><h3>gtk_combo_box_set_row_span_column ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_row_span_column (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> row_span</code></em>);</pre>
|
||
<p>Sets the column with row span information for <em class="parameter"><code>combo_box</code></em>
|
||
to be <em class="parameter"><code>row_span</code></em>
|
||
.
|
||
The row span column contains integers which indicate how many rows
|
||
an item should span.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-row-span-column.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>row_span</p></td>
|
||
<td class="parameter_description"><p>A column in the model passed during construction.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-column-span-column"></a><h3>gtk_combo_box_get_column_span_column ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_combo_box_get_column_span_column (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Returns the column with column span information for <em class="parameter"><code>combo_box</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-column-span-column.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-column-span-column.returns"></a><h4>Returns</h4>
|
||
<p> the column span column.</p>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-column-span-column"></a><h3>gtk_combo_box_set_column_span_column ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_column_span_column (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> column_span</code></em>);</pre>
|
||
<p>Sets the column with column span information for <em class="parameter"><code>combo_box</code></em>
|
||
to be
|
||
<em class="parameter"><code>column_span</code></em>
|
||
. The column span column contains integers which indicate
|
||
how many columns an item should span.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-column-span-column.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>column_span</p></td>
|
||
<td class="parameter_description"><p>A column in the model passed during construction</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-active"></a><h3>gtk_combo_box_get_active ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_combo_box_get_active (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Returns the index of the currently active item, or -1 if there’s no
|
||
active item. If the model is a non-flat treemodel, and the active item
|
||
is not an immediate child of the root of the tree, this function returns
|
||
<code class="literal">gtk_tree_path_get_indices (path)[0]</code>, where
|
||
<code class="literal">path</code> is the <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> of the active item.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-active.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-active.returns"></a><h4>Returns</h4>
|
||
<p> An integer which is the index of the currently active item,
|
||
or -1 if there’s no active item.</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-active"></a><h3>gtk_combo_box_set_active ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_active (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> index_</code></em>);</pre>
|
||
<p>Sets the active item of <em class="parameter"><code>combo_box</code></em>
|
||
to be the item at <em class="parameter"><code>index</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-active.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>index_</p></td>
|
||
<td class="parameter_description"><p>An index in the model passed during construction, or -1 to have
|
||
no active item</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-active-iter"></a><h3>gtk_combo_box_get_active_iter ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_combo_box_get_active_iter (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);</pre>
|
||
<p>Sets <em class="parameter"><code>iter</code></em>
|
||
to point to the currently active item, if any item is active.
|
||
Otherwise, <em class="parameter"><code>iter</code></em>
|
||
is left unchanged.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-active-iter.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-active-iter.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if <em class="parameter"><code>iter</code></em>
|
||
was set, <code class="literal">FALSE</code> otherwise</p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-active-iter"></a><h3>gtk_combo_box_set_active_iter ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_active_iter (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a> *iter</code></em>);</pre>
|
||
<p>Sets the current active item to be the one referenced by <em class="parameter"><code>iter</code></em>
|
||
, or
|
||
unsets the active item if <em class="parameter"><code>iter</code></em>
|
||
is <code class="literal">NULL</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-active-iter.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>iter</p></td>
|
||
<td class="parameter_description"><p>The <a class="link" href="GtkTreeModel.html#GtkTreeIter"><span class="type">GtkTreeIter</span></a>, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-id-column"></a><h3>gtk_combo_box_get_id_column ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_combo_box_get_id_column (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Returns the column which <em class="parameter"><code>combo_box</code></em>
|
||
is using to get string IDs
|
||
for values from.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-id-column.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-id-column.returns"></a><h4>Returns</h4>
|
||
<p> A column in the data source model of <em class="parameter"><code>combo_box</code></em>
|
||
.</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-id-column"></a><h3>gtk_combo_box_set_id_column ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_id_column (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> id_column</code></em>);</pre>
|
||
<p>Sets the model column which <em class="parameter"><code>combo_box</code></em>
|
||
should use to get string IDs
|
||
for values from. The column <em class="parameter"><code>id_column</code></em>
|
||
in the model of <em class="parameter"><code>combo_box</code></em>
|
||
|
||
must be of type <code class="literal">G_TYPE_STRING</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-id-column.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>id_column</p></td>
|
||
<td class="parameter_description"><p>A column in <em class="parameter"><code>model</code></em>
|
||
to get string IDs for values from</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-active-id"></a><h3>gtk_combo_box_get_active_id ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_combo_box_get_active_id (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Returns the ID of the active row of <em class="parameter"><code>combo_box</code></em>
|
||
. This value is taken
|
||
from the active row and the column specified by the <a class="link" href="GtkComboBox.html#GtkComboBox--id-column" title="The “id-column” property"><span class="type">“id-column”</span></a>
|
||
property of <em class="parameter"><code>combo_box</code></em>
|
||
(see <a class="link" href="GtkComboBox.html#gtk-combo-box-set-id-column" title="gtk_combo_box_set_id_column ()"><code class="function">gtk_combo_box_set_id_column()</code></a>).</p>
|
||
<p>The returned value is an interned string which means that you can
|
||
compare the pointer by value to other interned strings and that you
|
||
must not free it.</p>
|
||
<p>If the <a class="link" href="GtkComboBox.html#GtkComboBox--id-column" title="The “id-column” property"><span class="type">“id-column”</span></a> property of <em class="parameter"><code>combo_box</code></em>
|
||
is not set, or if
|
||
no row is active, or if the active row has a <code class="literal">NULL</code> ID value, then <code class="literal">NULL</code>
|
||
is returned.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-active-id.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-active-id.returns"></a><h4>Returns</h4>
|
||
<p>the ID of the active row, or <code class="literal">NULL</code>. </p>
|
||
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-active-id"></a><h3>gtk_combo_box_set_active_id ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_combo_box_set_active_id (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *active_id</code></em>);</pre>
|
||
<p>Changes the active row of <em class="parameter"><code>combo_box</code></em>
|
||
to the one that has an ID equal to
|
||
<em class="parameter"><code>active_id</code></em>
|
||
, or unsets the active row if <em class="parameter"><code>active_id</code></em>
|
||
is <code class="literal">NULL</code>. Rows having
|
||
a <code class="literal">NULL</code> ID string cannot be made active by this function.</p>
|
||
<p>If the <a class="link" href="GtkComboBox.html#GtkComboBox--id-column" title="The “id-column” property"><span class="type">“id-column”</span></a> property of <em class="parameter"><code>combo_box</code></em>
|
||
is unset or if no
|
||
row has the given ID then the function does nothing and returns <code class="literal">FALSE</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-active-id.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>active_id</p></td>
|
||
<td class="parameter_description"><p>the ID of the row to select, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-active-id.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if a row with a matching ID was found. If a <code class="literal">NULL</code>
|
||
<em class="parameter"><code>active_id</code></em>
|
||
was given to unset the active row, the function
|
||
always returns <code class="literal">TRUE</code>.</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-model"></a><h3>gtk_combo_box_get_model ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="returnvalue">GtkTreeModel</span></a> *
|
||
gtk_combo_box_get_model (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Returns the <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> which is acting as data source for <em class="parameter"><code>combo_box</code></em>
|
||
.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-model.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-model.returns"></a><h4>Returns</h4>
|
||
<p>A <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> which was passed
|
||
during construction. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-model"></a><h3>gtk_combo_box_set_model ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_model (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *model</code></em>);</pre>
|
||
<p>Sets the model used by <em class="parameter"><code>combo_box</code></em>
|
||
to be <em class="parameter"><code>model</code></em>
|
||
. Will unset a previously set
|
||
model (if applicable). If model is <code class="literal">NULL</code>, then it will unset the model.</p>
|
||
<p>Note that this function does not clear the cell renderers, you have to
|
||
call <a class="link" href="GtkCellLayout.html#gtk-cell-layout-clear" title="gtk_cell_layout_clear ()"><code class="function">gtk_cell_layout_clear()</code></a> yourself if you need to set up different
|
||
cell renderers for the new model.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-model.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>model</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-popup-for-device"></a><h3>gtk_combo_box_popup_for_device ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_popup_for_device (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a> *device</code></em>);</pre>
|
||
<p>Pops up the menu or dropdown list of <em class="parameter"><code>combo_box</code></em>
|
||
, the popup window
|
||
will be grabbed so only <em class="parameter"><code>device</code></em>
|
||
and its associated pointer/keyboard
|
||
are the only <span class="type">GdkDevices</span> able to send events to it.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-popup-for-device.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>device</p></td>
|
||
<td class="parameter_description"><p>a <a href="../html/GdkDevice.html#GdkDevice-struct"><span class="type">GdkDevice</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-popup"></a><h3>gtk_combo_box_popup ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_popup (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Pops up the menu or dropdown list of <em class="parameter"><code>combo_box</code></em>
|
||
.</p>
|
||
<p>This function is mostly intended for use by accessibility technologies;
|
||
applications should have little use for it.</p>
|
||
<p>Before calling this, <em class="parameter"><code>combo_box</code></em>
|
||
must be mapped, or nothing will happen.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-popup.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-popdown"></a><h3>gtk_combo_box_popdown ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_popdown (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Hides the menu or dropdown list of <em class="parameter"><code>combo_box</code></em>
|
||
.</p>
|
||
<p>This function is mostly intended for use by accessibility technologies;
|
||
applications should have little use for it.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-popdown.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-popup-accessible"></a><h3>gtk_combo_box_get_popup_accessible ()</h3>
|
||
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/atk/AtkObject.html#AtkObject-struct"><span class="returnvalue">AtkObject</span></a> *
|
||
gtk_combo_box_get_popup_accessible (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Gets the accessible object corresponding to the combo box’s popup.</p>
|
||
<p>This function is mostly intended for use by accessibility technologies;
|
||
applications should have little use for it.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-popup-accessible.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-popup-accessible.returns"></a><h4>Returns</h4>
|
||
<p>the accessible object corresponding
|
||
to the combo box’s popup. </p>
|
||
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-row-separator-func"></a><h3>gtk_combo_box_get_row_separator_func ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkTreeView.html#GtkTreeViewRowSeparatorFunc" title="GtkTreeViewRowSeparatorFunc ()"><span class="returnvalue">GtkTreeViewRowSeparatorFunc</span></a>
|
||
gtk_combo_box_get_row_separator_func (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Returns the current row separator function.</p>
|
||
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-row-separator-func.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-row-separator-func.returns"></a><h4>Returns</h4>
|
||
<p> the current row separator function.</p>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-row-separator-func"></a><h3>gtk_combo_box_set_row_separator_func ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_row_separator_func (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkTreeView.html#GtkTreeViewRowSeparatorFunc" title="GtkTreeViewRowSeparatorFunc ()"><span class="type">GtkTreeViewRowSeparatorFunc</span></a> func</code></em>,
|
||
<em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
|
||
<em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);</pre>
|
||
<p>Sets the row separator function, which is used to determine
|
||
whether a row should be drawn as a separator. If the row separator
|
||
function is <code class="literal">NULL</code>, no separators are drawn. This is the default value.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-row-separator-func.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>func</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkTreeView.html#GtkTreeViewRowSeparatorFunc" title="GtkTreeViewRowSeparatorFunc ()"><span class="type">GtkTreeViewRowSeparatorFunc</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>data</p></td>
|
||
<td class="parameter_description"><p>user data to pass to <em class="parameter"><code>func</code></em>
|
||
, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>destroy</p></td>
|
||
<td class="parameter_description"><p>destroy notifier for <em class="parameter"><code>data</code></em>
|
||
, or <code class="literal">NULL</code>. </p></td>
|
||
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-add-tearoffs"></a><h3>gtk_combo_box_set_add_tearoffs ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_add_tearoffs (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> add_tearoffs</code></em>);</pre>
|
||
<div class="warning"><p><code class="literal">gtk_combo_box_set_add_tearoffs</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
|
||
<p>Sets whether the popup menu should have a tearoff
|
||
menu item.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-add-tearoffs.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>add_tearoffs</p></td>
|
||
<td class="parameter_description"><p><code class="literal">TRUE</code> to add tearoff menu items</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-add-tearoffs"></a><h3>gtk_combo_box_get_add_tearoffs ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_combo_box_get_add_tearoffs (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<div class="warning"><p><code class="literal">gtk_combo_box_get_add_tearoffs</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
|
||
<p>Gets the current value of the :add-tearoffs property.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-add-tearoffs.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-add-tearoffs.returns"></a><h4>Returns</h4>
|
||
<p> the current value of the :add-tearoffs property.</p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-title"></a><h3>gtk_combo_box_set_title ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_title (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>);</pre>
|
||
<div class="warning"><p><code class="literal">gtk_combo_box_set_title</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
|
||
<p>Sets the menu’s title in tearoff mode.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-title.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>title</p></td>
|
||
<td class="parameter_description"><p>a title for the menu in tearoff mode</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-title"></a><h3>gtk_combo_box_get_title ()</h3>
|
||
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
|
||
gtk_combo_box_get_title (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<div class="warning"><p><code class="literal">gtk_combo_box_get_title</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
|
||
<p>Gets the current title of the menu in tearoff mode. See
|
||
<a class="link" href="GtkComboBox.html#gtk-combo-box-set-add-tearoffs" title="gtk_combo_box_set_add_tearoffs ()"><code class="function">gtk_combo_box_set_add_tearoffs()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-title.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-title.returns"></a><h4>Returns</h4>
|
||
<p> the menu’s title in tearoff mode. This is an internal copy of the
|
||
string which must not be freed.</p>
|
||
</div>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-focus-on-click"></a><h3>gtk_combo_box_set_focus_on_click ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_focus_on_click (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> focus_on_click</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_combo_box_set_focus_on_click</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>Use <a class="link" href="GtkWidget.html#gtk-widget-set-focus-on-click" title="gtk_widget_set_focus_on_click ()"><code class="function">gtk_widget_set_focus_on_click()</code></a> instead</p>
|
||
</div>
|
||
<p>Sets whether the combo box will grab focus when it is clicked with
|
||
the mouse. Making mouse clicks not grab focus is useful in places
|
||
like toolbars where you don’t want the keyboard focus removed from
|
||
the main area of the application.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-focus-on-click.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>focus_on_click</p></td>
|
||
<td class="parameter_description"><p>whether the combo box grabs focus when clicked
|
||
with the mouse</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-focus-on-click"></a><h3>gtk_combo_box_get_focus_on_click ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_combo_box_get_focus_on_click (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo</code></em>);</pre>
|
||
<div class="warning">
|
||
<p><code class="literal">gtk_combo_box_get_focus_on_click</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>Use <a class="link" href="GtkWidget.html#gtk-widget-get-focus-on-click" title="gtk_widget_get_focus_on_click ()"><code class="function">gtk_widget_get_focus_on_click()</code></a> instead</p>
|
||
</div>
|
||
<p>Returns whether the combo box grabs focus when it is clicked
|
||
with the mouse. See <a class="link" href="GtkComboBox.html#gtk-combo-box-set-focus-on-click" title="gtk_combo_box_set_focus_on_click ()"><code class="function">gtk_combo_box_set_focus_on_click()</code></a>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-focus-on-click.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-focus-on-click.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the combo box grabs focus when it is
|
||
clicked with the mouse.</p>
|
||
</div>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-button-sensitivity"></a><h3>gtk_combo_box_set_button_sensitivity ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_button_sensitivity (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><a class="link" href="GtkRange.html#GtkSensitivityType" title="enum GtkSensitivityType"><span class="type">GtkSensitivityType</span></a> sensitivity</code></em>);</pre>
|
||
<p>Sets whether the dropdown button of the combo box should be
|
||
always sensitive (<a class="link" href="GtkRange.html#GTK-SENSITIVITY-ON:CAPS"><code class="literal">GTK_SENSITIVITY_ON</code></a>), never sensitive (<a class="link" href="GtkRange.html#GTK-SENSITIVITY-OFF:CAPS"><code class="literal">GTK_SENSITIVITY_OFF</code></a>)
|
||
or only if there is at least one item to display (<a class="link" href="GtkRange.html#GTK-SENSITIVITY-AUTO:CAPS"><code class="literal">GTK_SENSITIVITY_AUTO</code></a>).</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-button-sensitivity.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>sensitivity</p></td>
|
||
<td class="parameter_description"><p>specify the sensitivity of the dropdown button</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.14</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-button-sensitivity"></a><h3>gtk_combo_box_get_button_sensitivity ()</h3>
|
||
<pre class="programlisting"><a class="link" href="GtkRange.html#GtkSensitivityType" title="enum GtkSensitivityType"><span class="returnvalue">GtkSensitivityType</span></a>
|
||
gtk_combo_box_get_button_sensitivity (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Returns whether the combo box sets the dropdown button
|
||
sensitive or not when there are no items in the model.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-button-sensitivity.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-button-sensitivity.returns"></a><h4>Returns</h4>
|
||
<p> <a class="link" href="GtkRange.html#GTK-SENSITIVITY-ON:CAPS"><code class="literal">GTK_SENSITIVITY_ON</code></a> if the dropdown button
|
||
is sensitive when the model is empty, <a class="link" href="GtkRange.html#GTK-SENSITIVITY-OFF:CAPS"><code class="literal">GTK_SENSITIVITY_OFF</code></a>
|
||
if the button is always insensitive or
|
||
<a class="link" href="GtkRange.html#GTK-SENSITIVITY-AUTO:CAPS"><code class="literal">GTK_SENSITIVITY_AUTO</code></a> if it is only sensitive as long as
|
||
the model has one item to be selected.</p>
|
||
</div>
|
||
<p class="since">Since: 2.14</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-has-entry"></a><h3>gtk_combo_box_get_has_entry ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_combo_box_get_has_entry (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Returns whether the combo box has an entry.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-has-entry.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-has-entry.returns"></a><h4>Returns</h4>
|
||
<p> whether there is an entry in <em class="parameter"><code>combo_box</code></em>
|
||
.</p>
|
||
</div>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-entry-text-column"></a><h3>gtk_combo_box_set_entry_text_column ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_entry_text_column (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><span class="type">gint</span> text_column</code></em>);</pre>
|
||
<p>Sets the model column which <em class="parameter"><code>combo_box</code></em>
|
||
should use to get strings from
|
||
to be <em class="parameter"><code>text_column</code></em>
|
||
. The column <em class="parameter"><code>text_column</code></em>
|
||
in the model of <em class="parameter"><code>combo_box</code></em>
|
||
|
||
must be of type <code class="literal">G_TYPE_STRING</code>.</p>
|
||
<p>This is only relevant if <em class="parameter"><code>combo_box</code></em>
|
||
has been created with
|
||
<a class="link" href="GtkComboBox.html#GtkComboBox--has-entry" title="The “has-entry” property"><span class="type">“has-entry”</span></a> as <code class="literal">TRUE</code>.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-entry-text-column.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>text_column</p></td>
|
||
<td class="parameter_description"><p>A column in <em class="parameter"><code>model</code></em>
|
||
to get the strings from for
|
||
the internal entry</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-entry-text-column"></a><h3>gtk_combo_box_get_entry_text_column ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gint</span>
|
||
gtk_combo_box_get_entry_text_column (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Returns the column which <em class="parameter"><code>combo_box</code></em>
|
||
is using to get the strings
|
||
from to display in the internal entry.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-entry-text-column.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>A <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a>.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-entry-text-column.returns"></a><h4>Returns</h4>
|
||
<p> A column in the data source model of <em class="parameter"><code>combo_box</code></em>
|
||
.</p>
|
||
</div>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-set-popup-fixed-width"></a><h3>gtk_combo_box_set_popup_fixed_width ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
gtk_combo_box_set_popup_fixed_width (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>,
|
||
<em class="parameter"><code><span class="type">gboolean</span> fixed</code></em>);</pre>
|
||
<p>Specifies whether the popup’s width should be a fixed width
|
||
matching the allocated width of the combo box.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-set-popup-fixed-width.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>fixed</p></td>
|
||
<td class="parameter_description"><p>whether to use a fixed popup width</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="gtk-combo-box-get-popup-fixed-width"></a><h3>gtk_combo_box_get_popup_fixed_width ()</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
gtk_combo_box_get_popup_fixed_width (<em class="parameter"><code><a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo_box</code></em>);</pre>
|
||
<p>Gets whether the popup uses a fixed width matching
|
||
the allocated width of the combo box.</p>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-popup-fixed-width.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>combo_box</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="gtk-combo-box-get-popup-fixed-width.returns"></a><h4>Returns</h4>
|
||
<p> <code class="literal">TRUE</code> if the popup uses a fixed width</p>
|
||
</div>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.other_details"></a><h2>Types and Values</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox-struct"></a><h3>struct GtkComboBox</h3>
|
||
<pre class="programlisting">struct GtkComboBox;</pre>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBoxClass"></a><h3>struct GtkComboBoxClass</h3>
|
||
<pre class="programlisting">struct GtkComboBoxClass {
|
||
GtkBinClass parent_class;
|
||
|
||
/* signals */
|
||
void (* changed) (GtkComboBox *combo_box);
|
||
gchar *(* format_entry_text) (GtkComboBox *combo_box,
|
||
const gchar *path);
|
||
};
|
||
</pre>
|
||
<div class="refsect3">
|
||
<a name="GtkComboBoxClass.members"></a><h4>Members</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="300px" class="struct_members_name">
|
||
<col class="struct_members_description">
|
||
<col width="200px" class="struct_members_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkComboBoxClass.changed"></a>changed</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Signal is emitted when the active item is changed.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkComboBoxClass.format-entry-text"></a>format_entry_text</code></em> ()</p></td>
|
||
<td class="struct_member_description"><p>Signal which allows you to change how the text
|
||
displayed in a combo box’s entry is displayed.</p></td>
|
||
<td class="struct_member_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.property-details"></a><h2>Property Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--active"></a><h3>The <code class="literal">“active”</code> property</h3>
|
||
<pre class="programlisting"> “active” <span class="type">int</span></pre>
|
||
<p>The item which is currently active. If the model is a non-flat treemodel,
|
||
and the active item is not an immediate child of the root of the tree,
|
||
this property has the value
|
||
<code class="literal">gtk_tree_path_get_indices (path)[0]</code>,
|
||
where <code class="literal">path</code> is the <a class="link" href="GtkTreeModel.html#GtkTreePath"><span class="type">GtkTreePath</span></a> of the active item.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= -1</p>
|
||
<p>Default value: -1</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--active-id"></a><h3>The <code class="literal">“active-id”</code> property</h3>
|
||
<pre class="programlisting"> “active-id” <span class="type">char</span> *</pre>
|
||
<p>The value of the ID column of the active row.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--add-tearoffs"></a><h3>The <code class="literal">“add-tearoffs”</code> property</h3>
|
||
<pre class="programlisting"> “add-tearoffs” <span class="type">gboolean</span></pre>
|
||
<p>The add-tearoffs property controls whether generated menus
|
||
have tearoff menu items.</p>
|
||
<p>Note that this only affects menu style combo boxes.</p>
|
||
<div class="warning"><p><code class="literal">GtkComboBox:add-tearoffs</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: FALSE</p>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--button-sensitivity"></a><h3>The <code class="literal">“button-sensitivity”</code> property</h3>
|
||
<pre class="programlisting"> “button-sensitivity” <a class="link" href="GtkRange.html#GtkSensitivityType" title="enum GtkSensitivityType"><span class="type">GtkSensitivityType</span></a></pre>
|
||
<p>Whether the dropdown button is sensitive when
|
||
the model is empty.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: GTK_SENSITIVITY_AUTO</p>
|
||
<p class="since">Since: 2.14</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--cell-area"></a><h3>The <code class="literal">“cell-area”</code> property</h3>
|
||
<pre class="programlisting"> “cell-area” <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> *</pre>
|
||
<p>The <a class="link" href="GtkCellArea.html" title="GtkCellArea"><span class="type">GtkCellArea</span></a> used to layout cell renderers for this combo box.</p>
|
||
<p>If no area is specified when creating the combo box with <a class="link" href="GtkComboBox.html#gtk-combo-box-new-with-area" title="gtk_combo_box_new_with_area ()"><code class="function">gtk_combo_box_new_with_area()</code></a>
|
||
a horizontally oriented <a class="link" href="GtkCellAreaBox.html" title="GtkCellAreaBox"><span class="type">GtkCellAreaBox</span></a> will be used.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write / Construct Only</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--column-span-column"></a><h3>The <code class="literal">“column-span-column”</code> property</h3>
|
||
<pre class="programlisting"> “column-span-column” <span class="type">int</span></pre>
|
||
<p>If this is set to a non-negative value, it must be the index of a column
|
||
of type <code class="literal">G_TYPE_INT</code> in the model. The value in that column for each item
|
||
will determine how many columns that item will span in the popup.
|
||
Therefore, values in this column must be greater than zero, and the sum of
|
||
an item’s column position + span should not exceed <a class="link" href="GtkComboBox.html#GtkComboBox--wrap-width" title="The “wrap-width” property"><span class="type">“wrap-width”</span></a>.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= -1</p>
|
||
<p>Default value: -1</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--entry-text-column"></a><h3>The <code class="literal">“entry-text-column”</code> property</h3>
|
||
<pre class="programlisting"> “entry-text-column” <span class="type">int</span></pre>
|
||
<p>The column in the combo box's model to associate with strings from the entry
|
||
if the combo was created with <a class="link" href="GtkComboBox.html#GtkComboBox--has-entry" title="The “has-entry” property"><span class="type">“has-entry”</span></a> = <code class="literal">TRUE</code>.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= -1</p>
|
||
<p>Default value: -1</p>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--has-entry"></a><h3>The <code class="literal">“has-entry”</code> property</h3>
|
||
<pre class="programlisting"> “has-entry” <span class="type">gboolean</span></pre>
|
||
<p>Whether the combo box has an entry.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write / Construct Only</p>
|
||
<p>Default value: FALSE</p>
|
||
<p class="since">Since: 2.24</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--has-frame"></a><h3>The <code class="literal">“has-frame”</code> property</h3>
|
||
<pre class="programlisting"> “has-frame” <span class="type">gboolean</span></pre>
|
||
<p>The has-frame property controls whether a frame
|
||
is drawn around the entry.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
<p class="since">Since: 2.6</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--id-column"></a><h3>The <code class="literal">“id-column”</code> property</h3>
|
||
<pre class="programlisting"> “id-column” <span class="type">int</span></pre>
|
||
<p>The column in the combo box's model that provides string
|
||
IDs for the values in the model, if != -1.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= -1</p>
|
||
<p>Default value: -1</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--model"></a><h3>The <code class="literal">“model”</code> property</h3>
|
||
<pre class="programlisting"> “model” <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a> *</pre>
|
||
<p>The model from which the combo box takes the values shown
|
||
in the list.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--popup-fixed-width"></a><h3>The <code class="literal">“popup-fixed-width”</code> property</h3>
|
||
<pre class="programlisting"> “popup-fixed-width” <span class="type">gboolean</span></pre>
|
||
<p>Whether the popup's width should be a fixed width matching the
|
||
allocated width of the combo box.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: TRUE</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-0.html#api-index-3.0">3.0</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--popup-shown"></a><h3>The <code class="literal">“popup-shown”</code> property</h3>
|
||
<pre class="programlisting"> “popup-shown” <span class="type">gboolean</span></pre>
|
||
<p>Whether the combo boxes dropdown is popped up.
|
||
Note that this property is mainly useful, because
|
||
it allows you to connect to notify::popup-shown.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: FALSE</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--row-span-column"></a><h3>The <code class="literal">“row-span-column”</code> property</h3>
|
||
<pre class="programlisting"> “row-span-column” <span class="type">int</span></pre>
|
||
<p>If this is set to a non-negative value, it must be the index of a column
|
||
of type <code class="literal">G_TYPE_INT</code> in the model. The value in that column for each item
|
||
will determine how many rows that item will span in the popup. Therefore,
|
||
values in this column must be greater than zero.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= -1</p>
|
||
<p>Default value: -1</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--tearoff-title"></a><h3>The <code class="literal">“tearoff-title”</code> property</h3>
|
||
<pre class="programlisting"> “tearoff-title” <span class="type">char</span> *</pre>
|
||
<p>A title that may be displayed by the window manager
|
||
when the popup is torn-off.</p>
|
||
<div class="warning"><p><code class="literal">GtkComboBox:tearoff-title</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Default value: NULL</p>
|
||
<p class="since">Since: 2.10</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--wrap-width"></a><h3>The <code class="literal">“wrap-width”</code> property</h3>
|
||
<pre class="programlisting"> “wrap-width” <span class="type">int</span></pre>
|
||
<p>If wrap-width is set to a positive value, items in the popup will be laid
|
||
out along multiple columns, starting a new row on reaching the wrap width.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read / Write</p>
|
||
<p>Allowed values: >= 0</p>
|
||
<p>Default value: 0</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.style-property-details"></a><h2>Style Property Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--s-appears-as-list"></a><h3>The <code class="literal">“appears-as-list”</code> style property</h3>
|
||
<pre class="programlisting"> “appears-as-list” <span class="type">gboolean</span></pre>
|
||
<p>Whether dropdowns should look like lists rather than menus.</p>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: FALSE</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--s-arrow-scaling"></a><h3>The <code class="literal">“arrow-scaling”</code> style property</h3>
|
||
<pre class="programlisting"> “arrow-scaling” <span class="type">float</span></pre>
|
||
<p>Sets the amount of space used up by the combobox arrow,
|
||
proportional to the font size.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkComboBox:arrow-scaling</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>use the standard min-width/min-height CSS properties on
|
||
the arrow node; the value of this style property is ignored.</p>
|
||
</div>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read</p>
|
||
<p>Allowed values: [0,2]</p>
|
||
<p>Default value: 1</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--s-arrow-size"></a><h3>The <code class="literal">“arrow-size”</code> style property</h3>
|
||
<pre class="programlisting"> “arrow-size” <span class="type">int</span></pre>
|
||
<p>Sets the minimum size of the arrow in the combo box. Note
|
||
that the arrow size is coupled to the font size, so in case
|
||
a larger font is used, the arrow will be larger than set
|
||
by arrow size.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkComboBox:arrow-size</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>use the standard min-width/min-height CSS properties on
|
||
the arrow node; the value of this style property is ignored.</p>
|
||
</div>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read</p>
|
||
<p>Allowed values: >= 0</p>
|
||
<p>Default value: 15</p>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox--s-shadow-type"></a><h3>The <code class="literal">“shadow-type”</code> style property</h3>
|
||
<pre class="programlisting"> “shadow-type” <a class="link" href="gtk3-Standard-Enumerations.html#GtkShadowType" title="enum GtkShadowType"><span class="type">GtkShadowType</span></a></pre>
|
||
<p>Which kind of shadow to draw around the combo box.</p>
|
||
<div class="warning">
|
||
<p><code class="literal">GtkComboBox:shadow-type</code> has been deprecated since version 3.20 and should not be used in newly-written code.</p>
|
||
<p>use CSS styling to change the appearance of the combobox
|
||
frame; the value of this style property is ignored.</p>
|
||
</div>
|
||
<p>Owner: GtkComboBox</p>
|
||
<p>Flags: Read</p>
|
||
<p>Default value: GTK_SHADOW_NONE</p>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.signal-details"></a><h2>Signal Details</h2>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox-changed"></a><h3>The <code class="literal">“changed”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *widget,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The changed signal is emitted when the active
|
||
item is changed. The can be due to the user selecting
|
||
a different item from the list, or due to a
|
||
call to <a class="link" href="GtkComboBox.html#gtk-combo-box-set-active-iter" title="gtk_combo_box_set_active_iter ()"><code class="function">gtk_combo_box_set_active_iter()</code></a>.
|
||
It will also be emitted while typing into the entry of a combo box
|
||
with an entry.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkComboBox-changed.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>widget</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
<p class="since">Since: 2.4</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox-format-entry-text"></a><h3>The <code class="literal">“format-entry-text”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">char</span>*
|
||
user_function (<a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *combo,
|
||
<span class="type">char</span> *path,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>For combo boxes that are created with an entry (See GtkComboBox:has-entry).</p>
|
||
<p>A signal which allows you to change how the text displayed in a combo box's
|
||
entry is displayed.</p>
|
||
<p>Connect a signal handler which returns an allocated string representing
|
||
<em class="parameter"><code>path</code></em>
|
||
. That string will then be used to set the text in the combo box's entry.
|
||
The default signal handler uses the text from the GtkComboBox::entry-text-column
|
||
model column.</p>
|
||
<p>Here's an example signal handler which fetches data from the model and
|
||
displays it in the entry.</p>
|
||
<div class="informalexample">
|
||
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
|
||
<tbody>
|
||
<tr>
|
||
<td class="listing_lines" align="right"><pre>1
|
||
2
|
||
3
|
||
4
|
||
5
|
||
6
|
||
7
|
||
8
|
||
9
|
||
10
|
||
11
|
||
12
|
||
13
|
||
14
|
||
15
|
||
16
|
||
17
|
||
18</pre></td>
|
||
<td class="listing_code"><pre class="programlisting"><span class="k">static</span> <span class="n">gchar</span><span class="o">*</span>
|
||
<span class="nf">format_entry_text_callback</span> <span class="p">(</span><span class="n">GtkComboBox</span> <span class="o">*</span><span class="n">combo</span><span class="p">,</span>
|
||
<span class="k">const</span> <span class="n">gchar</span> <span class="o">*</span><span class="n">path</span><span class="p">,</span>
|
||
<span class="n">gpointer</span> <span class="n">user_data</span><span class="p">)</span>
|
||
<span class="p">{</span>
|
||
<span class="n">GtkTreeIter</span> <span class="n">iter</span><span class="p">;</span>
|
||
<span class="n">GtkTreeModel</span> <span class="n">model</span><span class="p">;</span>
|
||
<span class="n">gdouble</span> <span class="n">value</span><span class="p">;</span>
|
||
|
||
<span class="n">model</span> <span class="o">=</span> <span class="n">gtk_combo_box_get_model</span> <span class="p">(</span><span class="n">combo</span><span class="p">);</span>
|
||
|
||
<span class="n">gtk_tree_model_get_iter_from_string</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span> <span class="n">path</span><span class="p">);</span>
|
||
<span class="n">gtk_tree_model_get</span> <span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">&</span><span class="n">iter</span><span class="p">,</span>
|
||
<span class="n">THE_DOUBLE_VALUE_COLUMN</span><span class="p">,</span> <span class="o">&</span><span class="n">value</span><span class="p">,</span>
|
||
<span class="o">-</span><span class="mi">1</span><span class="p">);</span>
|
||
|
||
<span class="k">return</span> <span class="n">g_strdup_printf</span> <span class="p">(</span><span class="s">"%g"</span><span class="p">,</span> <span class="n">value</span><span class="p">);</span>
|
||
<span class="p">}</span></pre></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<p></p>
|
||
<div class="refsect3">
|
||
<a name="GtkComboBox-format-entry-text.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>combo</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>path</p></td>
|
||
<td class="parameter_description"><p>the GtkTreePath string from the combo box's current model to format text for</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="GtkComboBox-format-entry-text.returns"></a><h4>Returns</h4>
|
||
<p>a newly allocated string representing <em class="parameter"><code>path</code></em>
|
||
for the current GtkComboBox model. </p>
|
||
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
|
||
</div>
|
||
<p>Flags: Run Last</p>
|
||
<p class="since">Since: <a class="link" href="api-index-3-4.html#api-index-3.4">3.4</a></p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox-move-active"></a><h3>The <code class="literal">“move-active”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *widget,
|
||
<a class="link" href="gtk3-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType"><span class="type">GtkScrollType</span></a> scroll_type,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::move-active signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
|
||
which gets emitted to move the active selection.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkComboBox-move-active.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>widget</p></td>
|
||
<td class="parameter_description"><p>the object that received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>scroll_type</p></td>
|
||
<td class="parameter_description"><p>a <a class="link" href="gtk3-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType"><span class="type">GtkScrollType</span></a></p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox-popdown"></a><h3>The <code class="literal">“popdown”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">gboolean</span>
|
||
user_function (<a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *button,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::popdown signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
|
||
which gets emitted to popdown the combo box list.</p>
|
||
<p>The default bindings for this signal are Alt+Up and Escape.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkComboBox-popdown.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>button</p></td>
|
||
<td class="parameter_description"><p>the object which received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="GtkComboBox-popup"></a><h3>The <code class="literal">“popup”</code> signal</h3>
|
||
<pre class="programlisting"><span class="returnvalue">void</span>
|
||
user_function (<a class="link" href="GtkComboBox.html" title="GtkComboBox"><span class="type">GtkComboBox</span></a> *widget,
|
||
<span class="type">gpointer</span> user_data)</pre>
|
||
<p>The ::popup signal is a
|
||
<a class="link" href="gtk3-Bindings.html#GtkBindingSignal" title="struct GtkBindingSignal">keybinding signal</a>
|
||
which gets emitted to popup the combo box list.</p>
|
||
<p>The default binding for this signal is Alt+Down.</p>
|
||
<div class="refsect3">
|
||
<a name="GtkComboBox-popup.parameters"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table class="informaltable" width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>widget</p></td>
|
||
<td class="parameter_description"><p>the object that received the signal</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>user_data</p></td>
|
||
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<p>Flags: Action</p>
|
||
<p class="since">Since: 2.12</p>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="GtkComboBox.see-also"></a><h2>See Also</h2>
|
||
<p><a class="link" href="GtkComboBoxText.html" title="GtkComboBoxText"><span class="type">GtkComboBoxText</span></a>, <a class="link" href="GtkTreeModel.html" title="GtkTreeModel"><span class="type">GtkTreeModel</span></a>, <a class="link" href="GtkCellRenderer.html" title="GtkCellRenderer"><span class="type">GtkCellRenderer</span></a></p>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>Generated by GTK-Doc V1.33.0</div>
|
||
</body>
|
||
</html> |