gtkstatusicon.html

最新gtk中文资料集

</table></div>
<p class="since">Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3484448"></a><h3>
<a name="gtk-status-icon-get-geometry"></a>gtk_status_icon_get_geometry ()</h3>
<a class="indexterm" name="id3484464"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_status_icon_get_geometry        (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon">GtkStatusIcon</a> *status_icon,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
>GdkScreen</a> **screen,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Points-Rectangles-and-Regions.html#GdkRectangle"
>GdkRectangle</a> *area,
                                                         <a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> *orientation);</pre>
<p>
Obtains information about the location of the status icon
on screen. This information can be used to e.g. position 
popups like notification bubbles. 
</p>
<p>
See <a class="link" href="GtkStatusIcon.html#gtk-status-icon-position-menu"><code class="function">gtk_status_icon_position_menu()</code></a> for a more convenient 
alternative for positioning menus.
</p>
<p>
Note that some platforms do not allow GTK+ to provide 
this information, and even on platforms that do allow it,
the information is not reliable unless the status icon
is embedded in a notification area, see
<a class="link" href="GtkStatusIcon.html#gtk-status-icon-is-embedded"><code class="function">gtk_status_icon_is_embedded()</code></a>.</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>status_icon</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon"><span class="type">GtkStatusIcon</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>screen</code></em>&#160;:</span></p></td>
<td> return location for the screen, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> if the
         information is not needed 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>area</code></em>&#160;:</span></p></td>
<td> return location for the area occupied by the status 
       icon, 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>orientation</code></em>&#160;:</span></p></td>
<td> return location for the orientation of the panel 
   in which the status icon is embedded, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>. A panel 
   at the top or bottom of the screen is horizontal, a panel 
   at the left or right is vertical.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the location information has 
              been filled in

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.10
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3484691"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3484701"></a><h3>
<a name="GtkStatusIcon--blinking"></a>The <code class="literal">"blinking"</code> property</h3>
<a class="indexterm" name="id3484717"></a><pre class="programlisting">  "blinking"                 <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>Whether or not the status icon is blinking.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3484743"></a><h3>
<a name="GtkStatusIcon--embedded"></a>The <code class="literal">"embedded"</code> property</h3>
<a class="indexterm" name="id3484760"></a><pre class="programlisting">  "embedded"                 <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read</pre>
<p>
<a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the statusicon is embedded in a notification area.</p>
<p>

</p>
<p>Default value: FALSE</p>
<p>Since  2.12
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3484806"></a><h3>
<a name="GtkStatusIcon--file"></a>The <code class="literal">"file"</code> property</h3>
<a class="indexterm" name="id3484822"></a><pre class="programlisting">  "file"                     <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Write</pre>
<p>Filename to load and display.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3484849"></a><h3>
<a name="GtkStatusIcon--icon-name"></a>The <code class="literal">"icon-name"</code> property</h3>
<a class="indexterm" name="id3484865"></a><pre class="programlisting">  "icon-name"                <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write</pre>
<p>The name of the icon from the icon theme.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3484892"></a><h3>
<a name="GtkStatusIcon--orientation"></a>The <code class="literal">"orientation"</code> property</h3>
<a class="indexterm" name="id3484908"></a><pre class="programlisting">  "orientation"              <a class="link" href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a>        : Read</pre>
<p>
The orientation of the tray in which the statusicon 
is embedded.</p>
<p>

</p>
<p>Default value: GTK_ORIENTATION_HORIZONTAL</p>
<p>Since  2.12
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3484945"></a><h3>
<a name="GtkStatusIcon--pixbuf"></a>The <code class="literal">"pixbuf"</code> property</h3>
<a class="indexterm" name="id3484961"></a><pre class="programlisting">  "pixbuf"                   <a
href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>             : Read / Write</pre>
<p>A GdkPixbuf to display.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3484985"></a><h3>
<a name="GtkStatusIcon--screen"></a>The <code class="literal">"screen"</code> property</h3>
<a class="indexterm" name="id3485001"></a><pre class="programlisting">  "screen"                   <a
href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"
>GdkScreen</a>             : Read / Write</pre>
<p>The screen where this status icon will be displayed.</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3485025"></a><h3>
<a name="GtkStatusIcon--size"></a>The <code class="literal">"size"</code> property</h3>
<a class="indexterm" name="id3485041"></a><pre class="programlisting">  "size"                     <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                  : Read</pre>
<p>The size of the icon.</p>
<p>Allowed values: &gt;= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3485072"></a><h3>
<a name="GtkStatusIcon--stock"></a>The <code class="literal">"stock"</code> property</h3>
<a class="indexterm" name="id3485088"></a><pre class="programlisting">  "stock"                    <a
href="/usr/share/gtk-doc/html/gobject/gobject-Standard-Parameter-and-Value-Types.html#gchararray"
>gchararray</a>            : Read / Write</pre>
<p>Stock ID for a stock image to display.</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3485115"></a><h3>
<a name="GtkStatusIcon--storage-type"></a>The <code class="literal">"storage-type"</code> property</h3>
<a class="indexterm" name="id3485132"></a><pre class="programlisting">  "storage-type"             <a class="link" href="GtkImage.html#GtkImageType">GtkImageType</a>          : Read</pre>
<p>The representation being used for image data.</p>
<p>Default value: GTK_IMAGE_EMPTY</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3485159"></a><h3>
<a name="GtkStatusIcon--visible"></a>The <code class="literal">"visible"</code> property</h3>
<a class="indexterm" name="id3485175"></a><pre class="programlisting">  "visible"                  <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>              : Read / Write</pre>
<p>Whether or not the status icon is visible.</p>
<p>Default value: TRUE</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3485203"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3485213"></a><h3>
<a name="GtkStatusIcon-activate"></a>The <code class="literal">"activate"</code> signal</h3>
<a class="indexterm" name="id3485229"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon">GtkStatusIcon</a> *status_icon,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>       user_data)        : Run First / Action</pre>
<p>
Gets emitted when the user activates the status icon. 
If and how status icons can activated is platform-dependent.</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>status_icon</code></em>&#160;:</span></p></td>
<td> the object which received the signal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
<p>Since  2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3485308"></a><h3>
<a name="GtkStatusIcon-popup-menu"></a>The <code class="literal">"popup-menu"</code> signal</h3>
<a class="indexterm" name="id3485325"></a><pre class="programlisting">void                user_function                      (<a class="link" href="GtkStatusIcon.html" title="GtkStatusIcon">GtkStatusIcon</a> *status_icon,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>          button,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a>          activate_time,
                                                        <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>       user_data)          : Run First / Action</pre>
<p>
Gets emitted when the user brings up the context menu
of the status icon. Whether status icons can have context 
menus and how these are activated is platform-dependent.
</p>
<p>
The <em class="parameter"><code>button</code></em> and <em class="parameter"><code>activate_timeout</code></em> parameters should be 
passed as the last to arguments to <a class="link" href="GtkMenu.html#gtk-menu-popup"><code class="function">gtk_menu_popup()</code></a>.</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>status_icon</code></em>&#160;:</span></p></td>
<td> the object which received the signal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>button</code></em>&#160;:</