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

# SDL_GetDisplayUsableBounds

主ディスプレイの位置を(0,0)とした場合の指定のディスプレイの利用可能な表示領域を得る

## 構文

`int SDL_GetDisplayUsableBounds(int displayIndex, SDL_Rect* rect)`

## 引数

displayIndex | 調査するディスプレイの番号
rect | ディスプレイの表示領域を代入するSDL_Rectポインタ

## 戻り値

成功のとき0, 失敗のとき負の数のエラーコードを戻す. SDL_GetError()を呼んで詳細を知ることができる.

## 詳細

これはSDL_GetDisplayBounds()と同じ表示領域を戻すが, システムが予約している部分が取り除かれている. 例えばApple Mac OS Xのならば, メニューバーとdockの占有する部分が引かれている.

ウィンドウをフルスクリーンにすると, 通常はこれらの領域は考慮されない. よって, この関数はフルスクリーンでないウィンドウで利用できる最大のサイズを得るよい指針となる.

引数rectがNULLの場合, 無視される.

引数displayIndexが範囲外の場合も, この関数は-1を戻す.

## バージョン

この関数はSDL 2.0.4 (stable)以降で不安定なバージョンが使える.

## 関連項目(関数)

SDL_GetDisplayBounds
SDL_GetNumVideoDisplays

## SDL Wikiへのリンク

SDL_GetDisplayUsableBounds - SDL Wiki