General

General — Library initialization and miscellaneous functions

Types and Values

Includes

#include <gdk/gdk.h>

Description

This section describes the GDK initialization functions and miscellaneous utility functions, as well as deprecation facilities.

The GDK and GTK+ headers annotate deprecated APIs in a way that produces compiler warnings if these deprecated APIs are used. The warnings can be turned off by defining the macro GDK_DISABLE_DEPRECATION_WARNINGS before including the glib.h header.

GDK and GTK+ also provide support for building applications against defined subsets of deprecated or new APIs. Define the macro GDK_VERSION_MIN_REQUIRED to specify up to what version you want to receive warnings about deprecated APIs. Define the macro GDK_VERSION_MAX_ALLOWED to specify the newest version whose API you want to use.

Functions

Types and Values

GDK_WINDOWING_X11

#define GDK_WINDOWING_X11

The GDK_WINDOWING_X11 macro is defined if the X11 backend is supported.

Use this macro to guard code that is specific to the X11 backend.


GDK_WINDOWING_WIN32

#define GDK_WINDOWING_WIN32

The GDK_WINDOWING_WIN32 macro is defined if the Win32 backend is supported.

Use this macro to guard code that is specific to the Win32 backend.


GDK_WINDOWING_QUARTZ

#define GDK_WINDOWING_QUARTZ

The GDK_WINDOWING_QUARTZ macro is defined if the Quartz backend is supported.

Use this macro to guard code that is specific to the Quartz backend.


GDK_WINDOWING_WAYLAND

#define GDK_WINDOWING_WAYLAND

The GDK_WINDOWING_WAYLAND macro is defined if the Wayland backend is supported.

Use this macro to guard code that is specific to the Wayland backend.


GDK_VERSION_3_0

#define GDK_VERSION_3_0         (G_ENCODE_VERSION (3, 0))

A macro that evaluates to the 3.0 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.4


GDK_VERSION_3_2

#define GDK_VERSION_3_2         (G_ENCODE_VERSION (3, 2))

A macro that evaluates to the 3.2 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.4


GDK_VERSION_3_4

#define GDK_VERSION_3_4         (G_ENCODE_VERSION (3, 4))

A macro that evaluates to the 3.4 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.4


GDK_VERSION_3_6

#define GDK_VERSION_3_6         (G_ENCODE_VERSION (3, 6))

A macro that evaluates to the 3.6 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.6


GDK_VERSION_3_8

#define GDK_VERSION_3_8         (G_ENCODE_VERSION (3, 8))

A macro that evaluates to the 3.8 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.8


GDK_VERSION_3_10

#define GDK_VERSION_3_10        (G_ENCODE_VERSION (3, 10))

A macro that evaluates to the 3.10 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.10


GDK_VERSION_3_12

#define GDK_VERSION_3_12        (G_ENCODE_VERSION (3, 12))

A macro that evaluates to the 3.12 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.12


GDK_VERSION_3_14

#define GDK_VERSION_3_14        (G_ENCODE_VERSION (3, 14))

A macro that evaluates to the 3.14 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.14


GDK_VERSION_3_16

#define GDK_VERSION_3_16        (G_ENCODE_VERSION (3, 16))

A macro that evaluates to the 3.16 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.16


GDK_VERSION_3_18

#define GDK_VERSION_3_18        (G_ENCODE_VERSION (3, 18))

A macro that evaluates to the 3.18 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.18


GDK_VERSION_3_20

#define GDK_VERSION_3_20        (G_ENCODE_VERSION (3, 20))

A macro that evaluates to the 3.20 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.18


GDK_VERSION_3_22

#define GDK_VERSION_3_22        (G_ENCODE_VERSION (3, 22))

A macro that evaluates to the 3.22 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.20


GDK_VERSION_3_90

#define GDK_VERSION_3_90        (G_ENCODE_VERSION (3, 90))

A macro that evaluates to the 3.90 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.90


GDK_VERSION_3_92

#define GDK_VERSION_3_92        (G_ENCODE_VERSION (3, 92))

A macro that evaluates to the 3.92 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.92


GDK_VERSION_3_94

#define GDK_VERSION_3_94        (G_ENCODE_VERSION (3, 94))

A macro that evaluates to the 3.94 version of GDK, in a format that can be used by the C pre-processor.

Since: 3.94


GDK_VERSION_MIN_REQUIRED

# define GDK_VERSION_MIN_REQUIRED      (GDK_VERSION_CUR_STABLE)

A macro that should be defined by the user prior to including the gdk.h header. The definition should be one of the predefined GDK version macros: GDK_VERSION_3_0, GDK_VERSION_3_2,...

This macro defines the lower bound for the GDK API to use.

If a function has been deprecated in a newer version of GDK, it is possible to use this symbol to avoid the compiler warnings without disabling warning for every deprecated function.

Since: 3.4


GDK_VERSION_MAX_ALLOWED

#  define GDK_VERSION_MAX_ALLOWED      GDK_VERSION_MIN_REQUIRED

A macro that should be defined by the user prior to including the gdk.h header. The definition should be one of the predefined GDK version macros: GDK_VERSION_3_0, GDK_VERSION_3_2,...

This macro defines the upper bound for the GDK API to use.

If a function has been introduced in a newer version of GDK, it is possible to use this symbol to get compiler warnings when trying to use that function.

Since: 3.4


GDK_DISABLE_DEPRECATION_WARNINGS

#define GDK_DISABLE_DEPRECATION_WARNINGS

A macro that should be defined before including the gdk.h header. If it is defined, no compiler warnings will be produced for uses of deprecated GDK and GTK+ APIs.