h1. Dialog Items

_See also [[/dialog]], [[$dialog]], [[on DIALOG]]._

*title <text>*

Sets the titlebar text of the dialog.

---

*size <x y w h>*

Sets the x/y position and the width/height of the dialog.

---

*option <pixels | dbu | notheme | disable>*

pixels - The dialog and All dialog items sizes are defined in pixels.
dbu - The dialog and All dialog items sizes are defined in Dialog Base Units.
notheme - Sets the dialog border style to fixed single and disables windows theme styling.
disable - Disables all controls for a second when the dialog is shown.

---

*icon <filename, [index]>*

Adds a icon to the dialog.

_The filename must have a valid image and be the first parameter, if there are additional parameters after the filename, there must be a comma first._

filename - Icon file, can be any type of picture or icon file, also a .exe or .dll.
[index] - Icon index in the .ico/.exe/.dll file to use.

---

*icon <id, x y w h, filename, [index], [noborder, top, left, bottom, right, small, large, actual, disable, hide, tab id, aleft, aright, atop, abottom, %variable]>*

Adds a picturebox to the dialog.

_The filename must have a valid image and be the first parameter, if there are additional parameters after the filename, there must be a comma first._

id - Id of the picturebox.
x y w h - The x y position, width and height to use for the picturebox.
filename - Icon file, can be any type of picture or icon file, also a .exe or .dll.
[index] - Icon index in the .ico/.exe/.dll file to use.
noborder - Removes the border added to regular images.
top - *TODO*
left - *TODO*
bottom - *TODO*
right - *TODO*
center - *TODO*
small - Use small icon.
large - Use large icon.
actual - Use the actual icon.
disable - Disables the picturebox.
hide - Hides the picturebox.
tabid/tab id - Indicates the picturebox should be shown on the tab with the specified id.
aleft - Anchors the picturebox to the left. *(AdiIRC only)*
aright - Anchors the picturebox to the right. *(AdiIRC only)*
atop - Anchors the picturebox to the top. *(AdiIRC only)*
abottom - Anchors the picturebox to the bottom. *(AdiIRC only)*
%variable - Fills the variable with the picturebox filename when the dialog closes.

---

*tab <text, id, x y w h>, [%variable]*

Adds a tabcontrol to the dialog.

text - The text of the tab.
id - Id of the tabcontrol.
x y w h - The x y position, width and height to use for the tabcontrol.
%variable - Fills the variable with the tab text when the dialog closes.

---

*tab <text, id, [%variable]*

Adds a new tab to the tabcontrol with the specified id.

%variable - Fills the variable with the tab text when the dialog closes.

---

*combo <id, x y w h, [sort, edit, drop, size, vsbar, hsbar, result, disable, tab id, aleft, aright, atop, abottom, %variable]>*

Adds a combobox to the dialog with the specified id at position x/y and the w/h width/height.

id - Id of the combobox.
x y w h - The x y position, width and height to use for the combobox.
sort - Enables sorting.
edit - Shows the editbox.
drop - Show as a dropdown list.
size - Sets the height of the dropdown area.
vsbar - Enables the vertical scrollbar.
hsbar - Enables the horizontal scrollbar.
result -Indicates the selected dropdown item/text should be returned when the dialog "OK/Accept button" is pressed.
disable - Disables the combobox.
tabid/tab id - Indicates the combobox should be shown on the tab with the specified id.
aleft - Anchors the combobox to the left. *(AdiIRC only)*
aright - Anchors the combobox to the right. *(AdiIRC only)*
atop - Anchors the combobox to the top. *(AdiIRC only)*
abottom - Anchors the combobox to the bottom. *(AdiIRC only)*
%variable - Fills the variable with the edit or dropdown text when the dialog closes.

---

*text <text, id, x y w h, [right, center, nowrap, result, disable, hide, tab id, aleft, aright, atop, abottom, %variable]>*

Adds a text label to the dialog.

text - The text to add.
id - Id of the text.
x y w h - The x y position, width and height to use for the text.
right - Aligns the text to the right.
center - Centers the text.
nowrap - Prevents the text from wrapping. Any text that does not fit will be cut off. 
result - Indicates the text should be returned when the dialog "OK/Accept button" is pressed.
disable - Disables the text.
hide - Hides the text.
tabid/tab id - Indicates the text should be shown on the tab with the specified id.
aleft - Anchors the text to the left. *(AdiIRC only)*
aright - Anchors the text to the right. *(AdiIRC only)*
atop - Anchors the text to the top. *(AdiIRC only)*
abottom - Anchors the text to the bottom. *(AdiIRC only)*
%variable - Fills the variable with the text when the dialog closes.

---

*link <text, id, x y w h, [right, center, result, disable, hide, tab id, aleft, aright, atop, abottom, %variable]>*

Adds a link label to the dialog.

text - Text of the link.
id - Id of the link.
x y w h - The x y position, width and height to use for the link.
right - Aligns the link to the right.
center - Centers the link.
result - Indicates the link text should be returned when the dialog "OK/Accept button" is pressed.
disable - Disables the link.
hide - Hides the link.
tabid/tab id - Indicates the link should be shown on the tab with the specified id.
aleft - Anchors the link to the left. *(AdiIRC only)*
aright - Anchors the link to the right. *(AdiIRC only)*
atop - Anchors the link to the top. *(AdiIRC only)*
abottom - Anchors the link to the bottom. *(AdiIRC only)*
%variable - Fills the variable with the link text when the dialog closes.

---

*button <text, id, x y w h, [default, ok, cancel, flat, multi, result, disable, hide, tab id, aleft, aright, atop, abottom, %variable]>*

Adds a button to the dialog.

text - Text of the button.
id - Id of the button.
x y w h - The x y position, width and height to use for the button.
default - Sets the button as the default/accept button of the dialog.
ok - Sets the button as the "ok" button of the dialog.
cancel - Sets the button as the "cencel" button of the dialog.
flat - Shows the button as a flat button.
multi - Split long text into multiple lines.
result - Indicates the button text should be returned when the dialog "OK/Accept button" is pressed.
disable - Disables the button.
hide - Hides the button.
tabid/tab id - Indicates the button should be shown on the tab with the specified id.
aleft - Anchors the button to the left. *(AdiIRC only)*
aright - Anchors the button to the right. *(AdiIRC only)*
atop - Anchors the button to the top. *(AdiIRC only)*
abottom - Anchors the button to the bottom. *(AdiIRC only)*
%variable - Fills the variable with the button text when the dialog closes.

---

*check <text, id, x y w h, [left, push, 3state, flat, result, disable, hide, tab id, aleft, aright, atop, abottom, %variable]>*

Adds a checkbox to the dialog.

text - Text of the checkbox.
id - Id of the checkbox.
x y w h - The x y position, width and height to use for the checkbox.
left - *TODO*
push - Shows the checkbox as a button.
3state - Enables the intermediate state, gives the checkbox 3 states it can be in.
flat - Shows the checkbox as a flat checkbox.
result - Indicates the checkbox text should be returned when the dialog "OK/Accept button" is pressed.
disable - Disables the checkbox.
hide - Hides the checkbox.
tabid/tab id - Indicates the checkbox should be shown on the tab with the specified id.
aleft - Anchors the checkbox to the left. *(AdiIRC only)*
aright - Anchors the checkbox to the right. *(AdiIRC only)*
atop - Anchors the checkbox to the top. *(AdiIRC only)*
abottom - Anchors the checkbox to the bottom. *(AdiIRC only)*
%variable - Fills the variable with the checkbox text when the dialog closes.

---

*edit <text, id, x y w h, [right, center, multi, pass, read, return, hsbar, vsbar, autohs, autovs, limit N, rich, result, disable, hide, tab id, aleft, aright, atop, abottom, %variable]>*

Adds a textbox to the dialog.

text - Text of the textbox.
id - Id of the textbox.
x y w h - The x y position, width and height to use for the textbox.
right - Aligns the text in the textbox to the right.
center - Aligns the text in the textbox to the center.
multi - Enables multi lines.
pass - Indicates the text in the textbox is a password and should be masked.
read - Enables read only mode.
return - Allow return key to add new lines.
hsbar - Enables horizontal scrollbar.
vsbar - Enables vertical scrollbar.
autohs - Disables word wrap in a multi line textbox .
autovs - Automatically scroll to bottom when adding lines in multi line textbox .
limit N - Limits the textbox to N characters.
rich - Enables richtextbox instead of regular textbox.
result - Indicates the textbox text should be returned when the dialog "OK/Accept button" is pressed.
disable - Disables the textbox.
hide - Hides the textbox.
tabid/tab id - Indicates the textbox should be shown on the tab with the specified id.
aleft - Anchors the textbox to the left. *(AdiIRC only)*
aright - Anchors the textbox to the right. *(AdiIRC only)*
atop - Anchors the textbox to the top. *(AdiIRC only)*
abottom - Anchors the textbox to the bottom. *(AdiIRC only)*
%variable - Fills the variable with the first line in the textbox when the dialog closes.

---

*list <id, x y w h, [sort, extsel, multsel, size, vsbar, hsbar, check, radio, result, disable, hide, tab id, aleft, aright, atop, abottom]>*

Adds a listbox to the dialog.

id - Id of the listbox.
x y w h - The x y position, width and height to use for the listbox.
sort - Enables sorting.
extsel - Enabled extended selection mode.
multsel - Enabled multi selection mode.
size - Disable dynamically resizing to fit item heights.
vsbar - Shows the vertical scrollbar always.
hsbar - Shows the horizontal scrollbar always.
check - Shows checkboxes instead of text.
radio - *TODO*
result - Indicates the selected listbox text should be returned when the dialog "OK/Accept button" is pressed.
disable - Disables the listbox.
hide - Hides the listbox.
tabid/tab id - Indicates the listbox should be shown on the tab with the specified id.
aleft - Anchors the listbox to the left. *(AdiIRC only)*
aright - Anchors the listbox to the right. *(AdiIRC only)*
atop - Anchors the listbox to the top. *(AdiIRC only)*
abottom - Anchors the listbox to the bottom. *(AdiIRC only)*

---

*radio <text, id, x y w h, [left, push, flat, group, result, disable, hide, tab id, aleft, aright, atop, abottom, %variable]>*

Adds a radio button to the dialog.

text - Text of the radio button.
id - Id of the radio button.
x y w h - The x y position, width and height to use for the radio button.
left - *TODO*
push - Shows the radio button as an button.
flat - Shows the radio button as flat.
group - Creates a new radio group.
result - Indicates the radio button text should be returned when the dialog "OK/Accept button" is pressed.
disable - Disables the radio button.
hide - Hides the radio button.
tabid/tab id - Indicates the radio button should be shown on the tab with the specified id.
aleft - Anchors the radio button to the left. *(AdiIRC only)*
aright - Anchors the radio button to the right. *(AdiIRC only)*
atop - Anchors the radio button to the top. *(AdiIRC only)*
abottom - Anchors the radio button to the bottom. *(AdiIRC only)*
%variable - Fills the variable with the radio text when the dialog closes.

---

*box <text, id, x y w h, [result, disable, hide, tab id, aleft, aright, atop, abottom, %variable]>*

Adds a group box.

text - Text of the group box.
id - Id of the group box.
x y w h - The x y position, width and height to use for the group box.
result - Indicates the selected group box text should be returned when the dialog "OK/Accept button" is pressed.
disable - Disables the group box.
hide - Hides the group box.
tabid/tab id - Indicates the group box should be shown on the tab with the specified id.
aleft - Anchors the group box to the left. *(AdiIRC only)*
aright - Anchors the group box to the right. *(AdiIRC only)*
atop - Anchors the group box to the top. *(AdiIRC only)*
abottom - Anchors the group box to the bottom. *(AdiIRC only)*
%variable - Fills the variable with the box text when the dialog closes.

---

*scroll <text, id, x y w h, [top left bottom right horizontal range N N, disable, hide, tab id, aleft, aright, atop, abottom]>*

Adds a vertical scrollbar.

text - Text of the scrollbar?.
id - Id of the scrollbar.
x y w h - The x y position, width and height to use for the scrollbar.
top - *TODO*
left - *TODO*
bottom - *TODO*
right - *TODO*
horizontal - Sets the scrollbar as a horizontal scrollbar.
range N N - Sets the range of the scrollbar, from N to N.
disable - Disables the scrollbar.
hide - Hides the scrollbar.
tabid/tab id - Indicates the scrollbar should be shown on the tab with the specified id.
aleft - Anchors the scrollbar to the left. *(AdiIRC only)*
aright - Anchors the scrollbar to the right. *(AdiIRC only)*
atop - Anchors the scrollbar to the top. *(AdiIRC only)*
abottom - Anchors the scrollbar to the bottom. *(AdiIRC only)*

---

*menu <text, menuid [, menuid]>*

Adds a new menu collection to the Menubar, if the second menuid is specified, the menuitem is added to that menu collection instead.

text - Text of the menu.
menuid - id of the menu.
menuid - id of the parent menu.

---

*item <text|break, id, [menuid, cancel, ok]>*

Adds a new menu item to a menu.

text|break - Text of the menu item, or break to add a menu separator.
id - Id of the menu item.
menuid - Parent menu to add the menu item to, else it's added to previously used menu.
cancel - Indicates this menu should trigger the cancel button.
ok - Indicates this menu should trigger the accept/ok button.