utils.fontpicker
Summary
Invokes the Windows standard "font picker" dialog box
Prototype
filename = utils.fontpicker (name, size, colour)Description
This invokes the Windows standard "font picker" dialog box, which lets you choose a font from those installed on your system.
wanted_font = utils. fontpicker (name, size, colour)
- name - preferred name (eg. name of the currently-selected font)
- size - preferred size in points
- colour - preferred colour as an RGB colour
All arguments are optional.
Returns nil if dialog dismissed, or the chosen font details (see below) if not.
If not dismissed, the font details are returned as a table, with the following entries:
- name - chosen name (eg. "Comic Sans MS")
- size - size in points (eg. 12)
- colour - colour as an RGB colour code (eg. 0 for black)
- charset - character set code
- underline - 1 if underline chosen, 0 if not
- strikeout - 1 if strikeout chosen, 0 if not
- italic - 1 if italic chosen, 0 if not
- bold - 1 if bold chosen, 0 if not
- style - the style as a string (eg. "Bold Italic")
See Also ...
Topics
Lua base functions
Lua bc (big number) functions
Lua bit manipulation functions
Lua coroutine functions
Lua debug functions
Lua io functions
Lua LPEG library
Lua math functions
Lua os functions
Lua package functions
Lua PCRE regular expression functions
Lua script extensions
Lua string functions
Lua table functions
Lua utilities
ScriptingLua functions
utils.base64decode (Decode a string which was base-64 encoded)
utils.base64encode (Encode a string with base-64 encoding)
utils.choose (Display a combo box with choices in it)
utils.compress (Compress a string)
utils.decompress (Decompress a string)
utils.directorypicker (Invokes the Windows standard "directory picker" dialog box)
utils.editbox (Display a large message box and get free-format reply)
utils.edit_distance (Returns the Levenshtein Edit Distance between two words)
utils.filepicker (Invokes the Windows standard "file picker" dialog box)
utils.fromhex (Convert a string from hex)
utils.functionlist (Returns a table of MUSHclient world function names)
utils.getfontfamilies (Returns all fonts available to Windows)
utils.hash (Hash a string, returning the hex codes)
utils.info (Information about directories, locale, etc.)
utils.inputbox (Display a message box and get free-format reply)
utils.listbox (Display a dialog box with choices in it in a single selection list box)
utils.md5 (Hash a string using the 128-bit MD5 algorithm)
utils.metaphone (Returns metaphones (sound-alike codes) for the supplied word)
utils.msgbox (Display a message box and get a response)
utils.multilistbox (Display a dialog box with choices in it in a multiple selection list box)
utils.readdir (Read a disk directory into a table)
utils.sha256 (Hash a string using a 256-bit hash)
utils.spellcheckdialog (Spell-checker dialog)
utils.split (Split a delimited string into a table)
utils.tohex (Convert a string into hex)
utils.umsgbox (Display a message box and get a response (Unicode))
utils.utf8decode (Encodes a series of Unicode codes into a UTF-8 string)
utils.utf8encode (Encodes a series of Unicode codes into a UTF-8 string)
utils.utf8sub (Returns a substring of a UTF-8 string)
utils.utf8valid (Checks if a UTF-8 string is valid)
utils.xmlread (Parses an XML string into a nested table)(Help topic: lua=utils.fontpicker)
Documentation contents page