Skip to content

GitLab

Commit edacfcb7 authored by BST 2000 Tony Gale's avatar BST 2000 Tony Gale Committed by Tony Gale
Browse files

Start of Section 6. 

Wed Jun 28 13:31:55 BST 2000  Tony Gale <gale@gtk.org>

	* docs/faq/gtk-faq.sgml: Start of Section 6.
parent c5c75ece
Hide whitespace changes
Inline Side-by-side
Showing with 437 additions and 1 deletion
ChangeLog
View file @ edacfcb7
Wed Jun 28 13:31:55 BST 2000 Tony Gale <gale@gtk.org>
* docs/faq/gtk-faq.sgml: Start of Section 6.
Mon Jun 26 19:37:04 2000 Owen Taylor <otaylor@redhat.com>
* configure.in: Put 1.3.1 in warning message, not 1.3.0.
......
ChangeLog.pre-2-0
View file @ edacfcb7
Wed Jun 28 13:31:55 BST 2000 Tony Gale <gale@gtk.org>
* docs/faq/gtk-faq.sgml: Start of Section 6.
Mon Jun 26 19:37:04 2000 Owen Taylor <otaylor@redhat.com>
* configure.in: Put 1.3.1 in warning message, not 1.3.0.
......
ChangeLog.pre-2-10
View file @ edacfcb7
Wed Jun 28 13:31:55 BST 2000 Tony Gale <gale@gtk.org>
* docs/faq/gtk-faq.sgml: Start of Section 6.
Mon Jun 26 19:37:04 2000 Owen Taylor <otaylor@redhat.com>
* configure.in: Put 1.3.1 in warning message, not 1.3.0.
......
ChangeLog.pre-2-2
View file @ edacfcb7
Wed Jun 28 13:31:55 BST 2000 Tony Gale <gale@gtk.org>
* docs/faq/gtk-faq.sgml: Start of Section 6.
Mon Jun 26 19:37:04 2000 Owen Taylor <otaylor@redhat.com>
* configure.in: Put 1.3.1 in warning message, not 1.3.0.
......
ChangeLog.pre-2-4
View file @ edacfcb7
Wed Jun 28 13:31:55 BST 2000 Tony Gale <gale@gtk.org>
* docs/faq/gtk-faq.sgml: Start of Section 6.
Mon Jun 26 19:37:04 2000 Owen Taylor <otaylor@redhat.com>
* configure.in: Put 1.3.1 in warning message, not 1.3.0.
......
ChangeLog.pre-2-6
View file @ edacfcb7
Wed Jun 28 13:31:55 BST 2000 Tony Gale <gale@gtk.org>
* docs/faq/gtk-faq.sgml: Start of Section 6.
Mon Jun 26 19:37:04 2000 Owen Taylor <otaylor@redhat.com>
* configure.in: Put 1.3.1 in warning message, not 1.3.0.
......
ChangeLog.pre-2-8
View file @ edacfcb7
Wed Jun 28 13:31:55 BST 2000 Tony Gale <gale@gtk.org>
* docs/faq/gtk-faq.sgml: Start of Section 6.
Mon Jun 26 19:37:04 2000 Owen Taylor <otaylor@redhat.com>
* configure.in: Put 1.3.1 in warning message, not 1.3.0.
......
docs/faq/gtk-faq.sgml
View file @ edacfcb7
......@@ -2,7 +2,7 @@
<book>
<bookinfo>
<date>June 26th 2000</date>
<date>June 28th 2000</date>
<title>GTK+ FAQ</title>
<authorgroup>
<author>
......@@ -2091,6 +2091,414 @@ gint gtk_clist_prepend (GtkCList *clist,
gdk_pixmap_unref (pixmap_mask);
</programlisting>
</sect2>
</sect1>
</chapter>
<!-- ***************************************************************** -->
<chapter>
<title>Development with GTK+: widget specific questions</title>
<sect1>
<title></title>
<!-- ----------------------------------------------------------------- -->
<sect2>
<title>How do I find out about the selection of a GtkList?</title>
<para>Get the selection something like this:</para>
<programlisting role="C">
GList *sel;
sel = GTK_LIST(list)->selection;
</programlisting>
<para>This is how GList is defined (quoting glist.h):</para>
<programlisting role="C">
typedef struct _GList GList;
struct _GList
{
gpointer data;
GList *next;
GList *prev;
};
</programlisting>
<para>A GList structure is just a simple structure for doubly
linked lists. there exist several g_list_*() functions to
modify a linked list in glib.h. However the
GTK_LIST(MyGtkList)->selection is maintained by the
gtk_list_*() functions and should not be modified.</para>
<para>The selection_mode of the GtkList determines the
selection facilities of a GtkList and therefore the contents
of GTK_LIST(AnyGtkList)->selection:</para>
<informaltable frame="all">
<tgroup cols="2">
<thead>
<row>
<entry><literal>selection_mode</literal></entry>
<entry><literal> GTK_LIST()->selection</literal>
contents</entry>
</row>
</thead>
<tbody>
<row>
<entry><literal>GTK_SELECTION_SINGLE</literal></entry>
<entry>selection is either NULL or contains a GList*
pointer for a single selected item.</entry>
</row>
<row>
<entry><literal>GTK_SELECTION_BROWSE</literal></entry>
<entry>selection is NULL if the list contains no
widgets, otherwise it contains a GList*
pointer for one GList structure.</entry>
</row>
<row>
<entry><literal>GTK_SELECTION_MULTIPLE</literal></entry>
<entry>selection is NULL if no listitems are selected
or a a GList* pointer for the first selected
item. that in turn points to a GList structure
for the second selected item and so
on.</entry>
</row>
<row>
<entry><literal>GTK_SELECTION_EXTENDED</literal></entry>
<entry>selection is NULL.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<para>The data field of the GList structure
GTK_LIST(MyGtkList)->selection points to the first
GtkListItem that is selected. So if you would like to
determine which listitems are selected you should go like
this:</para>
<programlisting role="C">
{
gchar *list_items[]={
"Item0",
"Item1",
"foo",
"last Item",
};
guint nlist_items=sizeof(list_items)/sizeof(list_items[0]);
GtkWidget *list_item;
guint i;
list=gtk_list_new();
gtk_list_set_selection_mode(GTK_LIST(list), GTK_SELECTION_MULTIPLE);
gtk_container_add(GTK_CONTAINER(AnyGtkContainer), list);
gtk_widget_show (list);
for (i = 0; i < nlist_items; i++)
{
list_item=gtk_list_item_new_with_label(list_items[i]);
gtk_object_set_user_data(GTK_OBJECT(list_item), (gpointer)i);
gtk_container_add(GTK_CONTAINER(list), list_item);
gtk_widget_show(list_item);
}
}
</programlisting>
<para>To get known about the selection:</para>
<programlisting role="C">
{
GList *items;
items=GTK_LIST(list)->selection;
printf("Selected Items: ");
while (items) {
if (GTK_IS_LIST_ITEM(items->data))
printf("%d ", (guint)
gtk_object_get_user_data(items->data));
items=items->next;
}
printf("\n");
}
</programlisting>
</sect2>
<!-- ----------------------------------------------------------------- -->
<sect2>
<title>How do I stop the column headings of a GtkCList
disappearing when the list is scrolled?</title>
<para>This happens when a GtkCList is packed into a
GtkScrolledWindow using the function
<literal>gtk_scroll_window_add_with_viewport()</literal>. The prefered
method of adding a CList to a scrolled window is to use the
function <literal>gtk_container_add</literal>, as in:</para>
<programlisting role="C">
GtkWidget *scrolled, *clist;
char *titles[] = { "Title1" , "Title2" };
scrolled = gtk_scrolled_window_new(NULL, NULL);
clist = gtk_clist_new_with_titles(2, titles);
gtk_container_add(GTK_CONTAINER(scrolled), clist);
</programlisting>
</sect2>
<!-- ----------------------------------------------------------------- -->
<sect2>
<title>I don't want the user of my applications to enter text
into a GtkCombo. Any idea?</title>
<para>A GtkCombo has an associated entry which can be accessed
using the following expression:</para>
<programlisting role="C">
GTK_COMBO(combo_widget)->entry
</programlisting>
<para>If you don't want the user to be able to modify the
content of this entry, you can use the
gtk_entry_set_editable() function:</para>
<programlisting role="C">
void gtk_entry_set_editable(GtkEntry *entry,
gboolean editable);
</programlisting>
<para>Set the editable parameter to FALSE to disable typing
into the entry.</para>
</sect2>
<!-- ----------------------------------------------------------------- -->
<sect2>
<title>How do I catch a combo box change?</title>
<para>The entry which is associated to your GtkCombo send a
"changed" signal when:</para>
<itemizedlist>
<listitem><simpara>some text is typed in</simpara>
</listitem>
<listitem><simpara>the selection of the combo box is changed</simpara>
</listitem>
</itemizedlist>
<para>To catch any combo box change, simply connect your
signal handler with</para>
<programlisting role="C">
gtk_signal_connect(GTK_COMBO(cb)->entry,
"changed",
GTK_SIGNAL_FUNC(my_cb_change_handler),
NULL);
</programlisting>
</sect2>
<!-- ----------------------------------------------------------------- -->
<sect2>
<title>How can I define a separation line in a menu?</title>
<para>See the <ulink
url="http://www.gtk.org/tutorial/">Tutorial</ulink> for
information on how to create menus. However, to create a
separation line in a menu, just insert an empty menu item:</para>
<programlisting role="C">
menuitem = gtk_menu_item_new();
gtk_menu_append(GTK_MENU(menu), menuitem);
gtk_widget_show(menuitem);
</programlisting>
</sect2>
<!-- ----------------------------------------------------------------- -->
<sect2>
<title>How can I right justify a menu, such as Help?</title>
<para>Depending on if you use the MenuFactory or not, there
are two ways to proceed. With the MenuFactory, use something
like the following:</para>
<programlisting role="C">
menu_path = gtk_menu_factory_find (factory, "&lt;MyApp&gt;/Help");
gtk_menu_item_right_justify(menu_path->widget);
</programlisting>
<para>If you do not use the MenuFactory, you should simply
use:</para>
<programlisting role="C">
gtk_menu_item_right_justify(my_menu_item);
</programlisting>
</sect2>
<!-- ----------------------------------------------------------------- -->
<sect2>
<title>How do I add some underlined accelerators to menu
items?</title>
<para>Damon Chaplin, the technical force behind the Glade
project, provided the following code sample (this code is an
output from Glade). It creates a small <GUIMenu>File</guimenu> menu item
with only one child (<guimenu>New</guimenu>). The F in <guimenu>File</guimenu> and the N
in <guimenu>New</guimenu> are underlined, and the relevant accelerators are
created.</para>
<programlisting role="C">
menubar1 = gtk_menu_bar_new ();
gtk_object_set_data (GTK_OBJECT (window1), "menubar1", menubar1);
gtk_widget_show (menubar1);
gtk_box_pack_start (GTK_BOX (vbox1), menubar1, FALSE, FALSE, 0);
file1 = gtk_menu_item_new_with_label ("");
tmp_key = gtk_label_parse_uline (GTK_LABEL (GTK_BIN (file1)->child),
_("_File"));
gtk_widget_add_accelerator (file1, "activate_item", accel_group,
tmp_key, GDK_MOD1_MASK, 0);
gtk_object_set_data (GTK_OBJECT (window1), "file1", file1);
gtk_widget_show (file1);
gtk_container_add (GTK_CONTAINER (menubar1), file1);
file1_menu = gtk_menu_new ();
file1_menu_accels = gtk_menu_ensure_uline_accel_group (GTK_MENU (file1_menu));
gtk_object_set_data (GTK_OBJECT (window1), "file1_menu", file1_menu);
gtk_menu_item_set_submenu (GTK_MENU_ITEM (file1), file1_menu);
new1 = gtk_menu_item_new_with_label ("");
tmp_key = gtk_label_parse_uline (GTK_LABEL (GTK_BIN (new1)->child),
_("_New"));
gtk_widget_add_accelerator (new1, "activate_item", file1_menu_accels,
tmp_key, 0, 0);
gtk_object_set_data (GTK_OBJECT (window1), "new1", new1);
gtk_widget_show (new1);
gtk_container_add (GTK_CONTAINER (file1_menu), new1);
</programlisting>
</sect2>
<!-- ----------------------------------------------------------------- -->
<sect2>
<title>How can I retrieve the text from a GtkMenuItem?</title>
<para>You can usually retrieve the label of a specific
GtkMenuItem with:</para>
<programlisting role="C">
if (GTK_BIN (menu_item)->child)
{
GtkWidget *child = GTK_BIN (menu_item)->child;
/* do stuff with child */
if (GTK_IS_LABEL (child))
{
gchar *text;
gtk_label_get (GTK_LABEL (child), &amp;text);
g_print ("menu item text: %s\n", text);
}
}
</programlisting>
<para>To get the active menu item from a GtkOptionMenu you can
do:</para>
<programlisting role="C">
if (GTK_OPTION_MENU (option_menu)->menu_item)
{
GtkWidget *menu_item = GTK_OPTION_MENU (option_menu)->menu_item;
}
</programlisting>
<para>But, there's a catch. For this specific case, you can
<emphasis>not</emphasis> get the label widget from
<literal>menu_item</literal> with the above code, because the
option menu reparents the menu_item's child temporarily to
display the currently active contents. So to retrive the child
of the currently active menu_item of an option menu, you'll
have to do:</para>
<programlisting role="C">
if (GTK_BIN (option_menu)->child)
{
GtkWidget *child = GTK_BIN (option_menu)->child;
/* do stuff with child */
}
</programlisting>
</sect2>
<!-- ----------------------------------------------------------------- -->
<sect2>
<title>How do I right (or otherwise) justify a
GtkLabel?</title>
<para>Are you sure you want to <emphasis>justify</emphasis>
the labels? The label class contains the
<literal>gtk_label_set_justify()</literal> function that is
used to control the justification of a multi-line
label.</para>
<para>What you probably want is to set the <emphasis>alignment</emphasis>
of the label, ie right align it, center it or left align
it. If you want to do this, you should use:</para>
<programlisting role="C">
void gtk_misc_set_alignment (GtkMisc *misc,
gfloat xalign,
gfloat yalign);
</programlisting>
<para>where the <literal>xalign</literal> and
<literal>yalign</literal> values are floats in
[0.00;1.00].</para>
<programlisting role="C">
GtkWidget *label;
/* horizontal : left align, vertical : top */
gtk_misc_set_alignment(GTK_MISK(label), 0.0f, 0.0f);
/* horizontal : centered, vertical : centered */
gtk_misc_set_alignment(GTK_MISK(label), 0.5f, 0.5f);
/* horizontal : right align, vertical : bottom */
gtk_misc_set_alignment(GTK_MISK(label), 1.0f, 1.0f);
</programlisting>
</sect2>
<!-- ----------------------------------------------------------------- -->
<sect2>
<title>How do I set the background color of a GtkLabel
widget?</title>
<para>The Gtklabel widget is one of a few GTK+ widgets that
don't create their own window to render themselves
into. Instead, they draw themselves directly onto their
parents window.</para>
<para>This means that in order to set the background color for
a GtkLabel widget, you need to change the background color of
its parent, i.e. the object that you pack it into.</para>
</sect2>
</sect1>
</chapter>
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment