Difference between revisions of "Custom Windows"
From Scriptwiki
(continued a bit) |
m (Reverted edit of Microbe, changed back to last version by Cail) |
||
| Line 1: | Line 1: | ||
| + | {{Stub}} | ||
| + | Custom windows are windows that can be created by the user and modified to look like almost anything. They can play any type or a role you wish: they can for example replace normal channel windows or they can be used to filter messages from queries. | ||
| + | |||
| + | '''/window [-abBcCdeEfg[N]hikl[N]mnoprRsvwxz] [-tN,..,N] [+bdeflLmnstx] <@name> [x y [w h]] [/command] [popup.txt] [font [size]] [iconfile [N]]''' | ||
| + | |||
| + | Explanations of the different switches: | ||
| + | |||
| + | a = activate the window | ||
| + | b = update horizontal scrollbar width for listbox (TODO: better explanation?) | ||
| + | B = prevent the window from using an internal border | ||
| + | c = close the window | ||
| + | C = center window when first created | ||
| + | d = open the window as a desktop window | ||
| + | D = allows toggling of the window between mdi and desktop (TODO: what's this?) | ||
| + | e = add a single-line editbox to the window | ||
| + | E = add a multi-line editbox to the window | ||
| + | f = indicates that w h are the required width and height of the text display area as opposed to the window's size (TODO: huh?) | ||
| + | g[N] = sets/removes hilight for a window button, 0 = none, 1 = message color, 2 = hilight color. Default = TODO? | ||
| + | h = hide window button from the switchbar. The window can still be modified and closed normally. To reverse, use -w or -z. | ||
| + | H = enables auto-hide for a side-listbox (TODO: huh?) | ||
| + | i = dynamically associate with whatever happens to be the active connection (TODO: huh?) | ||
| + | k[N] = hides the @ prefix in the window name, 0 = hide prefix, 1 = show prefix. Default = 0. | ||
| + | l[N] = listbox, if N is specified then a side-listbox N characters wide is created. If no N is given, the default size is used. | ||
| + | m = allow line marker to be used in window. The line marker can be turned on by Ctrl+L. | ||
| + | n[N] = minimize window, 2 = minimize without auto-expanding item in treebar (TODO: huh?) | ||
| + | o = if opened on desktop, place ontop of all other desktop windows | ||
| + | p = creates a [[Picture_Windows|picture window]] | ||
| + | r = restore window (TODO: huh?) | ||
| + | R = reset window's size and position to previously saved values | ||
| + | s = sort the main window, whether text or listbox (TODO: alphabetically or what?) | ||
| + | S = sort the side-listbox (TODO: ...) | ||
| + | u = if the window was created with -o, remove ontop setting of the window | ||
| + | v = close window when associated status window is closed (TODO: huh?) | ||
| + | w[N] = where 0 = hide from switchbar/treebar, 1 = show in switchbar, 2 = show in treebar, 3 = show in both (TODO: Default?) | ||
| + | x = maximize window | ||
| + | z = place window button at the end of the switchbar | ||
| + | t[N,...,N] = tab positions in a listbox. if text contains tabs it will be spaced out according to these tab settings | ||
| + | |||
| + | The switches that start with + are used to change the appearance of the window: | ||
| + | |||
| + | b = use a border | ||
| + | d = don't use a border | ||
| + | e = 3d edges | ||
| + | f = dialog frame (make it look more like a dialog) | ||
| + | l = tool window (TODO: huh? can't remember) | ||
| + | L = tool window but window won't appear in taskbar (TODO: ...) | ||
| + | n = minimize box (TODO: what box?) | ||
| + | s = make the window sizable | ||
| + | t = add only the "x" button to the upper right corner | ||
| + | x = maximize box (TODO: what box?) | ||
| + | |||
| + | '''Note:''' some switches may automatically turn other switches on/off. | ||
| + | |||
| + | The rest of the command options: | ||
| + | |||
| + | @name = window name (must prefix with a @ even if the @ would be left out from its title) | ||
| + | x,y,w,h = position in x-axis, position in y-axis, width, height | ||
| + | popup.txt = popup filename to be used for the window, loaded when needed (must be a plain non-ini text file) | ||
| + | /command = default command (executed whenever you enter text in an editbox) (TODO: in any editbox or?) | ||
| + | font/size = font name and size to be used in the window (defaults to status window font) | ||
| + | iconfile/N = sets the titlebar icon for the window | ||
| + | |||
| + | '''Note:''' if you use -1 for any of the x,y,w,h values, the default value is used unless the window already exists in which case the current value is used. | ||
Revision as of 00:02, 24 November 2006
Custom windows are windows that can be created by the user and modified to look like almost anything. They can play any type or a role you wish: they can for example replace normal channel windows or they can be used to filter messages from queries.
/window [-abBcCdeEfg[N]hikl[N]mnoprRsvwxz] [-tN,..,N] [+bdeflLmnstx] <@name> [x y [w h]] [/command] [popup.txt] [font [size]] [iconfile [N]]
Explanations of the different switches:
a = activate the window b = update horizontal scrollbar width for listbox (TODO: better explanation?) B = prevent the window from using an internal border c = close the window C = center window when first created d = open the window as a desktop window D = allows toggling of the window between mdi and desktop (TODO: what's this?) e = add a single-line editbox to the window E = add a multi-line editbox to the window f = indicates that w h are the required width and height of the text display area as opposed to the window's size (TODO: huh?) g[N] = sets/removes hilight for a window button, 0 = none, 1 = message color, 2 = hilight color. Default = TODO? h = hide window button from the switchbar. The window can still be modified and closed normally. To reverse, use -w or -z. H = enables auto-hide for a side-listbox (TODO: huh?) i = dynamically associate with whatever happens to be the active connection (TODO: huh?) k[N] = hides the @ prefix in the window name, 0 = hide prefix, 1 = show prefix. Default = 0. l[N] = listbox, if N is specified then a side-listbox N characters wide is created. If no N is given, the default size is used. m = allow line marker to be used in window. The line marker can be turned on by Ctrl+L. n[N] = minimize window, 2 = minimize without auto-expanding item in treebar (TODO: huh?) o = if opened on desktop, place ontop of all other desktop windows p = creates a picture window r = restore window (TODO: huh?) R = reset window's size and position to previously saved values s = sort the main window, whether text or listbox (TODO: alphabetically or what?) S = sort the side-listbox (TODO: ...) u = if the window was created with -o, remove ontop setting of the window v = close window when associated status window is closed (TODO: huh?) w[N] = where 0 = hide from switchbar/treebar, 1 = show in switchbar, 2 = show in treebar, 3 = show in both (TODO: Default?) x = maximize window z = place window button at the end of the switchbar t[N,...,N] = tab positions in a listbox. if text contains tabs it will be spaced out according to these tab settings
The switches that start with + are used to change the appearance of the window:
b = use a border d = don't use a border e = 3d edges f = dialog frame (make it look more like a dialog) l = tool window (TODO: huh? can't remember) L = tool window but window won't appear in taskbar (TODO: ...) n = minimize box (TODO: what box?) s = make the window sizable t = add only the "x" button to the upper right corner x = maximize box (TODO: what box?)
Note: some switches may automatically turn other switches on/off.
The rest of the command options:
@name = window name (must prefix with a @ even if the @ would be left out from its title) x,y,w,h = position in x-axis, position in y-axis, width, height popup.txt = popup filename to be used for the window, loaded when needed (must be a plain non-ini text file) /command = default command (executed whenever you enter text in an editbox) (TODO: in any editbox or?) font/size = font name and size to be used in the window (defaults to status window font) iconfile/N = sets the titlebar icon for the window
Note: if you use -1 for any of the x,y,w,h values, the default value is used unless the window already exists in which case the current value is used.
