Blame docs/reference/gtk/html/GtkRadioAction.html

Packit Service fb6fa5
Packit Service fb6fa5
<html>
Packit Service fb6fa5
<head>
Packit Service fb6fa5
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit Service fb6fa5
<title>GtkRadioAction: GTK+ 2 Reference Manual</title>
Packit Service fb6fa5
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
Packit Service fb6fa5
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
Packit Service fb6fa5
<link rel="up" href="Actions.html" title="Action-based menus and toolbars">
Packit Service fb6fa5
<link rel="prev" href="GtkToggleAction.html" title="GtkToggleAction">
Packit Service fb6fa5
<link rel="next" href="GtkRecentAction.html" title="GtkRecentAction">
Packit Service fb6fa5
<meta name="generator" content="GTK-Doc V1.26.1 (XML mode)">
Packit Service fb6fa5
<link rel="stylesheet" href="style.css" type="text/css">
Packit Service fb6fa5
</head>
Packit Service fb6fa5
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Top  | 
Packit Service fb6fa5
                  Description  | 
Packit Service fb6fa5
                  Object Hierarchy  | 
Packit Service fb6fa5
                  Implemented Interfaces  | 
Packit Service fb6fa5
                  Properties  | 
Packit Service fb6fa5
                  Signals
Packit Service fb6fa5
Packit Service fb6fa5
Home
Packit Service fb6fa5
Up
Packit Service fb6fa5
Prev
Packit Service fb6fa5
Next
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

GtkRadioAction

Packit Service fb6fa5

GtkRadioAction

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Functions

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GtkRadioAction *
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_radio_action_new ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GSList *
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_radio_action_get_group ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_radio_action_set_group ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gint
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_radio_action_get_current_value ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gtk_radio_action_set_current_value ()
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Properties

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gint
Packit Service fb6fa5
current-value
Packit Service fb6fa5
Read / Write
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
GtkRadioAction *
Packit Service fb6fa5
group
Packit Service fb6fa5
Write
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
gint
Packit Service fb6fa5
value
Packit Service fb6fa5
Read / Write
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Signals

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
void
Packit Service fb6fa5
changed
Packit Service fb6fa5
No Recursion
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Types and Values

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
struct
Packit Service fb6fa5
GtkRadioAction
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Object Hierarchy

Packit Service fb6fa5
    GObject
Packit Service fb6fa5
    ╰── GtkAction
Packit Service fb6fa5
        ╰── GtkToggleAction
Packit Service fb6fa5
            ╰── GtkRadioAction
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Implemented Interfaces

Packit Service fb6fa5

Packit Service fb6fa5
GtkRadioAction implements
Packit Service fb6fa5
 GtkBuildable.

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Includes

Packit Service fb6fa5
#include <gtk/gtk.h>
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Description

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Functions

Packit Service fb6fa5
Packit Service fb6fa5

gtk_radio_action_new ()

Packit Service fb6fa5
GtkRadioAction *
Packit Service fb6fa5
gtk_radio_action_new (const gchar *name,
Packit Service fb6fa5
                      const gchar *label,
Packit Service fb6fa5
                      const gchar *tooltip,
Packit Service fb6fa5
                      const gchar *stock_id,
Packit Service fb6fa5
                      gint value);
Packit Service fb6fa5

Creates a new GtkRadioAction object. To add the action to

Packit Service fb6fa5
a GtkActionGroup and set the accelerator for the action,
Packit Service fb6fa5
call gtk_action_group_add_action_with_accel().

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

name

Packit Service fb6fa5

A unique name for the action

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

label

Packit Service fb6fa5

The label displayed in menu items and on buttons, or NULL.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

tooltip

Packit Service fb6fa5

A tooltip for this action, or NULL.

Packit Service fb6fa5
[allow-none]
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

stock_id

Packit Service fb6fa5

The stock icon to display in widgets representing this

Packit Service fb6fa5
action, or NULL

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

value

Packit Service fb6fa5

The value which gtk_radio_action_get_current_value() should

Packit Service fb6fa5
return if this action is selected.

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

a new GtkRadioAction

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.4

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_radio_action_get_group ()

Packit Service fb6fa5
GSList *
Packit Service fb6fa5
gtk_radio_action_get_group (GtkRadioAction *action);
Packit Service fb6fa5

Returns the list representing the radio group for this object.

Packit Service fb6fa5
Note that the returned list is only valid until the next change
Packit Service fb6fa5
to the group. 

Packit Service fb6fa5

A common way to set up a group of radio group is the following:

Packit Service fb6fa5
Packit Service fb6fa5
  
Packit Service fb6fa5
    
Packit Service fb6fa5
      
Packit Service fb6fa5
        
1
Packit Service fb6fa5
2
Packit Service fb6fa5
3
Packit Service fb6fa5
4
Packit Service fb6fa5
5
Packit Service fb6fa5
6
Packit Service fb6fa5
7
Packit Service fb6fa5
8
Packit Service fb6fa5
9
Packit Service fb6fa5
10
Packit Service fb6fa5
        
GSList *group = NULL;
Packit Service fb6fa5
GtkRadioAction *action;
Packit Service fb6fa5
 
Packit Service fb6fa5
while (/* more actions to add */)
Packit Service fb6fa5
  {
Packit Service fb6fa5
     action = gtk_radio_action_new (...);
Packit Service fb6fa5
     
Packit Service fb6fa5
     gtk_radio_action_set_group (action, group);
Packit Service fb6fa5
     group = gtk_radio_action_get_group (action);
Packit Service fb6fa5
  }
Packit Service fb6fa5
      
Packit Service fb6fa5
    
Packit Service fb6fa5
  
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

action

Packit Service fb6fa5

the action object

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

the list representing the radio group for this object.

Packit Service fb6fa5

[element-type GtkAction][transfer none]

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.4

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_radio_action_set_group ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_radio_action_set_group (GtkRadioAction *action,
Packit Service fb6fa5
                            GSList *group);
Packit Service fb6fa5

Sets the radio group for the radio action object.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

action

Packit Service fb6fa5

the action object

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

group

Packit Service fb6fa5

a list representing a radio group

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.4

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_radio_action_get_current_value ()

Packit Service fb6fa5
gint
Packit Service fb6fa5
gtk_radio_action_get_current_value (GtkRadioAction *action);
Packit Service fb6fa5

Obtains the value property of the currently active member of

Packit Service fb6fa5
the group to which action
Packit Service fb6fa5
 belongs.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

action

Packit Service fb6fa5

a GtkRadioAction

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Returns

Packit Service fb6fa5

The value of the currently active group member

Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.4

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

gtk_radio_action_set_current_value ()

Packit Service fb6fa5
void
Packit Service fb6fa5
gtk_radio_action_set_current_value (GtkRadioAction *action,
Packit Service fb6fa5
                                    gint current_value);
Packit Service fb6fa5

Sets the currently active group member to the member with value

Packit Service fb6fa5
property current_value
Packit Service fb6fa5
.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

action

Packit Service fb6fa5

a GtkRadioAction

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

current_value

Packit Service fb6fa5

the new value

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Since: 2.10

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Types and Values

Packit Service fb6fa5
Packit Service fb6fa5

struct GtkRadioAction

Packit Service fb6fa5
struct GtkRadioAction;
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Property Details

Packit Service fb6fa5
Packit Service fb6fa5

The “current-value” property

Packit Service fb6fa5
  “current-value”            gint
Packit Service fb6fa5

The value property of the currently active member of the group to which

Packit Service fb6fa5
this action belongs.

Packit Service fb6fa5

Flags: Read / Write

Packit Service fb6fa5

Default value: 0

Packit Service fb6fa5

Since: 2.10

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

The “group” property

Packit Service fb6fa5
  “group”                    GtkRadioAction *
Packit Service fb6fa5

Sets a new group for a radio action.

Packit Service fb6fa5

Flags: Write

Packit Service fb6fa5

Since: 2.4

Packit Service fb6fa5
Packit Service fb6fa5

Packit Service fb6fa5
Packit Service fb6fa5

The “value” property

Packit Service fb6fa5
  “value”                    gint
Packit Service fb6fa5

The value is an arbitrary integer which can be used as a

Packit Service fb6fa5
convenient way to determine which action in the group is
Packit Service fb6fa5
Packit Service fb6fa5
currently active in an ::activate or ::changed signal handler.
Packit Service fb6fa5
See gtk_radio_action_get_current_value() and GtkRadioActionEntry
Packit Service fb6fa5
for convenient ways to get and set this property.

Packit Service fb6fa5

Flags: Read / Write

Packit Service fb6fa5

Default value: 0

Packit Service fb6fa5

Since: 2.4

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Signal Details

Packit Service fb6fa5
Packit Service fb6fa5

The “changed” signal

Packit Service fb6fa5
void
Packit Service fb6fa5
user_function (GtkRadioAction *action,
Packit Service fb6fa5
               GtkRadioAction *current,
Packit Service fb6fa5
               gpointer        user_data)
Packit Service fb6fa5

The ::changed signal is emitted on every member of a radio group when the

Packit Service fb6fa5
active member is changed. The signal gets emitted after the ::activate signals
Packit Service fb6fa5
for the previous and current active members.

Packit Service fb6fa5
Packit Service fb6fa5

Parameters

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

action

Packit Service fb6fa5

the action on which the signal is emitted

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

current

Packit Service fb6fa5

the member of action

Packit Service fb6fa5
s group which has just been activated

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

user_data

Packit Service fb6fa5

user data set when the signal handler was connected.

Packit Service fb6fa5
 
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Flags: No Recursion

Packit Service fb6fa5

Since: 2.4

Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5
Packit Service fb6fa5

Generated by GTK-Doc V1.26.1
Packit Service fb6fa5
</body>
Packit Service fb6fa5
</html>