SDL_MaximizeWindow

ウィンドウの最大化を要求する

ヘッダ

bool SDL_MaximizeWindow(SDL_Window *window);

window

最大化させるウィンドウ

(bool) 成功のとき真, 失敗のとき偽を戻す. SDL_GetError()を呼んで詳細を知ることができる.

サイズ変更できないウィンドウは最大化できない. ウィンドウはSDL_WINDOW_RESIZABLEフラグが設定されている必要がある. そうでない場合は効果がない.

一部のウィンドウシステムでは, この要求は非同期で, この関数から戻っても新しいウィンドウの状態は即座には適応されない. 即座に変更したい場合は, SDL_SyncWindow()を呼んで変更されるまでブロックすること.

ウィンドウの状態が変わると, SDL_EVENT_WINDOW_MAXIMIZEDイベントが発生する. これは単に要求するだけであり, ウィンドウシステムは状態の変更を遅らせる可能性があるので注意すること.

ウィンドウを最大化するとき, SDL_SetWindowMaximumSize()で設定した制約の扱いは, ウィンドウマネージャの方針に依存する. Win32とmacOSでは制約され, X11とWaylandでは異なる場合がある.

この関数を呼べるのはメインスレッドのみである.

SDL 3.2.0以降