Sophie

Sophie

distrib > PLD > ac > amd64 > media > dist > by-pkgid > fd2761970a77896f276e13daf3a9620f > files > 124

bonobo-devel-1.0.22-7.amd64.rpm

<HTML
><HEAD
><TITLE
>BonoboSelector</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="Bonobo API Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Supporting Classes"
HREF="bonobo-support-utilities.html"><LINK
REL="PREVIOUS"
TITLE="BonoboWrapper"
HREF="bonobo-bonobo-wrapper.html"><LINK
REL="NEXT"
TITLE="bonobo-async"
HREF="bonobo-bonobo-async.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Bonobo API Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="bonobo-bonobo-wrapper.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="bonobo-support-utilities.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="bonobo-bonobo-async.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="BONOBO-BONOBO-SELECTOR"
>BonoboSelector</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN18496"
></A
><H2
>Name</H2
>BonoboSelector&nbsp;--&nbsp;a component selector widget</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN18499"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;

typedef     <A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
>;
typedef     <A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTORCLASS"
>BonoboSelectorClass</A
>;
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="bonobo-bonobo-selector.html#BONOBO-SELECTOR-NEW"
>bonobo_selector_new</A
>             (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *title,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> **interfaces_required);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="bonobo-bonobo-selector.html#BONOBO-SELECTOR-CONSTRUCT"
>bonobo_selector_construct</A
>       (<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
> *sel,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *title,
                                             <GTKDOCLINK
HREF="BONOBOSELECTORWIDGET"
>BonoboSelectorWidget</GTKDOCLINK
> *selector);
<GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      <A
HREF="bonobo-bonobo-selector.html#BONOBO-SELECTOR-GET-SELECTED-ID"
>bonobo_selector_get_selected_id</A
> (<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
> *sel);
<GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      <A
HREF="bonobo-bonobo-selector.html#BONOBO-SELECTOR-GET-SELECTED-NAME"
>bonobo_selector_get_selected_name</A
>
                                            (<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
> *sel);
<GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      <A
HREF="bonobo-bonobo-selector.html#BONOBO-SELECTOR-GET-SELECTED-DESCRIPTION"
>bonobo_selector_get_selected_description</A
>
                                            (<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
> *sel);
<GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      <A
HREF="bonobo-bonobo-selector.html#BONOBO-SELECTOR-SELECT-ID"
>bonobo_selector_select_id</A
>       (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *title,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> **interfaces_required);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18526"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <GTKDOCLINK
HREF="GTKOBJECT"
>GtkObject</GTKDOCLINK
>
   +----<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>
         +----<GTKDOCLINK
HREF="GTKCONTAINER"
>GtkContainer</GTKDOCLINK
>
               +----<GTKDOCLINK
HREF="GTKBIN"
>GtkBin</GTKDOCLINK
>
                     +----<GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
>
                           +----<GTKDOCLINK
HREF="GNOMEDIALOG"
>GnomeDialog</GTKDOCLINK
>
                                 +----BonoboSelector</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18535"
></A
><H2
>Signal Prototypes</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;&quot;<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR-OK"
>ok</A
>&quot;        void        user_function      (<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
> *bonoboselector,
                                            <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);
&quot;<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR-CANCEL"
>cancel</A
>&quot;    void        user_function      (<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
> *bonoboselector,
                                            <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18544"
></A
><H2
>Description</H2
><P
>This <GTKDOCLINK
HREF="GNOMEDIALOG"
>GnomeDialog</GTKDOCLINK
> allows the user to select a component implementing
a set of interfaces. The easiest way to do this in your code is by
using:
  <DIV
CLASS="EXAMPLE"
><A
NAME="AEN18548"
></A
><P
><B
>Example 1. Simple Bonobo/Control selection</B
></P
><TABLE
BORDER="0"
BGCOLOR="#D8F8D8"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>{
	char *interfaces [] = { "IDL:Bonobo/Control:1.0", NULL };
	char *oaf_iid;

	oaf_iid = bonobo_selector_select_id (
		_("Please select a Control"), interfaces);

	g_warning ("You selected '<TT
CLASS="LITERAL"
>s</TT
>'", oaf_iid);

	g_free (oaf_iid);
}
    </PRE
></TD
></TR
></TABLE
></DIV
>
  This will throw up a dialog containing all the available components
implementing the IDL:Bonobo/Control:1.0 interface and list them for
the user to select.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18552"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN18554"
></A
><H3
><A
NAME="BONOBOSELECTOR"
></A
>BonoboSelector</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
	GnomeDialog dialog;

	BonoboSelectorPrivate *priv;
} BonoboSelector;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18559"
></A
><H3
><A
NAME="BONOBOSELECTORCLASS"
></A
>BonoboSelectorClass</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
	GnomeDialogClass parent_class;
	
	void (* ok)	(BonoboSelector *sel);
	void (* cancel)	(BonoboSelector *sel);
} BonoboSelectorClass;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18564"
></A
><H3
><A
NAME="BONOBO-SELECTOR-NEW"
></A
>bonobo_selector_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  bonobo_selector_new             (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *title,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> **interfaces_required);</PRE
></TD
></TR
></TABLE
><P
>Creates a new BonoboSelector widget.  The title of the dialog
is set to <TT
CLASS="PARAMETER"
><I
>title</I
></TT
>, and the list of selectable servers is populated
with those servers which support the interfaces specified in
<TT
CLASS="PARAMETER"
><I
>interfaces_required</I
></TT
>.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18576"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A string which should go in the title of the
BonoboSelector window.</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18581"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>interfaces_required</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A NULL_terminated array of interfaces which a
server must support in order to be listed in the selector.  Defaults
to "IDL:Bonobo/Embeddable:1.0" if no interfaces are listed.</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18586"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A pointer to the newly-created BonoboSelector widget.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18591"
></A
><H3
><A
NAME="BONOBO-SELECTOR-CONSTRUCT"
></A
>bonobo_selector_construct ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  bonobo_selector_construct       (<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
> *sel,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *title,
                                             <GTKDOCLINK
HREF="BONOBOSELECTORWIDGET"
>BonoboSelectorWidget</GTKDOCLINK
> *selector);</PRE
></TD
></TR
></TABLE
><P
>Constructs the innards of a bonobo selector window.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18602"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>sel</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the selector to construct</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18607"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the title for the window</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18612"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>selector</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the component view widget to put inside it.</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18617"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> the constructed widget.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18622"
></A
><H3
><A
NAME="BONOBO-SELECTOR-GET-SELECTED-ID"
></A
>bonobo_selector_get_selected_id ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      bonobo_selector_get_selected_id (<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
> *sel);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18631"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>sel</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A BonoboSelector widget.</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18636"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A newly-allocated string containing the ID of the
currently-selected CORBA server (i.e., the corba server whose name
is highlighted in the list).  The user of this function is
responsible for freeing this. It will give an oaf iid back.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18641"
></A
><H3
><A
NAME="BONOBO-SELECTOR-GET-SELECTED-NAME"
></A
>bonobo_selector_get_selected_name ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      bonobo_selector_get_selected_name
                                            (<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
> *sel);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18650"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>sel</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A BonoboSelector widget.</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18655"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A newly-allocated string containing the name of the
currently-selected CORBA server (i.e., the corba server whose name
is highlighted in the list).  The user of this function is
responsible for freeing this.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18660"
></A
><H3
><A
NAME="BONOBO-SELECTOR-GET-SELECTED-DESCRIPTION"
></A
>bonobo_selector_get_selected_description ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      bonobo_selector_get_selected_description
                                            (<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
> *sel);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18669"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>sel</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A BonoboSelector widget.</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18674"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A newly-allocated string containing the description of the
currently-selected CORBA server (i.e., the corba server whose name
is highlighted in the list).  The user of this function is
responsible for freeing this.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18679"
></A
><H3
><A
NAME="BONOBO-SELECTOR-SELECT-ID"
></A
>bonobo_selector_select_id ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
>*      bonobo_selector_select_id       (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *title,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> **interfaces_required);</PRE
></TD
></TR
></TABLE
><P
>Calls <A
HREF="bonobo-bonobo-selector.html#BONOBO-SELECTOR-NEW"
>bonobo_selector_new</A
>() to create a new
BonoboSelector widget with the specified paramters, <TT
CLASS="PARAMETER"
><I
>title</I
></TT
> and
<TT
CLASS="PARAMETER"
><I
>interfaces_required</I
></TT
>.  Then runs the dialog modally and allows
the user to make a selection.</P
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18692"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>title</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> The title to be used for the dialog.</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18697"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>interfaces_required</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> A list of required interfaces.  See
<A
HREF="bonobo-bonobo-selector.html#BONOBO-SELECTOR-NEW"
>bonobo_selector_new</A
>().</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18703"><SPAN
STYLE="white-space: nowrap"
><I
CLASS="EMPHASIS"
>Returns</I
> :</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
> The Oaf IID of the selected server, or NULL if no server is
selected.  The ID string has been allocated with g_strdup.</P
></TD
></TR
></TBODY
></TABLE
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN18708"
></A
><H2
>Signals</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN18710"
></A
><H3
><A
NAME="BONOBOSELECTOR-OK"
></A
>The &quot;ok&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
> *bonoboselector,
                                            <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18718"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>bonoboselector</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>the object which received the signal.&#13;</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18723"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>user data set when the signal handler was connected.</P
></TD
></TR
></TBODY
></TABLE
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN18728"
></A
><H3
><A
NAME="BONOBOSELECTOR-CANCEL"
></A
>The &quot;cancel&quot; signal</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        user_function                  (<A
HREF="bonobo-bonobo-selector.html#BONOBOSELECTOR"
>BonoboSelector</A
> *bonoboselector,
                                            <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> user_data);</PRE
></TD
></TR
></TABLE
><P
></P
><P
></P
><TABLE
CLASS="VARIABLELIST"
BORDER="0"
CELLSPACING="0"
CELLPADDING="4"
WIDTH="100%"
BGCOLOR="#FFD0D0"
><TBODY
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18736"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>bonoboselector</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>the object which received the signal.&#13;</P
></TD
></TR
><TR
><TD
ALIGN="RIGHT"
VALIGN="TOP"
WIDTH="20%"
><A
NAME="AEN18741"><SPAN
STYLE="white-space: nowrap"
><TT
CLASS="PARAMETER"
><I
>user_data</I
></TT
>&nbsp;:</SPAN
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="80%"
><P
>user data set when the signal handler was connected.</P
></TD
></TR
></TBODY
></TABLE
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="bonobo-bonobo-wrapper.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="bonobo-support-utilities.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="bonobo-bonobo-async.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>BonoboWrapper</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>bonobo-async</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>