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

SDL_GetDisplayForWindow

ウィンドウが含まれるディスプレイを得る

ヘッダ

SDL3/SDL_video.h

構文

SDL_DisplayID SDL_GetDisplayForWindow(SDL_Window *window);

引数

const SDL_Window *rect問い合わせるウィンドウ

戻り値

(SDL_DisplayID) windowの中央が含まれるディスプレイのインスタンスIDを戻す. 失敗のとき0を戻す. SDL_GetError()を呼んで詳細を知ることができる.

スレッドセーフ

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

バージョン

SDL 3.2.0以降

サンプルコード

// サンプルプログラム:
// SDL3でウィンドウが生成されたディスプレイをログに出力する

#include <SDL3/SDL_log.h>
#include <SDL3/SDL_main.h>
#include <SDL3/SDL_video.h>

int
main(int argc, char** argv)
{
  if (!SDL_Init(SDL_INIT_VIDEO)) {
    SDL_Log("SDLを初期化できなかった: %s", SDL_GetError());
    return 0;
  }

  SDL_Window* window = SDL_CreateWindow("My Window", 640, 480, 0);
  if(window == NULL) {
    SDL_Log("ウィンドウを生成できなかった: %s", SDL_GetError());
    return 0;
  }

  SDL_DisplayID display_id = SDL_GetDisplayForWindow(window);
  SDL_Log("ウィンドウはディスプレイ'%s'に生成された", SDL_GetDisplayName(display_id));

  SDL_DestroyWindow(window);

  return 0;
}

関連項目

SDL Wikiへのリンク

SDL_GetDisplayForWindow - SDL Wiki