New upstream version 3.24.10
This commit is contained in:
Simon McVittie
@ -8,7 +8,7 @@
|
||||
<link rel="up" href="AbstractObjects.html" title="Abstract Base Classes">
|
||||
<link rel="prev" href="GtkWidget.html" title="GtkWidget">
|
||||
<link rel="next" href="GtkBin.html" title="GtkBin">
|
||||
<meta name="generator" content="GTK-Doc V1.29 (XML mode)">
|
||||
<meta name="generator" content="GTK-Doc V1.30.1 (XML mode)">
|
||||
<link rel="stylesheet" href="style.css" type="text/css">
|
||||
</head>
|
||||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||||
@ -568,33 +568,33 @@ simply calling the reverse apis implemented for itself as follows:</p>
|
||||
25
|
||||
26
|
||||
27</pre></td>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
|
||||
<span class="function">foo_container_get_preferred_height</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">min_height</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">nat_height</span><span class="symbol">)</span>
|
||||
<span class="cbracket">{</span>
|
||||
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i_am_in_height_for_width_mode</span><span class="symbol">)</span>
|
||||
<span class="normal"> </span><span class="cbracket">{</span>
|
||||
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> min_width</span><span class="symbol">;</span>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="k">static</span> <span class="kt">void</span>
|
||||
<span class="nf">foo_container_get_preferred_height</span> <span class="p">(</span><span class="n">GtkWidget</span> <span class="o">*</span><span class="n">widget</span><span class="p">,</span>
|
||||
<span class="n">gint</span> <span class="o">*</span><span class="n">min_height</span><span class="p">,</span>
|
||||
<span class="n">gint</span> <span class="o">*</span><span class="n">nat_height</span><span class="p">)</span>
|
||||
<span class="p">{</span>
|
||||
<span class="k">if</span> <span class="p">(</span><span class="n">i_am_in_height_for_width_mode</span><span class="p">)</span>
|
||||
<span class="p">{</span>
|
||||
<span class="n">gint</span> <span class="n">min_width</span><span class="p">;</span>
|
||||
|
||||
<span class="normal"> </span><span class="function">GTK_WIDGET_GET_CLASS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">)-></span><span class="function">get_preferred_width</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="symbol">&</span><span class="normal">min_width</span><span class="symbol">,</span>
|
||||
<span class="normal"> NULL</span><span class="symbol">);</span>
|
||||
<span class="normal"> </span><span class="function">GTK_WIDGET_GET_CLASS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">)-></span><span class="normal">get_preferred_height_for_width</span>
|
||||
<span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span>
|
||||
<span class="normal"> min_width</span><span class="symbol">,</span>
|
||||
<span class="normal"> min_height</span><span class="symbol">,</span>
|
||||
<span class="normal"> nat_height</span><span class="symbol">);</span>
|
||||
<span class="normal"> </span><span class="cbracket">}</span>
|
||||
<span class="normal"> </span><span class="keyword">else</span>
|
||||
<span class="normal"> </span><span class="cbracket">{</span>
|
||||
<span class="normal"> </span><span class="symbol">...</span><span class="normal"> many containers support both </span><span class="usertype">request</span><span class="normal"> modes</span><span class="symbol">,</span><span class="normal"> execute the</span>
|
||||
<span class="normal"> </span><span class="usertype">real</span><span class="normal"> width</span><span class="symbol">-</span><span class="keyword">for</span><span class="symbol">-</span><span class="normal">height request here by returning the</span>
|
||||
<span class="normal"> collective heights of all widgets that are stacked</span>
|
||||
<span class="normal"> </span><span class="function">vertically</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">or whatever is appropriate </span><span class="keyword">for</span><span class="normal"> </span><span class="usertype">this</span><span class="normal"> container</span><span class="symbol">)</span>
|
||||
<span class="normal"> </span><span class="symbol">...</span>
|
||||
<span class="normal"> </span><span class="cbracket">}</span>
|
||||
<span class="cbracket">}</span></pre></td>
|
||||
<span class="n">GTK_WIDGET_GET_CLASS</span> <span class="p">(</span><span class="n">widget</span><span class="p">)</span><span class="o">-></span><span class="n">get_preferred_width</span> <span class="p">(</span><span class="n">widget</span><span class="p">,</span>
|
||||
<span class="o">&</span><span class="n">min_width</span><span class="p">,</span>
|
||||
<span class="nb">NULL</span><span class="p">);</span>
|
||||
<span class="n">GTK_WIDGET_GET_CLASS</span> <span class="p">(</span><span class="n">widget</span><span class="p">)</span><span class="o">-></span><span class="n">get_preferred_height_for_width</span>
|
||||
<span class="p">(</span><span class="n">widget</span><span class="p">,</span>
|
||||
<span class="n">min_width</span><span class="p">,</span>
|
||||
<span class="n">min_height</span><span class="p">,</span>
|
||||
<span class="n">nat_height</span><span class="p">);</span>
|
||||
<span class="p">}</span>
|
||||
<span class="k">else</span>
|
||||
<span class="p">{</span>
|
||||
<span class="p">...</span> <span class="n">many</span> <span class="n">containers</span> <span class="n">support</span> <span class="n">both</span> <span class="n">request</span> <span class="n">modes</span><span class="p">,</span> <span class="n">execute</span> <span class="n">the</span>
|
||||
<span class="n">real</span> <span class="n">width</span><span class="o">-</span><span class="k">for</span><span class="o">-</span><span class="n">height</span> <span class="n">request</span> <span class="n">here</span> <span class="n">by</span> <span class="n">returning</span> <span class="n">the</span>
|
||||
<span class="n">collective</span> <span class="n">heights</span> <span class="n">of</span> <span class="n">all</span> <span class="n">widgets</span> <span class="n">that</span> <span class="n">are</span> <span class="n">stacked</span>
|
||||
<span class="n">vertically</span> <span class="p">(</span><span class="n">or</span> <span class="n">whatever</span> <span class="n">is</span> <span class="n">appropriate</span> <span class="k">for</span> <span class="n">this</span> <span class="n">container</span><span class="p">)</span>
|
||||
<span class="p">...</span>
|
||||
<span class="p">}</span>
|
||||
<span class="p">}</span></pre></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -626,25 +626,25 @@ that is height-for-width, it then only needs to return the base minimum width li
|
||||
17
|
||||
18
|
||||
19</pre></td>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
|
||||
<span class="function">foo_container_get_preferred_width_for_height</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> for_height</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">min_width</span><span class="symbol">,</span>
|
||||
<span class="normal"> </span><span class="usertype">gint</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">nat_width</span><span class="symbol">)</span>
|
||||
<span class="cbracket">{</span>
|
||||
<span class="normal"> </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">i_am_in_height_for_width_mode</span><span class="symbol">)</span>
|
||||
<span class="normal"> </span><span class="cbracket">{</span>
|
||||
<span class="normal"> </span><span class="function">GTK_WIDGET_GET_CLASS</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">)-></span><span class="function">get_preferred_width</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">,</span>
|
||||
<span class="normal"> min_width</span><span class="symbol">,</span>
|
||||
<span class="normal"> nat_width</span><span class="symbol">);</span>
|
||||
<span class="normal"> </span><span class="cbracket">}</span>
|
||||
<span class="normal"> </span><span class="keyword">else</span>
|
||||
<span class="normal"> </span><span class="cbracket">{</span>
|
||||
<span class="normal"> </span><span class="symbol">...</span><span class="normal"> execute the </span><span class="usertype">real</span><span class="normal"> width</span><span class="symbol">-</span><span class="keyword">for</span><span class="symbol">-</span><span class="normal">height request here based on</span>
|
||||
<span class="normal"> the required width of the children collectively </span><span class="keyword">if</span><span class="normal"> the</span>
|
||||
<span class="normal"> container were to be allocated the </span><span class="usertype">said</span><span class="normal"> height </span><span class="symbol">...</span>
|
||||
<span class="normal"> </span><span class="cbracket">}</span>
|
||||
<span class="cbracket">}</span></pre></td>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="k">static</span> <span class="kt">void</span>
|
||||
<span class="nf">foo_container_get_preferred_width_for_height</span> <span class="p">(</span><span class="n">GtkWidget</span> <span class="o">*</span><span class="n">widget</span><span class="p">,</span>
|
||||
<span class="n">gint</span> <span class="n">for_height</span><span class="p">,</span>
|
||||
<span class="n">gint</span> <span class="o">*</span><span class="n">min_width</span><span class="p">,</span>
|
||||
<span class="n">gint</span> <span class="o">*</span><span class="n">nat_width</span><span class="p">)</span>
|
||||
<span class="p">{</span>
|
||||
<span class="k">if</span> <span class="p">(</span><span class="n">i_am_in_height_for_width_mode</span><span class="p">)</span>
|
||||
<span class="p">{</span>
|
||||
<span class="n">GTK_WIDGET_GET_CLASS</span> <span class="p">(</span><span class="n">widget</span><span class="p">)</span><span class="o">-></span><span class="n">get_preferred_width</span> <span class="p">(</span><span class="n">widget</span><span class="p">,</span>
|
||||
<span class="n">min_width</span><span class="p">,</span>
|
||||
<span class="n">nat_width</span><span class="p">);</span>
|
||||
<span class="p">}</span>
|
||||
<span class="k">else</span>
|
||||
<span class="p">{</span>
|
||||
<span class="p">...</span> <span class="n">execute</span> <span class="n">the</span> <span class="n">real</span> <span class="n">width</span><span class="o">-</span><span class="k">for</span><span class="o">-</span><span class="n">height</span> <span class="n">request</span> <span class="n">here</span> <span class="n">based</span> <span class="n">on</span>
|
||||
<span class="n">the</span> <span class="n">required</span> <span class="n">width</span> <span class="n">of</span> <span class="n">the</span> <span class="n">children</span> <span class="n">collectively</span> <span class="k">if</span> <span class="n">the</span>
|
||||
<span class="n">container</span> <span class="n">were</span> <span class="n">to</span> <span class="n">be</span> <span class="n">allocated</span> <span class="n">the</span> <span class="n">said</span> <span class="n">height</span> <span class="p">...</span>
|
||||
<span class="p">}</span>
|
||||
<span class="p">}</span></pre></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -730,21 +730,21 @@ chain. The ”name” attribute gives the id of the widget.</p>
|
||||
13
|
||||
14
|
||||
15</pre></td>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="symbol"><</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkBox"</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="normal">child</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkEntry"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"entry1"</span><span class="symbol">/></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="normal">packing</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">property</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"pack-type"</span><span class="symbol">></span><span class="normal">start</span><span class="symbol"></</span><span class="normal">property</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"></</span><span class="normal">packing</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"></</span><span class="normal">child</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="normal">child</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">object</span><span class="normal"> class</span><span class="symbol">=</span><span class="string">"GtkEntry"</span><span class="normal"> id</span><span class="symbol">=</span><span class="string">"entry2"</span><span class="symbol">/></span>
|
||||
<span class="normal"> </span><span class="symbol"></</span><span class="normal">child</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="normal">focus</span><span class="symbol">-</span><span class="normal">chain</span><span class="symbol">></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">widget</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"entry1"</span><span class="symbol">/></span>
|
||||
<span class="normal"> </span><span class="symbol"><</span><span class="usertype">widget</span><span class="normal"> name</span><span class="symbol">=</span><span class="string">"entry2"</span><span class="symbol">/></span>
|
||||
<span class="normal"> </span><span class="symbol"></</span><span class="normal">focus</span><span class="symbol">-</span><span class="normal">chain</span><span class="symbol">></span>
|
||||
<span class="symbol"></</span><span class="normal">object</span><span class="symbol">></span></pre></td>
|
||||
<td class="listing_code"><pre class="programlisting"><span class="o"><</span><span class="n">object</span> <span class="n">class</span><span class="o">=</span><span class="s">"GtkBox"</span><span class="o">></span>
|
||||
<span class="o"><</span><span class="n">child</span><span class="o">></span>
|
||||
<span class="o"><</span><span class="n">object</span> <span class="n">class</span><span class="o">=</span><span class="s">"GtkEntry"</span> <span class="n">id</span><span class="o">=</span><span class="s">"entry1"</span><span class="o">/></span>
|
||||
<span class="o"><</span><span class="n">packing</span><span class="o">></span>
|
||||
<span class="o"><</span><span class="n">property</span> <span class="n">name</span><span class="o">=</span><span class="s">"pack-type"</span><span class="o">></span><span class="n">start</span><span class="o"></</span><span class="n">property</span><span class="o">></span>
|
||||
<span class="o"></</span><span class="n">packing</span><span class="o">></span>
|
||||
<span class="o"></</span><span class="n">child</span><span class="o">></span>
|
||||
<span class="o"><</span><span class="n">child</span><span class="o">></span>
|
||||
<span class="o"><</span><span class="n">object</span> <span class="n">class</span><span class="o">=</span><span class="s">"GtkEntry"</span> <span class="n">id</span><span class="o">=</span><span class="s">"entry2"</span><span class="o">/></span>
|
||||
<span class="o"></</span><span class="n">child</span><span class="o">></span>
|
||||
<span class="o"><</span><span class="n">focus</span><span class="o">-</span><span class="n">chain</span><span class="o">></span>
|
||||
<span class="o"><</span><span class="n">widget</span> <span class="n">name</span><span class="o">=</span><span class="s">"entry1"</span><span class="o">/></span>
|
||||
<span class="o"><</span><span class="n">widget</span> <span class="n">name</span><span class="o">=</span><span class="s">"entry2"</span><span class="o">/></span>
|
||||
<span class="o"></</span><span class="n">focus</span><span class="o">-</span><span class="n">chain</span><span class="o">></span>
|
||||
<span class="o"></</span><span class="n">object</span><span class="o">></span></pre></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@ -2458,6 +2458,6 @@ user_function (<a class="link" href="GtkContainer.html" title="GtkContainer"><sp
|
||||
</div>
|
||||
</div>
|
||||
<div class="footer">
|
||||
<hr>Generated by GTK-Doc V1.29</div>
|
||||
<hr>Generated by GTK-Doc V1.30.1</div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user