SDL_syswm.h File Reference

#include "SDL_stdinc.h"
#include "SDL_error.h"
#include "SDL_video.h"
#include "SDL_version.h"
#include <X11/Xlib.h>
#include <X11/Xatom.h>
#include "begin_code.h"
#include "close_code.h"

Include dependency graph for SDL_syswm.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	SDL_SysWMmsg
struct	SDL_SysWMinfo

Enumerations
enum	SDL_SYSWM_TYPE {   SDL_SYSWM_UNKNOWN ,   SDL_SYSWM_WINDOWS ,   SDL_SYSWM_X11 ,   SDL_SYSWM_DIRECTFB ,   SDL_SYSWM_COCOA ,   SDL_SYSWM_UIKIT ,   SDL_SYSWM_WAYLAND ,   SDL_SYSWM_MIR ,   SDL_SYSWM_WINRT ,   SDL_SYSWM_ANDROID ,   SDL_SYSWM_VIVANTE ,   SDL_SYSWM_OS2 ,   SDL_SYSWM_HAIKU }

Functions
SDL_bool	SDL_GetWindowWMInfo (SDL_Window *window, SDL_SysWMinfo *info)
	This function allows access to driver-dependent window information. More...

Detailed Description

Include file for SDL custom system window manager hooks.

Definition in file SDL_syswm.h.

Enumeration Type Documentation

SDL_SYSWM_TYPE

enum SDL_SYSWM_TYPE

These are the various supported windowing subsystems

Enumerator
SDL_SYSWM_UNKNOWN
SDL_SYSWM_WINDOWS
SDL_SYSWM_X11
SDL_SYSWM_DIRECTFB
SDL_SYSWM_COCOA
SDL_SYSWM_UIKIT
SDL_SYSWM_WAYLAND
SDL_SYSWM_MIR
SDL_SYSWM_WINRT
SDL_SYSWM_ANDROID
SDL_SYSWM_VIVANTE
SDL_SYSWM_OS2
SDL_SYSWM_HAIKU

Definition at line 127 of file SDL_syswm.h.

{
    SDL_SYSWM_UNKNOWN,
    SDL_SYSWM_WINDOWS,
    SDL_SYSWM_X11,
    SDL_SYSWM_DIRECTFB,
    SDL_SYSWM_COCOA,
    SDL_SYSWM_UIKIT,
    SDL_SYSWM_WAYLAND,
    SDL_SYSWM_MIR,  /* no longer available, left for API/ABI compatibility. Remove in 2.1! */
    SDL_SYSWM_WINRT,
    SDL_SYSWM_ANDROID,
    SDL_SYSWM_VIVANTE,
    SDL_SYSWM_OS2,
    SDL_SYSWM_HAIKU
} SDL_SYSWM_TYPE;

Function Documentation

SDL_GetWindowWMInfo()

SDL_bool SDL_GetWindowWMInfo	(	SDL_Window *	window,
		SDL_SysWMinfo *	info
	)

This function allows access to driver-dependent window information.

Parameters

window	The window about which information is being requested
info	This structure must be initialized with the SDL version, and is then filled in with information about the given window.

Returns

SDL_TRUE if the function is implemented and the version member of the info struct is valid, SDL_FALSE otherwise.

You typically use this function like this:

SDL_SysWMinfo info;
SDL_VERSION(&info.version);
if ( SDL_GetWindowWMInfo(window, &info) ) { ... }

Definition at line 3857 of file SDL_video.c.

{
    CHECK_WINDOW_MAGIC(window, SDL_FALSE);
 
    if (!info) {
        SDL_InvalidParamError("info");
        return SDL_FALSE;
    }
    info->subsystem = SDL_SYSWM_UNKNOWN;
 
    if (!_this->GetWindowWMInfo) {
        SDL_Unsupported();
        return SDL_FALSE;
    }
    return (_this->GetWindowWMInfo(_this, window, info));
}

References _this, CHECK_WINDOW_MAGIC, SDL_VideoDevice::GetWindowWMInfo, SDL_FALSE, SDL_InvalidParamError, SDL_SYSWM_UNKNOWN, SDL_Unsupported, and SDL_SysWMinfo::subsystem.

Referenced by SDL_MessageboxValidForDriver().