gtkmessagedialog.html

来自「最新gtk中文资料集」· HTML 代码 · 共 865 行 · 第 1/3 页

<tr>
<td><p><span class="term"><em class="parameter"><code>dialog</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>image</code></em>&#160;:</span></p></td>
<td> the image
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3371859"></a><h3>
<a name="gtk-message-dialog-format-secondary-text"></a>gtk_message_dialog_format_secondary_text ()</h3>
<a class="indexterm" name="id3371876"></a><pre class="programlisting">void                gtk_message_dialog_format_secondary_text
                                                        (<a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a> *message_dialog,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *message_format,
                                                         ...);</pre>
<p>
Sets the secondary text of the message dialog to be <em class="parameter"><code>message_format</code></em> 
(with <code class="function">printf()</code>-style).
</p>
<p>
Note that setting a secondary text makes the primary text become
bold, unless you have provided explicit markup.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>message_dialog</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>message_format</code></em>&#160;:</span></p></td>
<td> <code class="function">printf()</code>-style format string, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td> arguments for <em class="parameter"><code>message_format</code></em>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.6
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3372027"></a><h3>
<a name="gtk-message-dialog-format-secondary-markup"></a>gtk_message_dialog_format_secondary_markup ()</h3>
<a class="indexterm" name="id3372045"></a><pre class="programlisting">void                gtk_message_dialog_format_secondary_markup
                                                        (<a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog">GtkMessageDialog</a> *message_dialog,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *message_format,
                                                         ...);</pre>
<p>
Sets the secondary text of the message dialog to be <em class="parameter"><code>message_format</code></em> (with 
<code class="function">printf()</code>-style), which is marked up with the 
<a
href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html"
>Pango text markup language</a>.
</p>
<p>
Note that setting a secondary text makes the primary text become
bold, unless you have provided explicit markup.
</p>
<p>
Due to an oversight, this function does not escape special XML characters
like <a class="link" href="GtkMessageDialog.html#gtk-message-dialog-new-with-markup"><code class="function">gtk_message_dialog_new_with_markup()</code></a> does. Thus, if the arguments 
may contain special XML characters, you should use <a
href="/usr/share/gtk-doc/html/glib/glib-Simple-XML-Subset-Parser.html#g-markup-printf-escaped"
><code class="function">g_markup_printf_escaped()</code></a>
to escape it.
</p>
<p>
</p>
<div class="informalexample"><pre class="programlisting">
gchar *msg;
 
msg = g_markup_printf_escaped (message_format, ...);
gtk_message_dialog_format_secondary_markup (message_dialog, "%s", msg);
g_free (msg);
</pre></div>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>message_dialog</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkMessageDialog.html" title="GtkMessageDialog"><span class="type">GtkMessageDialog</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>message_format</code></em>&#160;:</span></p></td>
<td> <code class="function">printf()</code>-style markup string (see 
     <a
href="/usr/share/gtk-doc/html/pango/PangoMarkupFormat.html"
>Pango markup format</a>), or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em>&#160;:</span></p></td>
<td> arguments for <em class="parameter"><code>message_format</code></em>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.6
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3372252"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3372263"></a><h3>
<a name="GtkMessageDialog--buttons"></a>The <code class="literal">"buttons"</code> property</h3>
<a class="indexterm" name="id3372279"></a><pre class="programlisting">  "buttons"                  <a class="link" href="GtkMessageDialog.html#GtkButtonsType">GtkButtonsType</a>        : Write / Construct Only</pre>
<p>The buttons shown in the message dialog.</p>
<p>Default value: GTK_BUTTONS_NONE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3372307"></a><h3>
<a name="GtkMessageDialog--image"></a>The <code class="literal">"image"</code> property</h3>
<a class="indexterm" name="id3372323"></a><pre class="programlisting">  "image"                    <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>             : Read / Write</pre>
<p>
The image for this dialog.</p>
<p>

</p>
<p>Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3372356"></a><h3>
<a name="GtkMessageDialog--message-type"></a>The <code class="literal">"message-type"</code> property</h3>
<a class="indexterm" name="id3372373"></a><pre class="programlisting">  "message-type"             <a class="link" href="GtkMessageDialog.html#GtkMessageType">GtkMessageType</a>        : Read / Write / Construct</pre>
<p>
The type of the message. The type is used to determine
the image that is shown in the dialog, unless the image is 
explicitly set by the ::image property.</p>
<p>

</p>
<p>Default value: GTK_MESSAGE_INFO</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3372405"></a><h3>
<a name="GtkMessageDialog--secondary-text"></a>The <code class="literal">"secondary-text"</code> property</h3>
<a class="indexterm" name="id3372422"></a><pre class="programlisting">  "secondary-text"           <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write</pre>
<p>
The secondary text of the message dialog.</p>
<p>

</p>
<p>Default value: NULL</p>
<p>Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3372458"></a><h3>
<a name="GtkMessageDialog--secondary-use-markup"></a>The <code class="literal">"secondary-use-markup"</code> property</h3>
<a class="indexterm" name="id3372476"></a><pre class="programlisting">  "secondary-use-markup"     <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>
<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the secondary text of the dialog includes Pango markup. 
See <a
href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#pango-parse-markup"
><code class="function">pango_parse_markup()</code></a>.</p>
<p>

</p>
<p>Default value: FALSE</p>
<p>Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3372534"></a><h3>
<a name="GtkMessageDialog--text"></a>The <code class="literal">"text"</code> property</h3>
<a class="indexterm" name="id3372550"></a><pre class="programlisting">  "text"                     <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write</pre>
<p>
The primary text of the message dialog. If the dialog has 
a secondary text, this will appear as the title.</p>
<p>

</p>
<p>Default value: NULL</p>
<p>Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3372588"></a><h3>
<a name="GtkMessageDialog--use-markup"></a>The <code class="literal">"use-markup"</code> property</h3>
<a class="indexterm" name="id3372605"></a><pre class="programlisting">  "use-markup"               <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>
<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the primary text of the dialog includes Pango markup. 
See <a
href="/usr/share/gtk-doc/html/pango/pango-Text-Attributes.html#pango-parse-markup"
><code class="function">pango_parse_markup()</code></a>.</p>
<p>

</p>
<p>Default value: FALSE</p>
<p>Since  2.10
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3372663"></a><h2>Style Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3372674"></a><h3>
<a name="GtkMessageDialog--message-border"></a>The <code class="literal">"message-border"</code> style property</h3>
<a class="indexterm" name="id3372691"></a><pre class="programlisting">  "message-border"           <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>Width of border around the label and image in the message dialog.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 12</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3372722"></a><h3>
<a name="GtkMessageDialog--use-separator"></a>The <code class="literal">"use-separator"</code> style property</h3>
<a class="indexterm" name="id3372739"></a><pre class="programlisting">  "use-separator"            <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read</pre>
<p>
Whether to draw a separator line between the message label and the buttons
in the dialog.</p>
<p>

</p>
<p>Default value: FALSE</p>
<p>Since  2.4
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3372776"></a><h2>See Also</h2>
<p>
<a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3372794"></a><div class="refsect2" lang="en"><a name="id3372795"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id3372796"></a></div>
</div>
</div>
</body>
</html>