SDL_SetWindowModal(3)

SDL_SetWindowModal3

Toggle the state of the window as modal.

Usage

#include "SDL3/SDL.h"

bool SDL_SetWindowModal(SDL_Window *window, bool modal);

Header file

Defined in SDL3/SDL_video.h

Overview

To enable modal status on a window, the window must currently be the child window of a parent, or toggling modal status on will fail.

Function parameters

window

the window on which to set the modal state.

modal

true to toggle modal status on, false to toggle it off.

Return value

Returns true on success or false on failure; call

SDL_GetError () for more information.

Thread safety

This function should only be called on the main thread.

Availability

This function is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.