Difference between revisions of "Custom Windows"

From Scriptwiki
Jump to: navigation, search
(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.