MiniGUI API Reference (MiniGUI-Standalone)  v3.2.0
A mature and proven cross-platform GUI system for embedded and smart IoT devices
Macros | Functions | Variables

Macros

#define IDS_MGST_WINDOW   0
 The identifier of the window system text. More...
 
#define IDS_MGST_START   1
 The identifier of the start system text. More...
 
#define IDS_MGST_REFRESH   2
 The identifier of the refresh background system text. More...
 
#define IDS_MGST_CLOSEALLWIN   3
 The identifier of the close all windows system text. More...
 
#define IDS_MGST_ENDSESSION   4
 The identifier of the end session system text. More...
 
#define IDS_MGST_OPERATIONS   5
 The identifier of the operations system text. More...
 
#define IDS_MGST_MINIMIZE   6
 The identifier of the minimize system text. More...
 
#define IDS_MGST_MAXIMIZE   7
 The identifier of the maximize system text. More...
 
#define IDS_MGST_RESTORE   8
 The identifier of the restore system text. More...
 
#define IDS_MGST_CLOSE   9
 The identifier of the close system text. More...
 
#define IDS_MGST_OK   10
 The identifier of the ok system text. More...
 
#define IDS_MGST_NEXT   11
 The identifier of the next system text. More...
 
#define IDS_MGST_CANCEL   12
 The identifier of the cancel system text. More...
 
#define IDS_MGST_PREV   13
 The identifier of the previous system text. More...
 
#define IDS_MGST_YES   14
 The identifier of the yes system text. More...
 
#define IDS_MGST_NO   15
 The identifier of the no system text. More...
 
#define IDS_MGST_ABORT   16
 The identifier of the abort system text. More...
 
#define IDS_MGST_RETRY   17
 The identifier of the retry system text. More...
 
#define IDS_MGST_IGNORE   18
 The identifier of the ignore system text. More...
 
#define IDS_MGST_ABOUTMG   19
 The identifier of the about minigui system text. More...
 
#define IDS_MGST_OPENFILE   20
 The identifier of the open file system text. More...
 
#define IDS_MGST_SAVEFILE   21
 The identifier of the save file system text. More...
 
#define IDS_MGST_COLORSEL   22
 The identifier of the color selection system text. More...
 
#define IDS_MGST_SWITCHLAYER   23
 The identifier of the switch layer system text. More...
 
#define IDS_MGST_DELLAYER   24
 The identifier of the delete layer system text. More...
 
#define IDS_MGST_ERROR   25
 The identifier of the error system text. More...
 
#define IDS_MGST_LOGO   26
 The identifier of the logo system text. More...
 
#define IDS_MGST_CURRPATH   27
 The identifier of the current path system text. More...
 
#define IDS_MGST_FILE   28
 The identifier of the file system text. More...
 
#define IDS_MGST_LOCATION   29
 The identifier of the location system text. More...
 
#define IDS_MGST_UP   30
 The identifier of the up system text. More...
 
#define IDS_MGST_NAME   31
 The identifier of the name system text. More...
 
#define IDS_MGST_SIZE   32
 The identifier of the size system text. More...
 
#define IDS_MGST_ACCESSMODE   33
 The identifier of the access mode system text. More...
 
#define IDS_MGST_LASTMODTIME   34
 The identifier of the last modify time system text. More...
 
#define IDS_MGST_OPEN   35
 The identifier of the open system text. More...
 
#define IDS_MGST_FILENAME   36
 The identifier of the file name system text. More...
 
#define IDS_MGST_FILETYPE   37
 The identifier of the file type system text. More...
 
#define IDS_MGST_SHOWHIDEFILE   38
 The identifier of the show hide file system text. More...
 
#define IDS_MGST_NOTFOUND   39
 The identifier of the not found file system text. More...
 
#define IDS_MGST_NR   40
 The identifier of the can't read system text. More...
 
#define IDS_MGST_NW   41
 The identifier of the can't write system text. More...
 
#define IDS_MGST_INFO   42
 The identifier of the information system text. More...
 
#define IDS_MGST_R   43
 The identifier of the read system text. More...
 
#define IDS_MGST_W   44
 The identifier of the write system text. More...
 
#define IDS_MGST_WR   45
 The identifier of the read and write system text. More...
 
#define IDS_MGST_SAVE   46
 The identifier of the save system text. More...
 
#define IDS_MGST_FILEEXIST   47
 The identifier of the file exist system text. More...
 

Functions

MG_EXPORT const char *GUIAPI GetSysText (unsigned int id)
 Translates system text to localized text. More...
 
MG_EXPORT const char **GUIAPI GetSysTextInUTF8 (const char *language)
 Gets the localized system text array in UTF-8 for a specified language. More...
 

Variables

MG_EXPORT const char * SysText []
 Contains all text used by MiniGUI in English. More...
 
MG_EXPORT const char ** local_SysText
 The pointer to the current localized system text array. More...
 

Detailed Description

Macro Definition Documentation

#define IDS_MGST_ABORT   16

The identifier of the abort system text.

Definition at line 3138 of file minigui.h.

#define IDS_MGST_ABOUTMG   19

The identifier of the about minigui system text.

Definition at line 3156 of file minigui.h.

#define IDS_MGST_ACCESSMODE   33

The identifier of the access mode system text.

Definition at line 3240 of file minigui.h.

#define IDS_MGST_CANCEL   12

The identifier of the cancel system text.

Definition at line 3114 of file minigui.h.

#define IDS_MGST_CLOSE   9

The identifier of the close system text.

Definition at line 3096 of file minigui.h.

#define IDS_MGST_CLOSEALLWIN   3

The identifier of the close all windows system text.

Definition at line 3060 of file minigui.h.

#define IDS_MGST_COLORSEL   22

The identifier of the color selection system text.

Definition at line 3174 of file minigui.h.

#define IDS_MGST_CURRPATH   27

The identifier of the current path system text.

Definition at line 3204 of file minigui.h.

#define IDS_MGST_DELLAYER   24

The identifier of the delete layer system text.

Definition at line 3186 of file minigui.h.

#define IDS_MGST_ENDSESSION   4

The identifier of the end session system text.

Definition at line 3066 of file minigui.h.

#define IDS_MGST_ERROR   25

The identifier of the error system text.

Definition at line 3192 of file minigui.h.

#define IDS_MGST_FILE   28

The identifier of the file system text.

Definition at line 3210 of file minigui.h.

#define IDS_MGST_FILEEXIST   47

The identifier of the file exist system text.

Definition at line 3324 of file minigui.h.

#define IDS_MGST_FILENAME   36

The identifier of the file name system text.

Definition at line 3258 of file minigui.h.

#define IDS_MGST_FILETYPE   37

The identifier of the file type system text.

Definition at line 3264 of file minigui.h.

#define IDS_MGST_IGNORE   18

The identifier of the ignore system text.

Definition at line 3150 of file minigui.h.

#define IDS_MGST_INFO   42

The identifier of the information system text.

Definition at line 3294 of file minigui.h.

#define IDS_MGST_LASTMODTIME   34

The identifier of the last modify time system text.

Definition at line 3246 of file minigui.h.

#define IDS_MGST_LOCATION   29

The identifier of the location system text.

Definition at line 3216 of file minigui.h.

#define IDS_MGST_LOGO   26

The identifier of the logo system text.

Definition at line 3198 of file minigui.h.

#define IDS_MGST_MAXIMIZE   7

The identifier of the maximize system text.

Definition at line 3084 of file minigui.h.

#define IDS_MGST_MINIMIZE   6

The identifier of the minimize system text.

Definition at line 3078 of file minigui.h.

#define IDS_MGST_NAME   31

The identifier of the name system text.

Definition at line 3228 of file minigui.h.

#define IDS_MGST_NEXT   11

The identifier of the next system text.

Definition at line 3108 of file minigui.h.

#define IDS_MGST_NO   15

The identifier of the no system text.

Definition at line 3132 of file minigui.h.

#define IDS_MGST_NOTFOUND   39

The identifier of the not found file system text.

Definition at line 3276 of file minigui.h.

#define IDS_MGST_NR   40

The identifier of the can't read system text.

Definition at line 3282 of file minigui.h.

#define IDS_MGST_NW   41

The identifier of the can't write system text.

Definition at line 3288 of file minigui.h.

#define IDS_MGST_OK   10

The identifier of the ok system text.

Definition at line 3102 of file minigui.h.

#define IDS_MGST_OPEN   35

The identifier of the open system text.

Definition at line 3252 of file minigui.h.

#define IDS_MGST_OPENFILE   20

The identifier of the open file system text.

Definition at line 3162 of file minigui.h.

#define IDS_MGST_OPERATIONS   5

The identifier of the operations system text.

Definition at line 3072 of file minigui.h.

#define IDS_MGST_PREV   13

The identifier of the previous system text.

Definition at line 3120 of file minigui.h.

#define IDS_MGST_R   43

The identifier of the read system text.

Definition at line 3300 of file minigui.h.

#define IDS_MGST_REFRESH   2

The identifier of the refresh background system text.

Definition at line 3054 of file minigui.h.

#define IDS_MGST_RESTORE   8

The identifier of the restore system text.

Definition at line 3090 of file minigui.h.

#define IDS_MGST_RETRY   17

The identifier of the retry system text.

Definition at line 3144 of file minigui.h.

#define IDS_MGST_SAVE   46

The identifier of the save system text.

Definition at line 3318 of file minigui.h.

#define IDS_MGST_SAVEFILE   21

The identifier of the save file system text.

Definition at line 3168 of file minigui.h.

#define IDS_MGST_SHOWHIDEFILE   38

The identifier of the show hide file system text.

Definition at line 3270 of file minigui.h.

#define IDS_MGST_SIZE   32

The identifier of the size system text.

Definition at line 3234 of file minigui.h.

#define IDS_MGST_START   1

The identifier of the start system text.

Definition at line 3048 of file minigui.h.

#define IDS_MGST_SWITCHLAYER   23

The identifier of the switch layer system text.

Definition at line 3180 of file minigui.h.

#define IDS_MGST_UP   30

The identifier of the up system text.

Definition at line 3222 of file minigui.h.

#define IDS_MGST_W   44

The identifier of the write system text.

Definition at line 3306 of file minigui.h.

#define IDS_MGST_WINDOW   0

The identifier of the window system text.

Definition at line 3042 of file minigui.h.

#define IDS_MGST_WR   45

The identifier of the read and write system text.

Definition at line 3312 of file minigui.h.

#define IDS_MGST_YES   14

The identifier of the yes system text.

Definition at line 3126 of file minigui.h.

Function Documentation

const char *GUIAPI GetSysText ( unsigned int  id)

Translates system text to localized text.

When MiniGUI display some system messages, it will call GetSysText function to translate system text from English to other language. Global variable SysText contains all text used by MiniGUI in English.

GetSysText function returns localized text from local_SysText. MiniGUI have already defined localized sytem text for en_US, zh_CN.GB2312 and zh_TW.Big5 locales. MiniGUI initializes local_SysText to point one of above localized system text when startup. You can also let local_SysText point to your customized string array.

Parameters
idThe system text id.
Returns
The localized text.
See also
SysText, local_SysText
const char **GUIAPI GetSysTextInUTF8 ( const char *  language)

Gets the localized system text array in UTF-8 for a specified language.

This function returns the localized system text array in UTF-8 encode for the specified language. You can use the returned localized system text array to set local_SysText if your system logical fonts are using UNICODE/UTF-8 charset.

Parameters
languageThe language name. So far, you can specify the language as 'zh_CN' (for simlified Chinese) or 'zh_TW' (for tranditional Chinese).
Returns
The pointer to the localized system text array.
See also
SysText, local_SysText

Variable Documentation

const char ** local_SysText

The pointer to the current localized system text array.

Changing local_SysText will lead to GetSysText returns a different localized system text. Please set it when MiniGUI starts and send desktop a MSG_REINITSESSION message (call ReinitDesktop function) after assigned a different value to this variable.

See also
GetSysText, SysText, ReinitDesktopEx
const char * SysText[]

Contains all text used by MiniGUI in English.

System text defined as follows in MiniGUI:

1 const char* SysText [] =
2 {
3  "Windows...",
4  "Start...",
5  "Refresh Background",
6  "Close All Windows",
7  "End Session",
8  "Operations...",
9  "Minimize",
10  "Maximize",
11  "Restore",
12  "Close",
13  "OK",
14  "Next",
15  "Cancel",
16  "Previous",
17  "Yes",
18  "No",
19  "Abort",
20  "Retry",
21  "Ignore",
22  "About MiniGUI...",
23  "Open File",
24  "Save File",
25  "Color Selection",
26  "Switch Layer",
27  "Delete Layer",
28  "Error",
29  "LOGO",
30  "Current Path",
31  "File",
32  #if (!defined (__NOUNIX__) || defined (WIN32)) && defined (_MGCTRL_LISTVIEW)
33 
34  "Location",
35  "Up",
36  "Name",
37  "Size",
38  "Access Mode",
39  "Last Modify Time",
40  "Open",
41  "File Name",
42  "File Type",
43  "Show Hide File",
44  "Sorry! not find %s ",
45  "Can't Read %s !",
46  "Can't Write %s !",
47  "Information",
48  "R",
49  "W",
50  "WR",
51  "Save",
52  "File %s exists, Replace or not?",
53  #endif
54  NULL
55 };
See also
GetSysText, local_SysText