751
* @par Slot Prototype:
752
752
* <tt>bool on_my_%size_changed(int size)</tt>
754
* Gets emitted when the size available for the image
755
* changes, e.g.\ because the notification area got resized.
758
* @param size The new size.
759
* @return <tt>true</tt> if the icon was updated for the new
760
* size. Otherwise, GTK+ will scale the icon as necessary.
755
764
Glib::SignalProxy1< bool,int > signal_size_changed();
768
* @par Slot Prototype:
760
769
* <tt>void on_my_%activate()</tt>
771
* Gets emitted when the user activates the status icon.
772
* If and how status icons can activated is platform-dependent.
774
* Unlike most G_SIGNAL_ACTION signals, this signal is meant to
775
* be used by applications and should be wrapped by language bindings.
763
781
Glib::SignalProxy0< void > signal_activate();
785
* @par Slot Prototype:
768
786
* <tt>void on_my_%popup_menu(guint button, guint32 activate_time)</tt>
788
* Gets emitted when the user brings up the context menu
789
* of the status icon. Whether status icons can have context
790
* menus and how these are activated is platform-dependent.
792
* The @a button and @a activate_time parameters should be
793
* passed as the last to arguments to Gtk::Menu::popup().
795
* Unlike most G_SIGNAL_ACTION signals, this signal is meant to
796
* be used by applications and should be wrapped by language bindings.
799
* @param button The button that was pressed, or 0 if the
800
* signal is not emitted in response to a button press event.
801
* @param activate_time The timestamp of the event that
802
* triggered the signal emission.
771
806
Glib::SignalProxy2< void,guint,guint32 > signal_popup_menu();
810
* @par Slot Prototype:
776
811
* <tt>bool on_my_%button_press_event(GdkEventButton* event)</tt>
813
* The signal_button_press_event() signal will be emitted when a button
814
* (typically from a mouse) is pressed.
816
* Whether this event is emitted is platform-dependent. Use the signal_activate()
817
* and signal_popup_menu() signals in preference.
820
* @param event The Gdk::EventButton which triggered
822
* @return <tt>true</tt> to stop other handlers from being invoked
823
* for the event. <tt>false</tt> to propagate the event further.
779
827
Glib::SignalProxy1< bool,GdkEventButton* > signal_button_press_event();
831
* @par Slot Prototype:
784
832
* <tt>bool on_my_%button_release_event(GdkEventButton* event)</tt>
834
* The signal_button_release_event() signal will be emitted when a button
835
* (typically from a mouse) is released.
837
* Whether this event is emitted is platform-dependent. Use the signal_activate()
838
* and signal_popup_menu() signals in preference.
841
* @param event The Gdk::EventButton which triggered
843
* @return <tt>true</tt> to stop other handlers from being invoked
844
* for the event. <tt>false</tt> to propagate the event further.
787
848
Glib::SignalProxy1< bool,GdkEventButton* > signal_button_release_event();
852
* @par Slot Prototype:
792
853
* <tt>bool on_my_%scroll_event(GdkEventScroll* event)</tt>
855
* The signal_scroll_event() signal is emitted when a button in the 4 to 7
856
* range is pressed. Wheel mice are usually configured to generate
857
* button press events for buttons 4 and 5 when the wheel is turned.
859
* Whether this event is emitted is platform-dependent.
862
* @param event The Gdk::EventScroll which triggered
864
* @return <tt>true</tt> to stop other handlers from being invoked for the event.
865
* <tt>false</tt> to propagate the event further.
795
869
Glib::SignalProxy1< bool,GdkEventScroll* > signal_scroll_event();
873
* @par Slot Prototype:
800
874
* <tt>bool on_my_%query_tooltip(int x, int y, bool keyboard_mode, const Glib::RefPtr<Tooltip>& tooltip)</tt>
876
* Emitted when the Gtk::Settings::property_gtk_tooltip_timeout() has expired with the
877
* cursor hovering above @a status_icon; or emitted when @a status_icon got
878
* focus in keyboard mode.
880
* Using the given coordinates, the signal handler should determine
881
* whether a tooltip should be shown for @a status_icon. If this is
882
* the case <tt>true</tt> should be returned, <tt>false</tt> otherwise. Note that if
883
* @a keyboard_mode is <tt>true</tt>, the values of @a x and @a y are undefined and
884
* should not be used.
886
* The signal handler is free to manipulate @a tooltip with the therefore
887
* destined function calls.
889
* Whether this signal is emitted is platform-dependent.
890
* For plain text tooltips, use Gtk::StatusIcon::property_tooltip_text() in preference.
893
* @param x The x coordinate of the cursor position where the request has been
894
* emitted, relative to @a status_icon.
895
* @param y The y coordinate of the cursor position where the request has been
896
* emitted, relative to @a status_icon.
897
* @param keyboard_mode <tt>true</tt> if the tooltip was trigged using the keyboard.
898
* @param tooltip A Gtk::Tooltip.
899
* @return <tt>true</tt> if @a tooltip should be shown right now, <tt>false</tt> otherwise.
803
903
Glib::SignalProxy4< bool,int,int,bool,const Glib::RefPtr<Tooltip>& > signal_query_tooltip();
812
912
//GTK+ Virtual Functions (override these to change behaviour):
814
914
//Default Signal Handlers::
915
/// This is a default handler for the signal signal_size_changed().
815
916
virtual bool on_size_changed(int size);
917
/// This is a default handler for the signal signal_activate().
816
918
virtual void on_activate();
919
/// This is a default handler for the signal signal_popup_menu().
817
920
virtual void on_popup_menu(guint button, guint32 activate_time);
921
/// This is a default handler for the signal signal_button_press_event().
818
922
virtual bool on_button_press_event(GdkEventButton* event);
923
/// This is a default handler for the signal signal_button_release_event().
819
924
virtual bool on_button_release_event(GdkEventButton* event);
925
/// This is a default handler for the signal signal_scroll_event().
820
926
virtual bool on_scroll_event(GdkEventScroll* event);
927
/// This is a default handler for the signal signal_query_tooltip().
821
928
virtual bool on_query_tooltip(int x, int y, bool keyboard_mode, const Glib::RefPtr<Tooltip>& tooltip);