WoW:API GetAutoCompleteResults: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(Create page)
 
m (Move page script moved page API GetAutoCompleteResults to API GetAutoCompleteResults without leaving a redirect)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{wowapi}}
{{wowapi}}
Returns possible player names matching a given prefix string and specified requirements.
nick1, nick2, ... = GetAutoCompleteResults("text", include, exclude, maxResults[, cursorPosition]);


Gets the results of the built-in autocomplete, based on the text currently entered into an editbox.
== Arguments ==
GetAutoCompleteResults("text",
;text: String - first characters of the possible names to be autocompleted
                        parent.autoCompleteParams.include,
;include: Number - bit mask of [[#Filter values|filters]] that the results '''must''' match at least one of.
                        parent.autoCompleteParams.exclude,
;exclude: Number - bit mask of [[#Filter values|filters]] that the results '''must not''' match any of.
                        AUTOCOMPLETE_MAX_BUTTONS+1,
;maxResults: Number - number of results desired.
                        cursorPosition);
;cursorPosition: Number - position of the cursor within the editbox (i.e. how much of the text string should be matching).


== Parameters ==
=== Filter values ===
The two bit mask parameters can be composed from the following components:
{| class="darktable" style="margin-left: 3em"
! Global constant name !! Value !! Matches
|-
| AUTOCOMPLETE_FLAG_NONE || 0x00000000 || No one
|-
| AUTOCOMPLETE_FLAG_IN_GROUP || 0x00000001 || ?
|-
| AUTOCOMPLETE_FLAG_IN_GUILD || 0x00000002 || ?
|-
| AUTOCOMPLETE_FLAG_FRIEND || 0x00000004 || Players on your friends list
|-
| AUTOCOMPLETE_FLAG_INTERACTED_WITH || 0x00000010 || ?
|-
| AUTOCOMPLETE_FLAG_ONLINE || 0x00000020 || Currently online players
|-
| AUTOCOMPLETE_FLAG_ALL || 0xffffffff || Anyone
|}


<big>'''Arguments'''</big>
== Returns ==
:("text", parent.autoCompleteParams.include, parent.autoCompleteParams.exclude, AUTOCOMPLETE_MAX_BUTTONS+1, cursorPosition)
; nick1, nick2, ... : String - auto-completed name of a player that satisfies the requirements.
 
:;text: String - first characters of the possible names to be autocompleted
:;parent.autoCompleteParams.include: Numeric - arbitrary value assigned by Blizzard based on the type of editbox, as to what type of names to include
:;parent.autoCompleteParams.exclude: Numeric - arbitrary value assigned by Blizzard based on the type of editbox, as to what type of names to exclude
:;AUTOCOMPLETE_MAX_BUTTONS: - Numeric - arbitrary value assigned by Blizzard to determine how many buttons to include in the AutoComplete dropdown. Add 1 to allow for a disabled button that indicates there are more names than can be shown by the default AutoComplete dropdown.
:;cursorPosition: - Numeric - position of the cursor within the editbox. Can usually be obtained by [[API EditBox GetCursorPosition|EditBox:GetCursorPosition]]()


== Example ==
== Example ==

Latest revision as of 04:45, 15 August 2023

← WoW API < GetAutoCompleteResults

Returns possible player names matching a given prefix string and specified requirements. 

nick1, nick2, ... = GetAutoCompleteResults("text", include, exclude, maxResults[, cursorPosition]);

Arguments[edit]

text
String - first characters of the possible names to be autocompleted
include
Number - bit mask of filters that the results must match at least one of.
exclude
Number - bit mask of filters that the results must not match any of.
maxResults
Number - number of results desired.
cursorPosition
Number - position of the cursor within the editbox (i.e. how much of the text string should be matching).

Filter values[edit]

The two bit mask parameters can be composed from the following components:

Global constant name Value Matches
AUTOCOMPLETE_FLAG_NONE 0x00000000 No one
AUTOCOMPLETE_FLAG_IN_GROUP 0x00000001 ?
AUTOCOMPLETE_FLAG_IN_GUILD 0x00000002 ?
AUTOCOMPLETE_FLAG_FRIEND 0x00000004 Players on your friends list
AUTOCOMPLETE_FLAG_INTERACTED_WITH 0x00000010 ?
AUTOCOMPLETE_FLAG_ONLINE 0x00000020 Currently online players
AUTOCOMPLETE_FLAG_ALL 0xffffffff Anyone

Returns[edit]

nick1, nick2, ...
String - auto-completed name of a player that satisfies the requirements.

Example[edit]

Assuming you are sending a mail to someone whose name starts with "a", and that the Send Mail window is open 

GetAutoCompleteResults("a",
                       SendMailNameEditBox.autoCompleteParams.include,
                       SendMailNameEditBox.autoCompleteParams.exclude,
                       AUTOCOMPLETE_MAX_BUTTONS+1,
                       SendMailNameEditBox:GetCursorPosition())
Retrieved from "https://addonstudio.org/mw/index.php?title=WoW:API_GetAutoCompleteResults&oldid=18912"