From 182a9f46dd1a3344c9dd480ec2e220183b4bb959 Mon Sep 17 00:00:00 2001 From: Alexey-t Date: Fri, 3 Feb 2017 17:30:50 +0300 Subject: [PATCH] wiki --- app/readme/wiki/cudatext_api.wiki | 95 ++++++++++++++++++++----------- 1 file changed, 62 insertions(+), 33 deletions(-) diff --git a/app/readme/wiki/cudatext_api.wiki b/app/readme/wiki/cudatext_api.wiki index 6b2afb597f7..7bbc2a033ac 100644 --- a/app/readme/wiki/cudatext_api.wiki +++ b/app/readme/wiki/cudatext_api.wiki @@ -429,7 +429,9 @@ Param process_messages: if True, function also does UI messages processing. It t msg_status_alt(text, seconds) -Shows given text in alternative statusbar, just above normal statusbar. Status has entire window width. Status shows only for some seconds (1..30). +Shows given text in alternative statusbar; it has yellowish color and shows on the bottom of current editor. + +Time in seconds: 1..30; seconds<=0 hides statusbar (if shown before). ===dlg_input=== @@ -521,28 +523,37 @@ Param lexer is optional lexer name. If not empty, dialog enables checkbox "For c Shows dialog with controls of many types. -Parameter text is "\n"-separated items, one item per control. Each item is chr(1)-separated props. Each prop is s_name+"="+s_value. Possible names (and names' values): - -* "type": type of control, values: -** "label" -** "check" (checkbox, checked/unchecked/grayed) -** "radio" (radio checkbox, only one of these can be checked) -** "edit" (one-line edit) -** "combo" (combobox editable, value is text) -** "combo_ro" (combobox read-only, value is index) -** "listbox" -** "button" -** "checkbutton" (looks like button, but don't close dialog, checked/unchecked) -** "memo" (multi-line edit) -** "checkgroup" (group of checkboxes) -** "radiogroup" (group of radiobuttons) -** "checklistbox" (listbox with checkboxes) -** "spinedit" (edit for numbers, has min-value, max-value, increment) -** "listview" (list with columns, with column headers, value is index) -** "checklistview" (listview with checkboxes, value is check-flags) -** "linklabel" (label which activates URL on click) -** "tabs" (set of tabs headers, note: not pages which have controls) -** "colorpanel" (panel with caption, color of background, color of font) +==== Possible types ==== + +Control types allowed: + +* "label": simple text shown in rectangle +* "check": checkbox, checked/unchecked/grayed +* "radio": radio checkbox, only one of these can be checked +* "edit": single-line input +* "edit_pwd": single-line input for password, text is masked +* "combo": combobox, editable, value is text +* "combo_ro": combobox, read-only, value is index +* "listbox": list of items with one item selected +* "button" +* "checkbutton": looks like button, but don't close dialog, checked/unchecked +* "memo": multi-line input +* "checkgroup": group of check-boxes +* "radiogroup": group of radio-buttons +* "checklistbox": listbox with checkboxes +* "spinedit": input for numbers, has min-value, max-value, increment +* "listview": list with columns, with column headers, value is index +* "checklistview": listview with checkboxes, value is check-flags +* "linklabel": label which activates URL on click +* "tabs": set of tabs headers (note: not pages which have controls in them) +* "colorpanel": panel with caption, color of background, color of font +* "image": picture, which shows picture-file + +==== Properties ==== + +Parameter text is "\n"-separated items, one item per control. Each item is chr(1)-separated props. Each prop is s_name+"="+s_value. Possible names and their values: + +* "type": type of control, values are listed above. * "pos": position, ","-separated values: left, top, right, bottom (e.g. "10,10,200,30"); some one-line controls ignore bottom-value and do autosize * "cap": caption of control (not for all) @@ -556,20 +567,28 @@ Parameter text is "\n"-separated items, one item per control. Each item is chr(1 *** first item is column headers: title1+"="+size1 + "\r" + title2+"="+size2 + "\r" +... *** size1...sizeN can be with lead char to specify alignment of column: L (default), R, C *** other items are data: cell1+"\r"+cell2+"\r"+... (count of cells may be less than count of columns) +** for image: full path of picture file (png/gif/jpg/bmp) * "props": control-specific properties: -** for button: default_for_enter (bool value, "1"/"0") -** for edit, memo: read_only+","+font_monospaced+","+show_border (bool value) -** for spinedit: str(min_value)+","+str(max_value)+","+str(increment) -** for linklabel: URL (with http: or mailto:) -** for listview: show_grid (bool value) -** for tabs: tabs_at_bottom (bool value) -** for colorpanel: str(border_width_from_0)+","+str(int_color_fill)+","+str(int_color_font)+","+str(int_color_border) +** for button: bool_default_for_enter (bool value "0"/"1") +** for edit, memo: bool_read_only+","+bool_font_monospaced+","+bool_show_border +** for spinedit: int_min_value+","+int_max_value+","+int_increment +** for linklabel: URL ("http:" or "mailto:", other kinds possible too, but may not run) +** for listview: bool_show_grid +** for tabs: bool_tabs_at_bottom +** for colorpanel: int_border_width_from_0+","+int_color_fill+","+int_color_font+","+int_color_border +** for image: bool values ","-separated: +*** bool_center +*** bool_stretch +*** bool_stretch_in_enabled +*** bool_stretch_out_enabled +*** bool_keep_origin_x_when_clipped +*** bool_keep_origin_y_when_clipped * "val": value of control (not for all): ** for check: value "0"/"1" or "?" (grayed) ** for radio, checkbutton: value "0"/"1" -** for edit, combo, spinedit: text +** for edit, edit_pwd, spinedit, combo: text ** for memo: "\t"-separated lines (in lines "\t" must be replaced to chr(2)) ** for combo_ro, listbox, radiogroup, listview: index ** for checkgroup: ","-separated checks (values "0"/"1") @@ -1254,9 +1273,9 @@ Possible values of id: * GAP_ADD: Adds gap to editor, with ready bitmap. Gets bool: params correct, gap added. Params: ** num1 - line index ** num2 - id_bitmap you got before -** tag - some int value to separate gaps from few plugins. (Internally it's signed 64-bit.) +** tag - int value (signed 64 bit) to separate gaps from several plugins. -* GAP_DELETE: Deletes gaps for lines: from num1 to num2. +* GAP_DELETE: Deletes gaps, for line indexes from num1 to num2. * GAP_DELETE_ALL: Deletes all gaps. Example plugin: @@ -1318,9 +1337,19 @@ Text is chr(1) separated items: ** 'f' for from-caret ** 'o' for confirm-replaces ** 'a' for wrapped-search +** 's' for search in selection =History= +1.0.166 +* chg: dlg_custom: "image" uses "items=" now + +1.0.165 +* add: find/replace in selection, flag in cmd_FinderAction +* add: msg_status_alt: allowed seconds<=0 +* add: dlg_custom: type "edit_pwd" (password input) +* add: dlg_custom: type "image" + 1.0.164 * change: ed.gap: tag is 64-bit signed (was 32-bit)