int SDL_GetDisplayUsableBounds(int displayIndex, SDL_Rect* rect)
| displayIndex | 調査するディスプレイの番号 |
| rect | ディスプレイの表示領域を代入するSDL_Rectポインタ |
成功のとき0, 失敗のとき負の数のエラーコードを戻す. SDL_GetError()を呼んで詳細を知ることができる.
主ディスプレイ(ディスプレイ番号0)の位置は常に(0,0)である.
これはSDL_GetDisplayBounds()と同じ表示領域を戻すが, システムが予約している部分が取り除かれている. 例えばApple Mac OS Xのならば, メニューバーとdockの占有する部分が引かれている.
ウィンドウをフルスクリーンにすると, 通常はこれらの領域は考慮されない. よって, この関数はフルスクリーンでないウィンドウで利用できる最大のサイズを得るよい指針となる.
引数rectがNULLの場合, 無視される.
引数displayIndexが範囲外の場合も, この関数は-1を戻す.
SDL 2.0.5以降