目次 - 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