GI.Gtk.Objects.AccelLabel

The AccelLabel widget is a subclass of Label that also displays an accelerator key on the right of the label text, e.g. “Ctl+S”. It is commonly used in menus to show the keyboard short-cuts for commands.

The accelerator key to display is typically not set explicitly (although it can be, with accelLabelSetAccel). Instead, the AccelLabel displays the accelerators which have been added to a particular widget. This widget is set by calling accelLabelSetAccelWidget.

For example, a MenuItem widget may have an accelerator added to emit the “activate” signal when the “Ctl+S” key combination is pressed. A AccelLabel is created and added to the MenuItem, and accelLabelSetAccelWidget is called with the MenuItem as the second argument. The AccelLabel will now display “Ctl+S” after its label.

Note that creating a MenuItem with menuItemNewWithLabel (or one of the similar functions for CheckMenuItem and RadioMenuItem) automatically adds a AccelLabel to the MenuItem and calls accelLabelSetAccelWidget to set it up for you.

A AccelLabel will only display accelerators which have AccelFlagsVisible set (see AccelFlags). A AccelLabel can display multiple accelerators and even signal names, though it is almost always used to display just one accelerator key.

Creating a simple menu item with an accelerator key.

C code

 GtkWidget *save_item;
 GtkAccelGroup *accel_group;

 // Create a GtkAccelGroup and add it to the window.
 accel_group = gtk_accel_group_new ();
 gtk_window_add_accel_group (GTK_WINDOW (window), accel_group);

 // Create the menu item using the convenience function.
 save_item = gtk_menu_item_new_with_label ("Save");
 gtk_widget_show (save_item);
 gtk_container_add (GTK_CONTAINER (menu), save_item);

 // Now add the accelerator to the GtkMenuItem. Note that since we
 // called gtk_menu_item_new_with_label() to create the GtkMenuItem
 // the GtkAccelLabel is automatically set up to display the
 // GtkMenuItem accelerators. We just need to make sure we use
 // GTK_ACCEL_VISIBLE here.
 gtk_widget_add_accelerator (save_item, "activate", accel_group,
                             GDK_KEY_s, GDK_CONTROL_MASK, GTK_ACCEL_VISIBLE);

CSS nodes

plain code

label
╰── accelerator

Like Label, GtkAccelLabel has a main CSS node with the name label. It adds a subnode with name accelerator.

Exported types

newtype AccelLabel

Constructors

AccelLabel (ManagedPtr AccelLabel)

Instances

GObject AccelLabel

Methods

gobjectType :: AccelLabel -> IO GType

IsImplementorIface AccelLabel

IsObject AccelLabel

IsWidget AccelLabel

IsMisc AccelLabel

IsLabel AccelLabel

IsBuildable AccelLabel

IsAccelLabel AccelLabel

((~) * info (ResolveAccelLabelMethod t AccelLabel), MethodInfo * info AccelLabel p) => IsLabel t (AccelLabel -> p)

Methods

fromLabel :: Proxy# Symbol t -> AccelLabel -> p

((~) * info (ResolveAccelLabelMethod t AccelLabel), MethodInfo * info AccelLabel p) => IsLabelProxy t (AccelLabel -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> AccelLabel -> p

HasAttributeList * AccelLabel

type AttributeList AccelLabel

type AttributeList AccelLabel

type SignalList AccelLabel

type SignalList AccelLabel

class GObject o => IsAccelLabel o

Instances

(GObject a, UnknownAncestorError Constraint AccelLabel a) => IsAccelLabel a

IsAccelLabel AccelLabel

toAccelLabel :: IsAccelLabel o => o -> IO AccelLabel

noAccelLabel :: Maybe AccelLabel

Methods

getAccel

data AccelLabelGetAccelMethodInfo

Instances

((~) * signature (m (Word32, [ModifierType])), MonadIO m, IsAccelLabel a) => MethodInfo * AccelLabelGetAccelMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AccelLabelGetAccelMethodInfo a -> signature -> s

accelLabelGetAccel

Arguments

:: (HasCallStack, MonadIO m, IsAccelLabel a)

=> a

accelLabel: a AccelLabel

-> m (Word32, [ModifierType])

Gets the keyval and modifier mask set with accelLabelSetAccel.

Since: 3.12

getAccelWidget

data AccelLabelGetAccelWidgetMethodInfo

Instances

((~) * signature (m (Maybe Widget)), MonadIO m, IsAccelLabel a) => MethodInfo * AccelLabelGetAccelWidgetMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AccelLabelGetAccelWidgetMethodInfo a -> signature -> s

accelLabelGetAccelWidget

Arguments

:: (HasCallStack, MonadIO m, IsAccelLabel a)

=> a

accelLabel: a AccelLabel

-> m (Maybe Widget)

Returns: the object monitored by the accelerator label, or Nothing.

Fetches the widget monitored by this accelerator label. See accelLabelSetAccelWidget.

getAccelWidth

data AccelLabelGetAccelWidthMethodInfo

Instances

((~) * signature (m Word32), MonadIO m, IsAccelLabel a) => MethodInfo * AccelLabelGetAccelWidthMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AccelLabelGetAccelWidthMethodInfo a -> signature -> s

accelLabelGetAccelWidth

Arguments

:: (HasCallStack, MonadIO m, IsAccelLabel a)

=> a

accelLabel: a AccelLabel.

-> m Word32

Returns: the width needed to display the accelerator key(s).

Returns the width needed to display the accelerator key(s). This is used by menus to align all of the MenuItem widgets, and shouldn't be needed by applications.

new

accelLabelNew

Arguments

:: (HasCallStack, MonadIO m)

=> Text

string: the label string. Must be non-Nothing.

-> m AccelLabel

Returns: a new AccelLabel.

Creates a new AccelLabel.

refetch

data AccelLabelRefetchMethodInfo

Instances

((~) * signature (m Bool), MonadIO m, IsAccelLabel a) => MethodInfo * AccelLabelRefetchMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AccelLabelRefetchMethodInfo a -> signature -> s

accelLabelRefetch

Arguments

:: (HasCallStack, MonadIO m, IsAccelLabel a)

=> a

accelLabel: a AccelLabel.

-> m Bool

Returns: always returns False.

Recreates the string representing the accelerator keys. This should not be needed since the string is automatically updated whenever accelerators are added or removed from the associated widget.

setAccel

data AccelLabelSetAccelMethodInfo

Instances

((~) * signature (Word32 -> [ModifierType] -> m ()), MonadIO m, IsAccelLabel a) => MethodInfo * AccelLabelSetAccelMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AccelLabelSetAccelMethodInfo a -> signature -> s

accelLabelSetAccel

Arguments

:: (HasCallStack, MonadIO m, IsAccelLabel a)

=> a

accelLabel: a AccelLabel

-> Word32

acceleratorKey: a keyval, or 0

-> [ModifierType]

acceleratorMods: the modifier mask for the accel

-> m ()

Manually sets a keyval and modifier mask as the accelerator rendered by accelLabel.

If a keyval and modifier are explicitly set then these values are used regardless of any associated accel closure or widget.

Providing an acceleratorKey of 0 removes the manual setting.

Since: 3.6

setAccelClosure

data AccelLabelSetAccelClosureMethodInfo

Instances

((~) * signature (Closure -> m ()), MonadIO m, IsAccelLabel a) => MethodInfo * AccelLabelSetAccelClosureMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AccelLabelSetAccelClosureMethodInfo a -> signature -> s

accelLabelSetAccelClosure

Arguments

:: (HasCallStack, MonadIO m, IsAccelLabel a)

=> a

accelLabel: a AccelLabel

-> Closure

accelClosure: the closure to monitor for accelerator changes.

-> m ()

Sets the closure to be monitored by this accelerator label. The closure must be connected to an accelerator group; see accelGroupConnect.

setAccelWidget

data AccelLabelSetAccelWidgetMethodInfo

Instances

((~) * signature (b -> m ()), MonadIO m, IsAccelLabel a, IsWidget b) => MethodInfo * AccelLabelSetAccelWidgetMethodInfo a signature

Methods

overloadedMethod :: MethodProxy AccelLabelSetAccelWidgetMethodInfo a -> signature -> s

accelLabelSetAccelWidget

Arguments

:: (HasCallStack, MonadIO m, IsAccelLabel a, IsWidget b)

=> a

accelLabel: a AccelLabel

-> b

accelWidget: the widget to be monitored.

-> m ()

Sets the widget to be monitored by this accelerator label.

Properties

accelClosure

data AccelLabelAccelClosurePropertyInfo

Instances

AttrInfo AccelLabelAccelClosurePropertyInfo

Associated Types

type AttrAllowedOps AccelLabelAccelClosurePropertyInfo :: [AttrOpTag]

type AttrSetTypeConstraint AccelLabelAccelClosurePropertyInfo :: * -> Constraint

type AttrBaseTypeConstraint AccelLabelAccelClosurePropertyInfo :: * -> Constraint

type AttrGetType AccelLabelAccelClosurePropertyInfo :: *

type AttrLabel AccelLabelAccelClosurePropertyInfo :: Symbol

type AttrOrigin AccelLabelAccelClosurePropertyInfo :: *

Methods

attrGet :: AttrBaseTypeConstraint AccelLabelAccelClosurePropertyInfo o => Proxy * AccelLabelAccelClosurePropertyInfo -> o -> IO (AttrGetType AccelLabelAccelClosurePropertyInfo)

attrSet :: (AttrBaseTypeConstraint AccelLabelAccelClosurePropertyInfo o, AttrSetTypeConstraint AccelLabelAccelClosurePropertyInfo b) => Proxy * AccelLabelAccelClosurePropertyInfo -> o -> b -> IO ()

attrClear :: AttrBaseTypeConstraint AccelLabelAccelClosurePropertyInfo o => Proxy * AccelLabelAccelClosurePropertyInfo -> o -> IO ()

attrConstruct :: (AttrBaseTypeConstraint AccelLabelAccelClosurePropertyInfo o, AttrSetTypeConstraint AccelLabelAccelClosurePropertyInfo b) => Proxy * AccelLabelAccelClosurePropertyInfo -> b -> IO (GValueConstruct o)

type AttrOrigin AccelLabelAccelClosurePropertyInfo

type AttrOrigin AccelLabelAccelClosurePropertyInfo = AccelLabel

type AttrLabel AccelLabelAccelClosurePropertyInfo

type AttrLabel AccelLabelAccelClosurePropertyInfo = "accel-closure"

type AttrGetType AccelLabelAccelClosurePropertyInfo

type AttrGetType AccelLabelAccelClosurePropertyInfo = Maybe Closure

type AttrBaseTypeConstraint AccelLabelAccelClosurePropertyInfo

type AttrBaseTypeConstraint AccelLabelAccelClosurePropertyInfo = IsAccelLabel

type AttrSetTypeConstraint AccelLabelAccelClosurePropertyInfo

type AttrSetTypeConstraint AccelLabelAccelClosurePropertyInfo = * ~ Closure

type AttrAllowedOps AccelLabelAccelClosurePropertyInfo

type AttrAllowedOps AccelLabelAccelClosurePropertyInfo = (:) AttrOpTag AttrSet ((:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ([] AttrOpTag)))

accelLabelAccelClosure :: AttrLabelProxy "accelClosure"

constructAccelLabelAccelClosure :: IsAccelLabel o => Closure -> IO (GValueConstruct o)

getAccelLabelAccelClosure :: (MonadIO m, IsAccelLabel o) => o -> m (Maybe Closure)

setAccelLabelAccelClosure :: (MonadIO m, IsAccelLabel o) => o -> Closure -> m ()

accelWidget

data AccelLabelAccelWidgetPropertyInfo

Instances

AttrInfo AccelLabelAccelWidgetPropertyInfo

Associated Types

type AttrAllowedOps AccelLabelAccelWidgetPropertyInfo :: [AttrOpTag]

type AttrSetTypeConstraint AccelLabelAccelWidgetPropertyInfo :: * -> Constraint

type AttrBaseTypeConstraint AccelLabelAccelWidgetPropertyInfo :: * -> Constraint

type AttrGetType AccelLabelAccelWidgetPropertyInfo :: *

type AttrLabel AccelLabelAccelWidgetPropertyInfo :: Symbol

type AttrOrigin AccelLabelAccelWidgetPropertyInfo :: *

Methods

attrGet :: AttrBaseTypeConstraint AccelLabelAccelWidgetPropertyInfo o => Proxy * AccelLabelAccelWidgetPropertyInfo -> o -> IO (AttrGetType AccelLabelAccelWidgetPropertyInfo)

attrSet :: (AttrBaseTypeConstraint AccelLabelAccelWidgetPropertyInfo o, AttrSetTypeConstraint AccelLabelAccelWidgetPropertyInfo b) => Proxy * AccelLabelAccelWidgetPropertyInfo -> o -> b -> IO ()

attrClear :: AttrBaseTypeConstraint AccelLabelAccelWidgetPropertyInfo o => Proxy * AccelLabelAccelWidgetPropertyInfo -> o -> IO ()

attrConstruct :: (AttrBaseTypeConstraint AccelLabelAccelWidgetPropertyInfo o, AttrSetTypeConstraint AccelLabelAccelWidgetPropertyInfo b) => Proxy * AccelLabelAccelWidgetPropertyInfo -> b -> IO (GValueConstruct o)

type AttrOrigin AccelLabelAccelWidgetPropertyInfo

type AttrOrigin AccelLabelAccelWidgetPropertyInfo = AccelLabel

type AttrLabel AccelLabelAccelWidgetPropertyInfo

type AttrLabel AccelLabelAccelWidgetPropertyInfo = "accel-widget"

type AttrGetType AccelLabelAccelWidgetPropertyInfo

type AttrGetType AccelLabelAccelWidgetPropertyInfo = Maybe Widget

type AttrBaseTypeConstraint AccelLabelAccelWidgetPropertyInfo

type AttrBaseTypeConstraint AccelLabelAccelWidgetPropertyInfo = IsAccelLabel

type AttrSetTypeConstraint AccelLabelAccelWidgetPropertyInfo

type AttrSetTypeConstraint AccelLabelAccelWidgetPropertyInfo = IsWidget

type AttrAllowedOps AccelLabelAccelWidgetPropertyInfo

type AttrAllowedOps AccelLabelAccelWidgetPropertyInfo = (:) AttrOpTag AttrSet ((:) AttrOpTag AttrConstruct ((:) AttrOpTag AttrGet ([] AttrOpTag)))

accelLabelAccelWidget :: AttrLabelProxy "accelWidget"

constructAccelLabelAccelWidget :: (IsAccelLabel o, IsWidget a) => a -> IO (GValueConstruct o)

getAccelLabelAccelWidget :: (MonadIO m, IsAccelLabel o) => o -> m (Maybe Widget)

setAccelLabelAccelWidget :: (MonadIO m, IsAccelLabel o, IsWidget a) => o -> a -> m ()