<HTML ><HEAD ><TITLE >BonoboUIContainer</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="Bonobo UI" HREF="bonobo-ui.html"><LINK REL="PREVIOUS" TITLE="BonoboUIComponent" HREF="bonobo-bonobo-ui-component.html"><LINK REL="NEXT" TITLE="bonobo-ui-util" HREF="bonobo-bonobo-ui-util.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-ui-component.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><<< 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-ui.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-ui-util.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ></TABLE ></DIV ><H1 ><A NAME="BONOBO-BONOBO-UI-CONTAINER" >BonoboUIContainer</A ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN13651" ></A ><H2 >Name</H2 >BonoboUIContainer -- The container interface as implemented for BonoboWindow</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN13654" ></A ><H2 >Synopsis</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > typedef <A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A >; typedef <A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINERCLASS" >BonoboUIContainerClass</A >; <A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A >* <A HREF="bonobo-bonobo-ui-container.html#BONOBO-UI-CONTAINER-CONSTRUCT" >bonobo_ui_container_construct</A > (<A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A > *container, <GTKDOCLINK HREF="BONOBO-UICONTAINER" >Bonobo_UIContainer</GTKDOCLINK > corba_container); <A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A >* <A HREF="bonobo-bonobo-ui-container.html#BONOBO-UI-CONTAINER-NEW" >bonobo_ui_container_new</A > (void); <GTKDOCLINK HREF="BONOBOUIENGINE" >BonoboUIEngine</GTKDOCLINK >* <A HREF="bonobo-bonobo-ui-container.html#BONOBO-UI-CONTAINER-GET-ENGINE" >bonobo_ui_container_get_engine</A > (<A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A > *container); void <A HREF="bonobo-bonobo-ui-container.html#BONOBO-UI-CONTAINER-SET-ENGINE" >bonobo_ui_container_set_engine</A > (<A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A > *container, <GTKDOCLINK HREF="BONOBOUIENGINE" >BonoboUIEngine</GTKDOCLINK > *engine); void <A HREF="bonobo-bonobo-ui-container.html#BONOBO-UI-CONTAINER-SET-WIN" >bonobo_ui_container_set_win</A > (<A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A > *container, <GTKDOCLINK HREF="BONOBOWINDOW" >BonoboWindow</GTKDOCLINK > *win); <GTKDOCLINK HREF="BONOBOWINDOW" >BonoboWindow</GTKDOCLINK >* <A HREF="bonobo-bonobo-ui-container.html#BONOBO-UI-CONTAINER-GET-WIN" >bonobo_ui_container_get_win</A > (<A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A > *container); </PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN13677" ></A ><H2 >Object Hierarchy</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > <GTKDOCLINK HREF="GTKOBJECT" >GtkObject</GTKDOCLINK > +----<A HREF="bonobo-bonobo-object.html#BONOBOOBJECT" >BonoboObject</A > +----<GTKDOCLINK HREF="BONOBOXOBJECT" >BonoboXObject</GTKDOCLINK > +----BonoboUIContainer</PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN13683" ></A ><H2 >Description</H2 ><P >A BonoboUIContainer is a very thin object, it implements the CORBA interface for doing UI merging, but none of the logic. In order to achieve the effect it is associated with a BonoboUIEngine object. Traditionaly the UI container was associated with a <GTKDOCLINK HREF="BONOBOWINDOW" >BonoboWindow</GTKDOCLINK > however, this is now strongly deprecated, since the BonoboUIContainer can be used with any <GTKDOCLINK HREF="BONOBOUIENGINE" >BonoboUIEngine</GTKDOCLINK >, not just that used by BonoboWindow.</P ><P >Here is how your code should interact with the BonoboUIContainer <DIV CLASS="EXAMPLE" ><A NAME="AEN13689" ></A ><P ><B >Example 1. How to setup a BonoboUIContainer</B ></P ><TABLE BORDER="0" BGCOLOR="#D8F8D8" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >{ BonoboWindow *window; BonoboUIEngine *engine; BonoboUIContainer *container; window = BONOBO_WINDOW ( bonobo_window_new ("Window", "My Test Application")); container = <A HREF="bonobo-bonobo-ui-container.html#BONOBO-UI-CONTAINER-NEW" >bonobo_ui_container_new</A >(); engine = bonobo_window_get_ui_engine (window); bonobo_ui_container_set_engine (container, engine); return window; } </PRE ></TD ></TR ></TABLE ></DIV ></P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN13693" ></A ><H2 >Details</H2 ><DIV CLASS="REFSECT2" ><A NAME="AEN13695" ></A ><H3 ><A NAME="BONOBOUICONTAINER" ></A >BonoboUIContainer</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >typedef struct { BonoboXObject base; BonoboUIContainerPrivate *priv; /* For backwards compatibility, strongly deprecated */ BonoboWindow *win; } BonoboUIContainer;</PRE ></TD ></TR ></TABLE ><P ></P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN13700" ></A ><H3 ><A NAME="BONOBOUICONTAINERCLASS" ></A >BonoboUIContainerClass</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >typedef struct { BonoboXObjectClass parent; POA_Bonobo_UIContainer__epv epv; } BonoboUIContainerClass;</PRE ></TD ></TR ></TABLE ><P ></P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN13705" ></A ><H3 ><A NAME="BONOBO-UI-CONTAINER-CONSTRUCT" ></A >bonobo_ui_container_construct ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A >* bonobo_ui_container_construct (<A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A > *container, <GTKDOCLINK HREF="BONOBO-UICONTAINER" >Bonobo_UIContainer</GTKDOCLINK > corba_container);</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="AEN13714"><SPAN STYLE="white-space: nowrap" ><TT CLASS="PARAMETER" ><I >container</I ></TT > :</SPAN ></TD ><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="80%" ><P ></P ></TD ></TR ><TR ><TD ALIGN="RIGHT" VALIGN="TOP" WIDTH="20%" ><A NAME="AEN13719"><SPAN STYLE="white-space: nowrap" ><TT CLASS="PARAMETER" ><I >corba_container</I ></TT > :</SPAN ></TD ><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="80%" ><P ></P ></TD ></TR ><TR ><TD ALIGN="RIGHT" VALIGN="TOP" WIDTH="20%" ><A NAME="AEN13724"><SPAN STYLE="white-space: nowrap" ><I CLASS="EMPHASIS" >Returns</I > :</SPAN ></TD ><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="80%" ><P > </P ></TD ></TR ></TBODY ></TABLE ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN13729" ></A ><H3 ><A NAME="BONOBO-UI-CONTAINER-NEW" ></A >bonobo_ui_container_new ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A >* bonobo_ui_container_new (void);</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="AEN13737"><SPAN STYLE="white-space: nowrap" ><I CLASS="EMPHASIS" >Returns</I > :</SPAN ></TD ><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="80%" ><P > a newly created BonoboUIContainer</P ></TD ></TR ></TBODY ></TABLE ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN13742" ></A ><H3 ><A NAME="BONOBO-UI-CONTAINER-GET-ENGINE" ></A >bonobo_ui_container_get_engine ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="BONOBOUIENGINE" >BonoboUIEngine</GTKDOCLINK >* bonobo_ui_container_get_engine (<A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A > *container);</PRE ></TD ></TR ></TABLE ><P >Get the associated <GTKDOCLINK HREF="BONOBOUIENGINE" >BonoboUIEngine</GTKDOCLINK ></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="AEN13752"><SPAN STYLE="white-space: nowrap" ><TT CLASS="PARAMETER" ><I >container</I ></TT > :</SPAN ></TD ><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="80%" ><P > the UI container</P ></TD ></TR ><TR ><TD ALIGN="RIGHT" VALIGN="TOP" WIDTH="20%" ><A NAME="AEN13757"><SPAN STYLE="white-space: nowrap" ><I CLASS="EMPHASIS" >Returns</I > :</SPAN ></TD ><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="80%" ><P > the engine</P ></TD ></TR ></TBODY ></TABLE ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN13762" ></A ><H3 ><A NAME="BONOBO-UI-CONTAINER-SET-ENGINE" ></A >bonobo_ui_container_set_engine ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void bonobo_ui_container_set_engine (<A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A > *container, <GTKDOCLINK HREF="BONOBOUIENGINE" >BonoboUIEngine</GTKDOCLINK > *engine);</PRE ></TD ></TR ></TABLE ><P >Associates the BonoboUIContainer with a <GTKDOCLINK HREF="BONOBOUIENGINE" >BonoboUIEngine</GTKDOCLINK > that it will use to handle all the UI merging requests.</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="AEN13772"><SPAN STYLE="white-space: nowrap" ><TT CLASS="PARAMETER" ><I >container</I ></TT > :</SPAN ></TD ><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="80%" ><P > the container</P ></TD ></TR ><TR ><TD ALIGN="RIGHT" VALIGN="TOP" WIDTH="20%" ><A NAME="AEN13777"><SPAN STYLE="white-space: nowrap" ><TT CLASS="PARAMETER" ><I >engine</I ></TT > :</SPAN ></TD ><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="80%" ><P > the engine</P ></TD ></TR ></TBODY ></TABLE ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN13782" ></A ><H3 ><A NAME="BONOBO-UI-CONTAINER-SET-WIN" ></A >bonobo_ui_container_set_win ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >void bonobo_ui_container_set_win (<A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A > *container, <GTKDOCLINK HREF="BONOBOWINDOW" >BonoboWindow</GTKDOCLINK > *win);</PRE ></TD ></TR ></TABLE ><P >This function is deprecated, please use bonobo_ui_container_set_engine instead, we plan to allow UIContainers to be associated with many things apart from BonoboWindows.</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="AEN13791"><SPAN STYLE="white-space: nowrap" ><TT CLASS="PARAMETER" ><I >container</I ></TT > :</SPAN ></TD ><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="80%" ><P > the container</P ></TD ></TR ><TR ><TD ALIGN="RIGHT" VALIGN="TOP" WIDTH="20%" ><A NAME="AEN13796"><SPAN STYLE="white-space: nowrap" ><TT CLASS="PARAMETER" ><I >win</I ></TT > :</SPAN ></TD ><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="80%" ><P > a <GTKDOCLINK HREF="BONOBOWINDOW" >BonoboWindow</GTKDOCLINK > widget</P ></TD ></TR ></TBODY ></TABLE ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN13802" ></A ><H3 ><A NAME="BONOBO-UI-CONTAINER-GET-WIN" ></A >bonobo_ui_container_get_win ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="BONOBOWINDOW" >BonoboWindow</GTKDOCLINK >* bonobo_ui_container_get_win (<A HREF="bonobo-bonobo-ui-container.html#BONOBOUICONTAINER" >BonoboUIContainer</A > *container);</PRE ></TD ></TR ></TABLE ><P >This is _extremely_ deprecated, there is no garentee that a BonoboUIContainer has an associated window, this function will spew warnings.</P ><P >If you find yourself wanting to use this function, you probably want to be passing a BonoboWindow ( or derivative ) around and then using:</P ><P >bonobo_window_get_ui_engine (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="AEN13813"><SPAN STYLE="white-space: nowrap" ><TT CLASS="PARAMETER" ><I >container</I ></TT > :</SPAN ></TD ><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="80%" ><P > the BonoboUIContainer</P ></TD ></TR ><TR ><TD ALIGN="RIGHT" VALIGN="TOP" WIDTH="20%" ><A NAME="AEN13818"><SPAN STYLE="white-space: nowrap" ><I CLASS="EMPHASIS" >Returns</I > :</SPAN ></TD ><TD ALIGN="LEFT" VALIGN="TOP" WIDTH="80%" ><P > a BonoboWindow if it is associated.</P ></TD ></TR ></TBODY ></TABLE ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN13823" ></A ><H2 >See Also</H2 ><P ><GTKDOCLINK HREF="BONOBOUICOMPONENT" >BonoboUIComponent</GTKDOCLINK >, <GTKDOCLINK HREF="BONOBOUIENGINE" >BonoboUIEngine</GTKDOCLINK >, <GTKDOCLINK HREF="BONOBOWINDOW" >BonoboWindow</GTKDOCLINK >, <GTKDOCLINK HREF="BONOBOUISYNC" >BonoboUISync</GTKDOCLINK >, <GTKDOCLINK HREF="BONOBO-UI-UTIL" >bonobo-ui-util</GTKDOCLINK ></P ></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-ui-component.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><<< 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-ui.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-ui-util.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ><TR ><TD COLSPAN="2" ALIGN="left" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >BonoboUIComponent</B ></FONT ></TD ><TD COLSPAN="2" ALIGN="right" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >bonobo-ui-util</B ></FONT ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >