W3cubDocs

/GTK 3.24

GtkMisc

GtkMisc — Base class for widgets with alignments and padding

Properties

float xalign Read / Write
int xpad Read / Write
float yalign Read / Write
int ypad Read / Write

Types and Values

struct GtkMisc

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkMisc
                ├── GtkLabel
                ├── GtkArrow
                ╰── GtkImage

Implemented Interfaces

GtkMisc implements AtkImplementorIface and GtkBuildable.

Includes

#include <gtk/gtk.h>

Description

The GtkMisc widget is an abstract widget which is not useful itself, but is used to derive subclasses which have alignment and padding attributes.

The horizontal and vertical padding attributes allows extra space to be added around the widget.

The horizontal and vertical alignment attributes enable the widget to be positioned within its allocated area. Note that if the widget is added to a container in such a way that it expands automatically to fill its allocated area, the alignment settings will not alter the widget's position.

Note that the desired effect can in most cases be achieved by using the “halign”, “valign” and “margin” properties on the child widget, so GtkMisc should not be used in new code. To reflect this fact, all GtkMisc API has been deprecated.

Functions

gtk_misc_set_alignment ()

void
gtk_misc_set_alignment (GtkMisc *misc,
                        gfloat xalign,
                        gfloat yalign);

gtk_misc_set_alignment has been deprecated since version 3.14 and should not be used in newly-written code.

Use GtkWidget's alignment (“halign” and “valign”) and margin properties or GtkLabel's “xalign” and “yalign” properties.

Sets the alignment of the widget.

Parameters

misc

a GtkMisc.

xalign

the horizontal alignment, from 0 (left) to 1 (right).

yalign

the vertical alignment, from 0 (top) to 1 (bottom).

gtk_misc_set_padding ()

void
gtk_misc_set_padding (GtkMisc *misc,
                      gint xpad,
                      gint ypad);

gtk_misc_set_padding has been deprecated since version 3.14 and should not be used in newly-written code.

Use GtkWidget alignment and margin properties.

Sets the amount of space to add around the widget.

Parameters

misc

a GtkMisc.

xpad

the amount of space to add on the left and right of the widget, in pixels.

ypad

the amount of space to add on the top and bottom of the widget, in pixels.

gtk_misc_get_alignment ()

void
gtk_misc_get_alignment (GtkMisc *misc,
                        gfloat *xalign,
                        gfloat *yalign);

gtk_misc_get_alignment has been deprecated since version 3.14 and should not be used in newly-written code.

Use GtkWidget alignment and margin properties.

Gets the X and Y alignment of the widget within its allocation. See gtk_misc_set_alignment().

Parameters

misc

a GtkMisc

xalign

location to store X alignment of misc , or NULL.

[out][allow-none]

yalign

location to store Y alignment of misc , or NULL.

[out][allow-none]

gtk_misc_get_padding ()

void
gtk_misc_get_padding (GtkMisc *misc,
                      gint *xpad,
                      gint *ypad);

gtk_misc_get_padding has been deprecated since version 3.14 and should not be used in newly-written code.

Use GtkWidget alignment and margin properties.

Gets the padding in the X and Y directions of the widget. See gtk_misc_set_padding().

Parameters

misc

a GtkMisc

xpad

location to store padding in the X direction, or NULL.

[out][allow-none]

ypad

location to store padding in the Y direction, or NULL.

[out][allow-none]

Types and Values

struct GtkMisc

struct GtkMisc;

Property Details

The “xalign” property

  “xalign”                   float

The horizontal alignment. A value of 0.0 means left alignment (or right on RTL locales); a value of 1.0 means right alignment (or left on RTL locales).

GtkMisc:xalign has been deprecated since version 3.14 and should not be used in newly-written code.

Use gtk_widget_set_halign() instead. If you are using GtkLabel, use “xalign” instead.

Owner: GtkMisc

Flags: Read / Write

Allowed values: [0,1]

Default value: 0.5

The “xpad” property

  “xpad”                     int

The amount of space to add on the left and right of the widget, in pixels.

GtkMisc:xpad has been deprecated since version 3.14 and should not be used in newly-written code.

Use gtk_widget_set_margin_start() and gtk_widget_set_margin_end() instead

Owner: GtkMisc

Flags: Read / Write

Allowed values: >= 0

Default value: 0

The “yalign” property

  “yalign”                   float

The vertical alignment. A value of 0.0 means top alignment; a value of 1.0 means bottom alignment.

GtkMisc:yalign has been deprecated since version 3.14 and should not be used in newly-written code.

Use gtk_widget_set_valign() instead. If you are using GtkLabel, use “yalign” instead.

Owner: GtkMisc

Flags: Read / Write

Allowed values: [0,1]

Default value: 0.5

The “ypad” property

  “ypad”                     int

The amount of space to add on the top and bottom of the widget, in pixels.

GtkMisc:ypad has been deprecated since version 3.14 and should not be used in newly-written code.

Use gtk_widget_set_margin_top() and gtk_widget_set_margin_bottom() instead

Owner: GtkMisc

Flags: Read / Write

Allowed values: >= 0

Default value: 0

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkMisc.html