#include <xkbcommon.h>

Detailed Description

Configures the policy used to bring out-of-range layout indices into range.

If policy is XKB_LAYOUT_OUT_OF_RANGE_REDIRECT, redirect specifies the target layout index; otherwise redirect is ignored.

Note

This struct uses a size-based versioning scheme to allow forward and backward compatibility between callers and the library:

Older callers (smaller struct): Trailing fields unknown to the caller default to zero in the library.
Newer callers (larger struct): Accepted only if all trailing bytes unknown to the library are zero.

Precondition: The struct MUST be initialized with memset() before setting any fields:
struct xkb_layout_policy_update update;

memset(&update, 0, sizeof(update));

update.size = sizeof(update);

update.policy = …;

xkb_layout_policy_update
Configures the policy used to bring out-of-range layout indices into range.
Definition xkbcommon.h:3608

Invariant: size MUST be explicitly set to sizeof(struct xkb_layout_policy_update).; All bytes of the struct, including padding, MUST remain zero except for explicitly assigned fields.