Recent changes to cActionSuggestCompletion

cActionSuggestCompletion modified by Alexey T.

Alexey T. — Sun, 12 May 2013 19:43:14 -0000

--- v3
+++ v4
@@ -1,15 +1,15 @@
-This action can be called by plugin to suggest user some completion strings for current text. This may be needed by some abbreviation expansion plugins, similar to Zen Coding (which is built-in).
+This action can be called by plugin to suggest user list of auto-completion strings. This may be needed by some abbreviation expansion plugins, similar to Zen Coding.
+
+Suggestions list is Chr(13)-separated list of strings, each string is simply id or "|"-separated list: "id|type|(parameters)".

 Parameters:

-- **A1** (PWideChar) - list of strings, separated by Chr(13), to suggest.
+- **A1** (PWideChar) - suggestions list.
 - **A2** (Integer) - length of text, which will be replaced by suggested text. 
 - **A3** (Bool) - allows to show completion popup window with suggested strings. If False, instant replace will be performed without popup shown, with the first passed string.
-- **A4** - not  used.
+- **A4** - not used.

 Return value: `cSynError` if some parameters are not valid (e.g. strings list is empty), or `cSynOK` otherwise.

-Notes:
-
 Example for A2 parameter: if caret is in position 1:4 after word "wwww", and length parameter is 3, then last 3 "w" chars will be replaced with suggested string (which is chosen by user from popup window if it's enabled).

WikiPage cActionSuggestCompletion modified by Alexey T.

Alexey T. — Fri, 30 Nov 2012 21:56:01 -0000

--- v2
+++ v3
@@ -4,10 +4,10 @@
 
 - **A1** (PWideChar) - list of strings, separated by Chr(13), to suggest.
 - **A2** (Integer) - length of text, which will be replaced by suggested text. 
-- **A3** (Bool) - allows to show completion popup window with suggested strings. If False, instant replace will be performed without popup shown.
+- **A3** (Bool) - allows to show completion popup window with suggested strings. If False, instant replace will be performed without popup shown, with the first passed string.
 - **A4** - not  used.
 
-Return value: `cSynError` if some parameters are not  valid, `cSynOK` otherwise.
+Return value: `cSynError` if some parameters are not valid (e.g. strings list is empty), or `cSynOK` otherwise.
 
 Notes:

WikiPage cActionSuggestCompletion modified by Alexey T.

Alexey T. — Fri, 30 Nov 2012 21:51:20 -0000

--- v1
+++ v2
@@ -3,9 +3,13 @@
 Parameters:
 
 - **A1** (PWideChar) - list of strings, separated by Chr(13), to suggest.
-- **A2** (Integer) - length of text, which will be replaced by suggested text.
-- **A3** (Bool) - allows to show completion popup window: if False, instant replace will be pefformed without popup shown.
+- **A2** (Integer) - length of text, which will be replaced by suggested text. 
+- **A3** (Bool) - allows to show completion popup window with suggested strings. If False, instant replace will be performed without popup shown.
 - **A4** - not  used.
 
 Return value: `cSynError` if some parameters are not  valid, `cSynOK` otherwise.
 
+Notes:
+
+Example for A2 parameter: if caret is in position 1:4 after word "wwww", and length parameter is 3, then last 3 "w" chars will be replaced with suggested string (which is chosen by user from popup window if it's enabled).
+

WikiPage cActionSuggestCompletion modified by Alexey T.

Alexey T. — Fri, 30 Nov 2012 21:42:55 -0000

This action can be called by plugin to suggest user some completion strings for current text. This may be needed by some abbreviation expansion plugins, similar to Zen Coding (which is built-in). Parameters: - **A1** (PWideChar) - list of strings, separated by Chr(13), to suggest. - **A2** (Integer) - length of text, which will be replaced by suggested text. - **A3** (Bool) - allows to show completion popup window: if False, instant replace will be pefformed without popup shown. - **A4** - not used. Return value: `cSynError` if some parameters are not valid, `cSynOK` otherwise.