目次 - SDL 3.0 API(機能別) - システムトレイ - SDL_InsertTrayEntryAt

SDL_InsertTrayEntryAt

トレイの項目を指定の場所に挿入する

ヘッダ

SDL3/SDL_tray.h

構文

SDL_TrayEntry * SDL_InsertTrayEntryAt(SDL_TrayMenu *menu, int pos, const char *label, SDL_TrayEntryFlags flags);

引数

SDL_TrayMenu *menu項目を追加するメニュー
intpos新しい項目の位置. 既にある項目は削除される. -1とすると追加される
const char *label項目に表示するUTF-8文字列. NULLのとき区切り
SDL_TrayEntryFlagsflagsフラグの組み合わせ. 一部は必須

戻り値

(SDL_TrayEntry *) 新しく追加された項目を戻す. posが範囲外のときNULLを戻す.

詳細

labelがNULLの場合, その項目は区切りになる. 多くの関数は区切りに対して効果がない.

項目は破棄する必要はない. トレイと共に破棄される.

スレッドセーフ

この関数はトレイを生成したスレッドで呼ぶ必要がある.

バージョン

SDL 3.2.0以降

関連項目

SDL Wikiへのリンク

SDL_InsertTrayEntryAt - SDL Wiki