git.maemo.org Git - hildon/blob - doc/tmpl/hildon-insert-object-dialog.sgml

   1 <!-- ##### SECTION Title ##### -->
   2 HildonInsertObjectDialog
   3
   4 <!-- ##### SECTION Short_Description ##### -->
   5 A dialog that enables the user to embed an object into rich text.
   6
   7 <!-- ##### SECTION Long_Description ##### -->
   8 <para>
   9 #HildonInsertObjectDialog is a dialog that enables the user to insert a
  10 new or existing object into a Multi-line (Rich Text) Editor as an
  11 embedded object.
  12 </para>
  13
  14 <para>
  15 Here's a simple example for using #HildonInsertObjectDialog:
  16
  17 <informalexample>
  18 <programlisting>
  19   GtkWidget *dialog;
  20   gint result;
  21   gchar *name, *mime_type;
  22
  23   dialog = hildon_insert_object_dialog_new(parent);
  24   g_signal_connect(G_OBJECT(dialog), "response",
  25                    G_CALLBACK(response_cb), NULL);
  26   result = gtk_dialog_run(GTK_DIALOG(dialog));
  27
  28   switch (result)
  29     {
  30     case GTK_RESPONSE_OK:
  31       name = hildon_insert_object_dialog_get_name( HILDON_INSERT_OBJECT_DIALOG(dialog) );
  32       mime_type = hildon_insert_object_dialog_get_mime_type( HILDON_INSERT_OBJECT_DIALOG(dialog) );
  33       hildon_insert_object_dialog_set_file( HILDON_INSERT_OBJECT_DIALOG(dialog) );
  34       break;
  35     case HILDON_RESPONSE_INSERT_EXISTING:
  36       break;
  37     default:
  38       break;
  39     }
  40
  41   gtk_widget_destroy(dialog);
  42 </programlisting>
  43 </informalexample>
  44 </para>
  45
  46 <!-- ##### SECTION See_Also ##### -->
  47 <para>
  48
  49 </para>
  50
  51 <!-- ##### MACRO HILDON_RESPONSE_INSERT_EXISTING ##### -->
  52 <para>
  53
  54 </para>
  55
  56
  57
  58 <!-- ##### STRUCT HildonInsertObjectDialog ##### -->
  59 <para>
  60
  61 </para>
  62
  63
  64 <!-- ##### FUNCTION hildon_insert_object_dialog_new ##### -->
  65 <para>
  66
  67 </para>
  68
  69 @parent:
  70 @Returns:
  71
  72
  73 <!-- ##### FUNCTION hildon_insert_object_dialog_get_name ##### -->
  74 <para>
  75
  76 </para>
  77
  78 @dialog:
  79 @Returns:
  80
  81