目次 - SDL 3.0 API(機能別) - ディスプレイとウィンドウ - SDL_SetWindowSize

SDL_SetWindowSize

ウィンドウのクライアント領域のサイズの設定を要求する

ヘッダ

SDL3/SDL_video.h

構文

bool SDL_SetWindowSize(SDL_Window *window, int w, int h);

引数

SDL_Window *window変更するウィンドウ
intwウィンドウの幅. >0の必要がある
inthウィンドウの高さ. >0の必要がある

戻り値

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

詳細

ウィンドウがフルスクリーンまたは最大化の場合は, この要求は効果がない.

ウィンドウの排他的フルスクリーンモードの変更はSDL_SetWindowFullscreenMode()で行える.

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

ウィンドウのサイズが変わると, 新しいサイズでSDL_EVENT_WINDOW_RESIZEDイベントが発生する. 一部のウィンドウシステムは様々な条件でウィンドウの位置を制限する(例えば表示領域をデスクトップの利用可能範囲に収まるようにする)場合があるため, ウィンドウのサイズは要求したサイズと正確には一致しない場合があるので注意すること.

スレッドセーフ

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

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_SetWindowSize - SDL Wiki