SDL_Event

フィールド

詳細

SDL_Eventは全てのSDLイベント処理の中核で, SDLで使われる全てのイベント構造体の共用体である. どのイベントがどの共用体のメンバに対応しているかを知るのは簡単である. 後の表にその関係がある.

SDL_Eventには2つの使い方がある

• キューからイベントを読み込む
• キューにイベントを書き込む

キューからイベントを読み込む

SDL_PollEvent()またはSDL_PeepEvents()でキューからイベントを得られる. SDL_PollEvent()を例に説明する.

まず始めに, 空のSDL_Eventを生成する.

SDL_Event test_event;

SDL_PollEvent()はイベントを読み込み, キューから削除する. もしキューにイベントがなければ0を, あれば1を戻す. whileループを使い, 全てのイベントを処理する.

while (SDL_PollEvent(&test_event)) {

SDL_PollEvent()は引数のSDL_Eventへのポインタにイベント情報を代入する. SDL_PollEvent()はイベントをキューから取り除き, その後test_eventに書き込む. しかし, test_eventのtypeメンバにはイベントの種類も書き込まれている. よって, 種類に応じてイベントを処理するためにはswitch文を使う.

switch (test_event.type) {

得られたイベントが何であるか, そしてそのイベントの種類は何であるかを知る必要がある. ここでは, アプリケーションでユーザがマウスを動かしたことを検知したいと想定する. イベント種類を見渡すと, SDL_MOUSEMOTIONに気がつく. これが探しているイベントだろう. 後の表を見ると, SDL_MOUSEMOTIONイベントはSDL_EventのメンバのSDL_MouseMotionEventで処理することが分かる. SDL_MOUSEMOTIONのイベントの種類はswitch文の内部で次のようにチェックできる.

	case SDL_MOUSEMOTION:

test_eventのmotionメンバの情報を全て表示したいとすると

		printf("マウス移動イベントを得た.\n");
		printf("現在の位置は(%d, %d)\n", test_event.motion.x, test_event.motion.y);
		break;
	default:
		printf("処理されないイベント!\n");
		break;
	}
}
printf("イベントキューは空.\n");

キューにイベントを書き込む

SDL_Event user_event;

user_event.type = SDL_USEREVENT;
user_event.user.code = 2;
user_event.user.data1 = NULL;
user_event.user.data2 = NULL;
SDL_PushEvent(&user_event);

イベントの種類と共用体のメンバの関係

関連項目(列挙体)

関連項目(構造体)

関連項目(関数)

SDL Wikiへのリンク