bool SDL_SetWindowParent(SDL_Window *window, SDL_Window *parent);
| SDL_Window * | window | 子にするウィンドウ |
| SDL_Window * | parent | 親にするウィンドウ |
成功のとき0, 失敗のとき負の数のエラーコードを戻す. SDL_GetError()を呼んで詳細を知ることができる.
子ウィンドウに既に親ウィンドウがある場合は, 新しい親ウィンドウに変わる. 親ウィンドウにNULLを設定すると, 親ウィンドウは解除され, 子ウィンドウ状態でなくなる.
親ウィンドウを非表示にする, または破棄すると, その操作は再帰的に子ウィンドウにも適用される. 実際に子ウィンドウを非表示状態にしたのではなく, 親ウィンドウによって非表示にされた子ウィンドウは, 親ウィンドウが表示されると元に戻る.
モーダルなウィンドウを親ウィンドウにしようとすると失敗する. 親ウィンドウにする前にSDL_SetWindowModal()でモーダルを解除する必要がある.
ポップアップウィンドウは親ウィンドウを変えることができず, 変えようとすると失敗する.
同じ親を持つウィンドウや, 自身の子ウィンドウを親ウィンドウに設定した場合は, 未定義の結果となる.
この関数を呼べるのはメインスレッドのみである.