Aw toolbar click

From ActiveWiki
Jump to: navigation, search


Minimum requirements
Added in version 3.5
SDKbuild 37
Worldbuild 63


int aw_toolbar_click (void)

Description

Simulates clicking on a toolbar button.

Callback

None (returns immediately)

Notes

This method triggers AW_EVENT_TOOLBAR_CLICK in all the neighbor SDK applications that have subscribed to the event. It is intended for use by the Active Worlds Browser to indicate when a user clicks on an "sdk event" toolbar button. However it is also available for use by SDK applications which may wish to simulate toolbar button actions for the purposes of testing.

Arguments

None

Argument attributes

AW_TOOLBAR_ID
Id of toolbar button that was clicked.

Return values

RC_SUCCESS
RC_NOT_INITIALIZED
RC_NO_INSTANCE
RC_NO_CONNECTION
The connection to the world is down.

Returned attributes

None

Usage

Simulate toolbar #10 click.

void handle_toolbar_click (void)
{
  printf ("Session #%d clicked toolbar #%d\n",
          aw_int (AW_TOOLBAR_SESSION),
          aw_int (AW_TOOLBAR_ID));
}

aw_event_set (AW_EVENT_TOOLBAR_CLICK, handle_toolbar_click);
aw_int_set (AW_TOOLBAR_ID, 10);
aw_toolbar_click ();

See also