Font_DecodeMenu (changes)
Showing changes from revision #3 to #4:
Added | Removed | Changed
» FontManager
» SWI Calls
» Font_DecodeMenu
Font_DecodeMenu
(SWI &400A0)
| Entry | |
|---|---|
| R0 | Font_DecodeMenu Flags |
| R1 | Pointer to menu definition, as per Font_ListFonts |
| R2 | Pointer to menu selection, as per Menu_Selection within Wimp_Poll |
| R3 | Pointer to buffer to contain result, or 0 to return size |
| R4 | Size of buffer (if R3 <> 0) |
| Exit | |
|---|---|
| R0 | Preserved |
| R1 | Preserved |
| R2 | Pointer to rest of menu selections |
| R3 | Preserved |
| R4 | Size of buffer required, or 0 for no font selection |
Use
This call decodes the selection made from a font menu.
Notes
The definition of the font menu is returned in the same format as used by Font_ListFonts.
The format of the returned string depends on whether the names of the fonts or font encodings have been specified in the Messages_n_ file within the font directory.
If no Messages_n_ file was found (and hence the Font Manager has found the font names by scanning the directory tree) the name field is absent.
Details of the Font_DecodeMenu Result are available.
Experimentation with this call suggests that passing in a selection block pointing at the System Font will generate an error, rather than set R4 = 0.
See also
- Font_DecodeMenu Flags
- Font_DecodeMenu Result
- Message_Selection?
- Wimp_Poll
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.