gem-graph-client/doc/docbook/d5/d03/left_8c.xml

109 lines
5.1 KiB
XML
Raw Normal View History

<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="_left_8c" xml:lang="en-US">
<title>src/widget/main_window/topbar/left.c File Reference</title>
<indexterm><primary>src/widget/main_window/topbar/left.c</primary></indexterm>
<para>
<para>Topbar left. </para>
</para>
<programlisting linenumbering="unnumbered">#include &quot;../../../../include/base.h&quot;<?linebreak?>#include &quot;../../../../include/signal.h&quot;<?linebreak?>#include &quot;../../../../include/widget.h&quot;<?linebreak?>#include &quot;../../../../include/fsm.h&quot;<?linebreak?></programlisting><simplesect>
<title>Macros </title>
<itemizedlist>
<listitem><para><anchor xml:id="_left_8c_1a1f11849629657b36a7a936043e1790ca"/>#define <emphasis role="strong">YOU_WANT_TO_START_ON_ANOTHER_PAGE</emphasis>&#160;&#160;&#160;0</para>
<para>default == SYNTH </para>
</listitem>
</itemizedlist>
</simplesect>
<simplesect>
<title>Functions </title>
<itemizedlist>
<listitem><para>const char * <link linkend="_left_8c_1a3d0f8c7b9545a6da3464060dad7990db">widget_get_btt_label_synth</link> ()</para>
<para>! WARNING ! THE LABELS OF THE PREVIOUS FOUR BUTTONS MUST ONLY BE DEFINED ONCE IN THE PROGRAMME (HERE), AND ONLY USING THE FOUR FOLLOWING FUNCTIONS: </para>
</listitem>
<listitem><para><anchor xml:id="_left_8c_1a22ed4aed09c29d9f8c72dbe7ced53e2c"/>const char * <emphasis role="strong">widget_get_btt_label_state</emphasis> ()</para>
<para>btt_state </para>
</listitem>
<listitem><para><anchor xml:id="_left_8c_1adea9b5591d51aab274d8c275045d778c"/>const char * <emphasis role="strong">widget_get_btt_label_rules</emphasis> ()</para>
<para>btt_rules </para>
</listitem>
<listitem><para><anchor xml:id="_left_8c_1a136322baea0729a8dfbc5c9b1bc0667e"/>const char * <emphasis role="strong">widget_get_btt_label_data</emphasis> ()</para>
<para>btt_data <?linebreak?> </para>
</listitem>
<listitem><para>void <link linkend="_left_8c_1a45d8a02844578e1c13d8b86b74e3c8b0">window_design_topbar_left</link> (GtkWidget *header_bar)</para>
<para>The rules page consists of two half-pages in a GtkPaned widget : </para>
</listitem>
</itemizedlist>
</simplesect>
<section>
<title>Detailed Description</title>
<para>Topbar left. </para>
</section>
<section>
<title>Function Documentation</title>
<anchor xml:id="_left_8c_1a3d0f8c7b9545a6da3464060dad7990db"/><section>
<title>widget_get_btt_label_synth()</title>
<indexterm><primary>widget_get_btt_label_synth</primary><secondary>left.c</secondary></indexterm>
<indexterm><primary>left.c</primary><secondary>widget_get_btt_label_synth</secondary></indexterm>
<para><computeroutput>const char * widget_get_btt_label_synth ( )</computeroutput></para><para>
<para>! WARNING ! THE LABELS OF THE PREVIOUS FOUR BUTTONS MUST ONLY BE DEFINED ONCE IN THE PROGRAMME (HERE), AND ONLY USING THE FOUR FOLLOWING FUNCTIONS: </para>
</para>
<para>btt_synth </para>
</section>
<anchor xml:id="_left_8c_1a45d8a02844578e1c13d8b86b74e3c8b0"/><section>
<title>window_design_topbar_left()</title>
<indexterm><primary>window_design_topbar_left</primary><secondary>left.c</secondary></indexterm>
<indexterm><primary>left.c</primary><secondary>window_design_topbar_left</secondary></indexterm>
<para><computeroutput>void window_design_topbar_left (GtkWidget * header_bar)</computeroutput></para><para>
<para>The rules page consists of two half-pages in a GtkPaned widget : </para>
</para>
<para><itemizedlist>
<listitem>
<para>on the left, widgets for controlling or editing all the rules.</para>
</listitem><listitem>
<para>on the right, widgets for controlling or editing the selected rule.</para>
</listitem></itemizedlist>
</para>
<para>As this division is clear and constant, it is simpler to place these two half-pages at the same hierarchical level as the other full pages like &quot;synth&quot;, &quot;state&quot; or &quot;results&quot;.</para>
<para>So there is no: &quot;widget_get_rules_page()&quot; function. Instead, the distribution: &quot;all rules&quot; versus &quot;the selected one&quot; is moved to the file: &quot;signal&quot;.</para>
<para>It is in the function: static void switch_state_rules_data() { switch (<link linkend="_fsm_8h_1a90ab14081a88752d3721947a4922ee25">fsm_get_state_rules_data()</link>) { ... case (RULES) : GtkPaned *widget_all_vs_selected_one = ... break; ... }</para>
<para>
<formalpara>
<title>
Parameters</title>
<para>
<table frame="all">
<tgroup cols="2" align="left" colsep="1" rowsep="1">
<colspec colwidth="1*"/>
<colspec colwidth="4*"/>
<tbody>
<row>
<entry>*header_bar</entry><entry>
<para></para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</formalpara>
</para>
</section>
</section>
</section>