Difference between revisions of "Custom Windows"

From Scriptwiki
Jump to: navigation, search
(Start for custom windows page)
 
m (added -t + some minor fixes)
Line 7: Line 7:
 
Explanations of the different switches:
 
Explanations of the different switches:
  
  a = activate the window
+
  a   = activate the window
  b = update horizontal scrollbar width for listbox (TODO: better explanation?)
+
  b   = update horizontal scrollbar width for listbox (TODO: better explanation?)
  B = prevent the window from using an internal border
+
  B   = prevent the window from using an internal border
  c = close the window
+
  c   = close the window
  C = center window when first created
+
  C   = center window when first created
  d = open the window as a desktop window
+
  d   = open the window as a desktop window
  D = allows toggling of the window between mdi and desktop (TODO: what's this?)
+
  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 single-line editbox to the window
  E = add a multi-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?)
+
  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?
+
  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   = 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?)
+
  H   = enables auto-hide for a side-listbox (TODO: huh?)
  i = dynamically associate with whatever happens to be the active connection (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.
+
  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.
+
  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.
+
  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?)
+
  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
+
  o   = if opened on desktop, place ontop of all other desktop windows
  p = creates a [[Picture_Windows|picture window]]
+
  p   = creates a [[Picture_Windows|picture window]]
  r = restore window (TODO: huh?)
+
  r   = restore window (TODO: huh?)
  R = reset window's size and position to previously saved values
+
  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 main window, whether text or listbox (TODO: alphabetically or what?)
  S = sort the side-listbox (TODO: ...)
+
  S   = sort the side-listbox (TODO: ...)
  u = if the window was created with -o, remove ontop setting of the window
+
  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?)
+
  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?)
+
  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
+
  x   = maximize window
  z = place window button at the end of the switchbar
+
  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
(TODO: Someone explain -t)
 
  
 
The switches that start with + are used to change the appearance of the window:
 
The switches that start with + are used to change the appearance of the window:

Revision as of 23:51, 23 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.