Project

General

Profile

Dialog Items » History » Revision 39

Revision 38 (Per Amundsen, 01/01/2019 02:37 AM) → Revision 39/40 (Per Amundsen, 12/14/2019 09:49 AM)

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* TODO 
 left - *TODO* TODO 
 bottom - *TODO* TODO 
 right - *TODO* TODO 
 center - *TODO* 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)* (AdiIRC only) 
 aright - Anchors the picturebox to the right. *(AdiIRC only)* (AdiIRC only) 
 atop - Anchors the picturebox to the top. *(AdiIRC only)* (AdiIRC only) 
 abottom - Anchors the picturebox to the bottom. *(AdiIRC only)* (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)* (AdiIRC only) 
 aright - Anchors the combobox to the right. *(AdiIRC only)* (AdiIRC only) 
 atop - Anchors the combobox to the top. *(AdiIRC only)* (AdiIRC only) 
 abottom - Anchors the combobox to the bottom. *(AdiIRC only)* (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)* (AdiIRC only) 
 aright - Anchors the text to the right. *(AdiIRC only)* (AdiIRC only) 
 atop - Anchors the text to the top. *(AdiIRC only)* (AdiIRC only) 
 abottom - Anchors the text to the bottom. *(AdiIRC only)* (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)* (AdiIRC only) 
 aright - Anchors the link to the right. *(AdiIRC only)* (AdiIRC only) 
 atop - Anchors the link to the top. *(AdiIRC only)* (AdiIRC only) 
 abottom - Anchors the link to the bottom. *(AdiIRC only)* (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)* (AdiIRC only) 
 aright - Anchors the button to the right. *(AdiIRC only)* (AdiIRC only) 
 atop - Anchors the button to the top. *(AdiIRC only)* (AdiIRC only) 
 abottom - Anchors the button to the bottom. *(AdiIRC only)* (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* 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)* (AdiIRC only) 
 aright - Anchors the checkbox to the right. *(AdiIRC only)* (AdiIRC only) 
 atop - Anchors the checkbox to the top. *(AdiIRC only)* (AdiIRC only) 
 abottom - Anchors the checkbox to the bottom. *(AdiIRC only)* (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)* (AdiIRC only) 
 aright - Anchors the textbox to the right. *(AdiIRC only)* (AdiIRC only) 
 atop - Anchors the textbox to the top. *(AdiIRC only)* (AdiIRC only) 
 abottom - Anchors the textbox to the bottom. *(AdiIRC only)* (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, multse, 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* 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)* (AdiIRC only) 
 aright - Anchors the listbox to the right. *(AdiIRC only)* (AdiIRC only) 
 atop - Anchors the listbox to the top. *(AdiIRC only)* (AdiIRC only) 
 abottom - Anchors the listbox to the bottom. *(AdiIRC only)* (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* 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)* (AdiIRC only) 
 aright - Anchors the radio button to the right. *(AdiIRC only)* (AdiIRC only) 
 atop - Anchors the radio button to the top. *(AdiIRC only)* (AdiIRC only) 
 abottom - Anchors the radio button to the bottom. *(AdiIRC only)* (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)* (AdiIRC only) 
 aright - Anchors the group box to the right. *(AdiIRC only)* (AdiIRC only) 
 atop - Anchors the group box to the top. *(AdiIRC only)* (AdiIRC only) 
 abottom - Anchors the group box to the bottom. *(AdiIRC only)* (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* todo 
 left - *TODO* TODO 
 bottom - *TODO* TODO 
 right - *TODO* 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)* (AdiIRC only) 
 aright - Anchors the scrollbar to the right. *(AdiIRC only)* (AdiIRC only) 
 atop - Anchors the scrollbar to the top. *(AdiIRC only)* (AdiIRC only) 
 abottom - Anchors the scrollbar to the bottom. *(AdiIRC only)* (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.