// Generated by gmmproc 2.66.7 -- DO NOT MODIFY! #ifndef _GTKMM_TOGGLEACTION_H #define _GTKMM_TOGGLEACTION_H #ifndef GTKMM_DISABLE_DEPRECATED #include #include /* Copyright (C) 2003 The gtkmm Development Team * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA */ #include // This whole file is deprecated. #ifndef DOXYGEN_SHOULD_SKIP_THIS using GtkToggleAction = struct _GtkToggleAction; using GtkToggleActionClass = struct _GtkToggleActionClass; #endif /* DOXYGEN_SHOULD_SKIP_THIS */ #ifndef DOXYGEN_SHOULD_SKIP_THIS namespace Gtk { class GTKMM_API ToggleAction_Class; } // namespace Gtk #endif //DOXYGEN_SHOULD_SKIP_THIS namespace Gtk { /** A deprecated action which can be toggled between two states. * * A Gtk::ToggleAction corresponds roughly to a Gtk::CheckMenuItem. * It has an "active" state specifying whether the action has been checked or not. * * @deprecated Use Gio::Action and Gio::SimpleAction instead, and associate actions * with Gtk::Actionable widgets. Use Gio::MenuModel for creating menus with * Gtk::Menu(const Glib::RefPtr& model). * See the Gtk::Action base class for more information about the deprecation. */ class GTKMM_API ToggleAction : public Gtk::Action { #ifndef DOXYGEN_SHOULD_SKIP_THIS public: using CppObjectType = ToggleAction; using CppClassType = ToggleAction_Class; using BaseObjectType = GtkToggleAction; using BaseClassType = GtkToggleActionClass; // noncopyable ToggleAction(const ToggleAction&) = delete; ToggleAction& operator=(const ToggleAction&) = delete; private: friend class ToggleAction_Class; static CppClassType toggleaction_class_; protected: explicit ToggleAction(const Glib::ConstructParams& construct_params); explicit ToggleAction(GtkToggleAction* castitem); #endif /* DOXYGEN_SHOULD_SKIP_THIS */ public: ToggleAction(ToggleAction&& src) noexcept; ToggleAction& operator=(ToggleAction&& src) noexcept; ~ToggleAction() noexcept override; /** Get the GType for this class, for use with the underlying GObject type system. */ static GType get_type() G_GNUC_CONST; #ifndef DOXYGEN_SHOULD_SKIP_THIS static GType get_base_type() G_GNUC_CONST; #endif ///Provides access to the underlying C GObject. GtkToggleAction* gobj() { return reinterpret_cast(gobject_); } ///Provides access to the underlying C GObject. const GtkToggleAction* gobj() const { return reinterpret_cast(gobject_); } ///Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. GtkToggleAction* gobj_copy(); private: protected: /** Creates an empty toggle action. */ ToggleAction(); #ifndef GTKMM_DISABLE_DEPRECATED /** Creates a toggle action. * * @param name A unique name for the action. * @param stock_id The stock icon to display in widgets representing the * action. * @param label The label displayed in menu items and on buttons. * @param tooltip A tooltip for the action. * @param is_active The default checked state of the action. * * @deprecated There is no corresponding replacement when using Gio::Action. */ explicit ToggleAction(const Glib::ustring& name, const StockID& stock_id = StockID(), const Glib::ustring& label = Glib::ustring(), const Glib::ustring& tooltip = Glib::ustring(), bool is_active = false); /** Creates a toggle action with an icon name. * The toggle action's icon will reflect the specified icon name in the * user's icon theme. * * @param name A unique name for the action. * @param icon_name An IconTheme icon name used for widgets representing the * action. * @param label The label displayed in menu items and on buttons. * @param tooltip A tooltip for the action. * @param is_active The default checked state of the action. * @deprecated Use Gio::Action, which can be created by Gio::ActionMap::add_action_bool().
* Use Gio::MenuItem::set_icon() to set an icon on a Gio::MenuItem associated with a Gio::Action, * or Gtk::Container::add() to add a Gtk::Image to a Gtk::ToggleButton.
* Set a label on a menu item with Gio::MenuItem::set_label(). * For Gtk::Actionable widgets, use the widget-specific API to set a label.
* Set tooltips on associated Gtk::Actionable widgets with Gtk::Widget::set_tooltip_text(). */ explicit ToggleAction(const Glib::ustring& name, const Glib::ustring& icon_name, const Glib::ustring& label = Glib::ustring(), const Glib::ustring& tooltip = Glib::ustring(), bool is_active = false); #endif // GTKMM_DISABLE_DEPRECATED public: //Note that gtk_toggle_action_new() does not allow name to be NULL, which suggests that we should not have a default constructor, //but it's OK to set the name later: static Glib::RefPtr create(); #ifndef GTKMM_DISABLE_DEPRECATED /** Creates a toggle action. * * @param name A unique name for the action. * @param label The label displayed in menu items and on buttons. * @param tooltip A tooltip for the action. * @param is_active The default checked state of the action. * * @return A new ToggleAction. * @deprecated Use Gio::Action, which can be created by Gio::ActionMap::add_action_bool().
* Set a label on a menu item with Gio::MenuItem::set_label(). * For Gtk::Actionable widgets, use the widget-specific API to set a label.
* Set tooltips on associated Gtk::Actionable widgets with Gtk::Widget::set_tooltip_text(). */ static Glib::RefPtr create(const Glib::ustring& name, const Glib::ustring& label = Glib::ustring(), const Glib::ustring& tooltip = Glib::ustring(), bool is_active = false); /** Creates a toggle action with a stock ID. * The tock ID is used to set a default icon, text and accelerator for * the toggle action. * * @param name A unique name for the action. * @param stock_id The stock icon to display in widgets representing the * action. * @param label The label displayed in menu items and on buttons. * @param tooltip A tooltip for the action. * @param is_active The default checked state of the action. * * @return A new ToggleAction. * @deprecated There is no corresponding replacement when using Gio::Action. */ static Glib::RefPtr create(const Glib::ustring& name, const Gtk::StockID& stock_id, const Glib::ustring& label = Glib::ustring(), const Glib::ustring& tooltip = Glib::ustring(), bool is_active = false); /** Creates a toggle action with an icon name. * The toggle action's icon will reflect the specified icon name in the * user's icon theme. * * @param name A unique name for the action. * @param icon_name An IconTheme icon name used for widgets representing the * action. * @param label The label displayed in menu items and on buttons. * @param tooltip A tooltip for the action. * @param is_active The default checked state of the action. * * @return A new ToggleAction. * @deprecated Use Gio::Action, which can be created by Gio::ActionMap::add_action_bool().
* Use Gio::MenuItem::set_icon() to set an icon on a Gio::MenuItem associated with a Gio::Action, * or Gtk::Container::add() to add a Gtk::Image to a Gtk::ToggleButton.
* Set a label on a menu item with Gio::MenuItem::set_label(). * For Gtk::Actionable widgets, use the widget-specific API to set a label.
* Set tooltips on associated Gtk::Actionable widgets with Gtk::Widget::set_tooltip_text(). */ static Glib::RefPtr create_with_icon_name(const Glib::ustring& name, const Glib::ustring& icon_name, const Glib::ustring& label, const Glib::ustring& tooltip, bool is_active = false); #endif // GTKMM_DISABLE_DEPRECATED #ifndef GTKMM_DISABLE_DEPRECATED /** Emits the “toggled” signal on the toggle action. * * @newin{2,4} * * Deprecated: 3.10 * * @deprecated Use Gio::Action::activate() on a Gio::Action instead. */ void toggled(); #endif // GTKMM_DISABLE_DEPRECATED #ifndef GTKMM_DISABLE_DEPRECATED /** Sets the checked state on the toggle action. * * @newin{2,4} * * Deprecated: 3.10 * * @deprecated Use Gio::Action::change_state() on a Gio::Action instead. * * @param is_active Whether the action should be checked or not. */ void set_active(bool is_active = true); #endif // GTKMM_DISABLE_DEPRECATED #ifndef GTKMM_DISABLE_DEPRECATED /** Returns the checked state of the toggle action. * * @newin{2,4} * * Deprecated: 3.10 * * @deprecated Use Gio::Action::get_state() on a Gio::Action instead. * * @return The checked state of the toggle action. */ bool get_active() const; #endif // GTKMM_DISABLE_DEPRECATED #ifndef GTKMM_DISABLE_DEPRECATED /** Sets whether the action should have proxies like a radio action. * * @newin{2,4} * * Deprecated: 3.10 * * @deprecated Use Gtk::CheckMenuItem::set_draw_as_radio() on a Gtk::CheckMenuItem instead. * * @param draw_as_radio Whether the action should have proxies like a radio * action. */ void set_draw_as_radio(bool draw_as_radio = true); #endif // GTKMM_DISABLE_DEPRECATED #ifndef GTKMM_DISABLE_DEPRECATED /** Returns whether the action should have proxies like a radio action. * * @newin{2,4} * * Deprecated: 3.10 * * @deprecated Use Gtk::CheckMenuItem::get_draw_as_radio() on a Gtk::CheckMenuItem instead. * * @return Whether the action should have proxies like a radio action. */ bool get_draw_as_radio() const; #endif // GTKMM_DISABLE_DEPRECATED #ifndef GTKMM_DISABLE_DEPRECATED /** * @par Slot Prototype: * void on_my_%toggled() * * Flags: Run First * * Should be connected if you wish to perform an action * whenever the Gtk::ToggleAction state is changed. * * Deprecated: 3.10 * * @deprecated Use Gio::SimpleAction::signal_activate() or Gio::SimpleAction::signal_change_state() instead. */ Glib::SignalProxy< void > signal_toggled(); #endif // GTKMM_DISABLE_DEPRECATED #ifndef GTKMM_DISABLE_DEPRECATED /** Whether the proxies for this action look like radio action proxies. * * This is an appearance property and thus only applies if * Gtk::Activatable::property_use_action_appearance() is true. * * Deprecated: 3.10 * * @deprecated Use Gtk::CheckMenuItem::property_draw_as_radio() on a Gtk::CheckMenuItem instead. * * Default value: false * * @return A PropertyProxy that allows you to get or set the value of the property, * or receive notification when the value of the property changes. */ Glib::PropertyProxy< bool > property_draw_as_radio() ; /** Whether the proxies for this action look like radio action proxies. * * This is an appearance property and thus only applies if * Gtk::Activatable::property_use_action_appearance() is true. * * Deprecated: 3.10 * * @deprecated Use Gtk::CheckMenuItem::property_draw_as_radio() on a Gtk::CheckMenuItem instead. * * Default value: false * * @return A PropertyProxy_ReadOnly that allows you to get the value of the property, * or receive notification when the value of the property changes. */ Glib::PropertyProxy_ReadOnly< bool > property_draw_as_radio() const; #endif // GTKMM_DISABLE_DEPRECATED #ifndef GTKMM_DISABLE_DEPRECATED /** Whether the toggle action should be active. * * @newin{2,10} * * Deprecated: 3.10 * * @deprecated Use Gio::Action::property_state() and Gio::SimpleAction::property_state() instead. * * Default value: false * * @return A PropertyProxy that allows you to get or set the value of the property, * or receive notification when the value of the property changes. */ Glib::PropertyProxy< bool > property_active() ; /** Whether the toggle action should be active. * * @newin{2,10} * * Deprecated: 3.10 * * @deprecated Use Gio::Action::property_state() and Gio::SimpleAction::property_state() instead. * * Default value: false * * @return A PropertyProxy_ReadOnly that allows you to get the value of the property, * or receive notification when the value of the property changes. */ Glib::PropertyProxy_ReadOnly< bool > property_active() const; #endif // GTKMM_DISABLE_DEPRECATED public: public: //C++ methods used to invoke GTK+ virtual functions: protected: //GTK+ Virtual Functions (override these to change behaviour): //Default Signal Handlers:: /// This is a default handler for the signal signal_toggled(). virtual void on_toggled(); }; } // namespace Gtk namespace Glib { /** A Glib::wrap() method for this object. * * @param object The C instance. * @param take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref. * @result A C++ instance that wraps this C instance. * * @relates Gtk::ToggleAction */ GTKMM_API Glib::RefPtr wrap(GtkToggleAction* object, bool take_copy = false); } #endif // GTKMM_DISABLE_DEPRECATED #endif /* _GTKMM_TOGGLEACTION_H */