bool SDL_PushEvent(SDL_Event *event);
| event | キューに加えるSDL_Event |
イベントキューは実際には双方向の通信チャネルとして使える. キューからイベントを読み込むだけでなく, 自分で作成したイベントをキューに入れることもできる. eventはキューに入れたいイベント構造体へのポインタである. イベントはキューにコピーされ, 呼び出し側はSDL_PushEvent()から戻った後にポインタの先をメモリから解放する.
メモ: 入力デバイスのイベントをキューに入れてもSDLの装置の状態は変わらない.
メモ: SDL_PushEvent()でキューに入れられたイベントはイベントフィルタを通過するが, SDL_PeepEvents()の場合は通過しない.
アプリケーション固有のイベントの種類の値は, 別のイベントと衝突しないためにSDL_RegisterEvents()で得る必要がある.
この関数はスレッドセーフである.