---
name: "BIS_fnc_GUIhint"
type: function
status: ok
groups: ["GUI"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_GUIhint
revid: 364353
updated: 2024-05-06T10:37:04Z
---

# BIS_fnc_GUIhint

*Function · GUI · Arma 3 v0.50 · introduced in Take On Helicopters v1.00*

## Description

Creates advanced hintC dialog

## Syntax

*syntax inferred from the function header*

```sqf
[param0] call BIS_fnc_GUIhint
```

**Parameters:**

- `param0` — 0: ARRAY in format
      [text,picture]
           text: STRING - hint text
           picture: STRING - picture
      [item1,item2...] - Listbox item ARRAYs in format
          [itemText,itemDescription,picture,icon]
               itemText: STRING - Text displayed in listbox
               itemDescription (Optional): STRING - text displayed after clicking on item
               picture (Optional): STRING - picture displayed after clicking on item
               icon (Optional): STRING - icon displayed in listbox left from text
  _this select 1 (Optional): STRING - hint header
  _this select 2 (Optional): ARRAY - [STRING,CODE,NUMBER] - text on left button (when "", button is hidden), code executed upon clicking and fade out delay. If only text is present, button is disabled.
  _this select 3 (Optional): ARRAY - [STRING,CODE,NUMBER] - STRING - text on right button and code executed upon clicking
  _this select 4 (Optional): ARRAY - [STRING,CODE,NUMBER] - STRING - text on middle button and code executed upon clicking
  _this select 5 (Optional): NUMBER or ARRAY - width or [width,height] of picture (in grid coordinates). Width > 17 means only picture is used.

**Returns:** ARRAY - [endState(,lbId)]
     endState: NUMBER - 1 when clicked on right button, -1 when clicked on left button, 0 when escaped
     lbId: NUMBER - selected listbox item (when listbox was used)

## Function header

The comment at the top of the function's file in the game; this page's description, params, syntax, returns come from it.

```sqf
/*
Description:
Creates advanced hintC dialog

Parameter(s):
_this select 0: ARRAY in format
    [text,picture]
         text: STRING - hint text
         picture: STRING - picture
    [item1,item2...] - Listbox item ARRAYs in format
        [itemText,itemDescription,picture,icon]
             itemText: STRING - Text displayed in listbox
             itemDescription (Optional): STRING - text displayed after clicking on item
             picture (Optional): STRING - picture displayed after clicking on item
             icon (Optional): STRING - icon displayed in listbox left from text
_this select 1 (Optional): STRING - hint header
_this select 2 (Optional): ARRAY - [STRING,CODE,NUMBER] - text on left button (when "", button is hidden), code executed upon clicking and fade out delay. If only text is present, button is disabled.
_this select 3 (Optional): ARRAY - [STRING,CODE,NUMBER] - STRING - text on right button and code executed upon clicking
_this select 4 (Optional): ARRAY - [STRING,CODE,NUMBER] - STRING - text on middle button and code executed upon clicking
_this select 5 (Optional): NUMBER or ARRAY - width or [width,height] of picture (in grid coordinates). Width > 17 means only picture is used.

Returns:
ARRAY - [endState(,lbId)]
     endState: NUMBER - 1 when clicked on right button, -1 when clicked on left button, 0 when escaped
     lbId: NUMBER - selected listbox item (when listbox was used)
*/
```

## See also

BIS_fnc_GUImessage

<sub>Source: [BI Community Wiki — BIS fnc GUIhint](https://community.bistudio.com/wiki/BIS_fnc_GUIhint) (revision 364353).</sub>