SDL_ShowAndroidToast - Man Page

Shows an Android toast notification.

Header File

Defined in SDL3/SDL_system.h

Synopsis

#include "SDL3/SDL.h"

bool SDL_ShowAndroidToast(const char *message, int duration, int gravity, int xoffset, int yoffset);

Description

Toasts are a sort of lightweight notification that are unique to Android.

https://developer.android.com/guide/topics/ui/notifiers/toasts

Shows toast in UI thread.

For the gravity parameter, choose a value from here, or -1 if you don't have a preference:

https://developer.android.com/reference/android/view/Gravity

Function Parameters

message

text message to be shown.

duration

0=short, 1=long.

gravity

where the notification should appear on the screen.

xoffset

set this parameter only when gravity >=0.

yoffset

set this parameter only when gravity >=0.

Return Value

Returns true on success or false on failure; call

SDL_GetError () for more information.

Thread Safety

It is safe to call this function from any thread.

Availability

This function is available since SDL 3.2.0.

Info

SDL 3.2.2 Simple Directmedia Layer SDL3 FUNCTIONS