Pileus Git - ~andy/gtk/blob - docs/reference/gtk/tmpl/gtkarg.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 Implementation of Object Properties
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 Utility function to manipulate lists of named, typed arguments.
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 All the functions in here are marked a Non-public.
  10 We describe it anyway because it is occasionally useful
  11 to understand how the work is done.
  12 </para>
  13 <para>
  14 Arguments are a way of describing a named parameter to a function.
  15 They have two important roles within gtk+:
  16 <itemizedlist>
  17 <listitem>
  18 <para>
  19 they describe <wordasword>object properties</wordasword>.
  20 This means that they present an interface to get and set a named-type
  21 for any type of object in a consistent way.
  22 (All the relevant functions to do this start with gtk_object_set
  23 or gtk_object_get).
  24 </para>
  25 </listitem>
  26 <listitem>
  27 <para>
  28 they describe <wordasword>signal arguments</wordasword>.
  29 This is a lot less often needed but still useful.
  30 Usually if you are just emitting or creating a particular signal
  31 it is more convenient to just use gtk_signal_emit() or gtk_signal_new().
  32 However if you are writing a function to emit or create an arbitrary
  33 signal, you must use gtk_signal_emitv() or gtk_signal_newv().
  34 </para>
  35 </listitem>
  36 </itemizedlist>
  37 </para>
  38
  39 <!-- ##### SECTION See_Also ##### -->
  40 <para>
  41 #GtkObject.
  42 </para>
  43