目次 - API(機能別) - イベント処理 - SDL_RegisterEvents

SDL_RegisterEvents

複数のユーザ定義のイベントの領域を確保し, 先頭のイベントの番号を戻す

構文

Uint32 SDL_RegisterEvents(int numevents)

引数

numevents確保するイベントの数

戻り値

成功のとき先頭のイベント番号, ユーザ定義イベントを確保できないとき(Uint32)-1を戻す.

サンプルコード

Uint32 myEventType = SDL_RegisterEvents(1);
if (myEventType != ((Uint32)-1)) {
    SDL_Event event;
    SDL_memset(&event, 0, sizeof(event)); /* または SDL_zero(event) */
    event.type = myEventType;
    event.user.code = my_event_code;
    event.user.data1 = significant_data;
    event.user.data2 = 0;
    SDL_PushEvent(&event);
}

詳細

numeventsを0以下にしてこの関数を呼ぶとエラーとなり(Uint32)-1を戻す.

メモ: (Uint32)-1は32bit符号なしの最大値(0xFFFFFFFF)だが, そのように書くより意味が明確である.

バージョン

SDL 2.0.0以降

関連項目(関数)

SDL_PushEvent

SDL Wikiへのリンク

SDL_RegisterEvents - SDL Wiki