Main Page | Namespace List | Class Hierarchy | Data Structures | Directories | File List | Namespace Members | Data Fields | Globals

Accessibility::Selector Interface Reference

import "Accessibility_Selector.idl";


Public Types

enum  CommandResult {
  COMMAND_RESULT_INVALID, COMMAND_RESULT_SUCCESS, COMMAND_RESULT_FAILED, COMMAND_RESULT_OBSOLETE,
  COMMAND_RESULT_LAST_DEFINED
}

Public Member Functions

CommandList getCommands ()
boolean replaceCommands (in CommandList commands)
boolean refreshCommands ()
CommandResult activateCommand (in Command command)
void registerChangeListener (in CommandListener listener)
void deregisterChangeListener (in CommandListener listener)

Data Fields

readonly attribute boolean supportsReplace


Detailed Description

This interface is intended for use by assistive technologies and related user-agents. Via this interface, an assistive technology or user agent may expose a series of choices or selections in textual form, which can be activated on demand by a client of the Selector interface.

Examples of the use of this interface include voice-command and remote-control applications, in which the user interaction is wholly or partly delegated by the implementor to an external agent.

Since:
AT-SPI 1.7.0


Member Enumeration Documentation

enum Accessibility::Selector::CommandResult
 

A code returned by a call to activateCommand, indicating the result of the activation request.

Enumerator:
COMMAND_RESULT_INVALID  The command was invalid or ill-formed; usually indicates an error condition.
COMMAND_RESULT_SUCCESS  The command was successfully activated.
COMMAND_RESULT_FAILED  The command was valid, but could not be activated. This may be due to problems with permissions or error conditions.
COMMAND_RESULT_OBSOLETE  The command is no longer valid in the current program context. This may mean that the application has changed state in such a way that the specified command it no longer applicable, or because changes to the application state have rendered it ambiguous. Commands should be re-fetched and a new selection made.
COMMAND_RESULT_LAST_DEFINED  Defines size of enumeration; do not use this value as a parameter.


Member Function Documentation

CommandResult Accessibility::Selector::activateCommand in Command  command  ) 
 

Request that the Selector invoke the specified Command.

Parameters:
command the Command to activate/invoke.
Returns:
a CommandResult indicating whether the request was honored, and the reason for failure if the Command could not be activated or invoked.

void Accessibility::Selector::deregisterChangeListener in CommandListener  listener  ) 
 

Tell the Selector instance to cease notifying the specified CommandListener of changes to the command list.

Parameters:
listener the CommandListener to remove from the notification list.

CommandList Accessibility::Selector::getCommands  ) 
 

Query the Selector for the current CommandList.

Returns:
the currently available CommandList

boolean Accessibility::Selector::refreshCommands  ) 
 

Ask the Selector to re-calculate its CommandList.

Note:
in most cases the Selector will continuously update its CommandList without recourse to this call. This call is equivalent to getCommands, except that after refreshCommands the new CommandList will be returned via any registered CommandListener instances rather than synchronously via this call.
Returns:
TRUE if the CommandList changed.

void Accessibility::Selector::registerChangeListener in CommandListener  listener  ) 
 

Register a :CommandListener instance for notification of changes to the command set.

Parameters:
listener the CommandListener to be notified of changes.

boolean Accessibility::Selector::replaceCommands in CommandList  commands  ) 
 

Returns:
TRUE if the replacement request was successful, FALSE if the request could not be honored.


Field Documentation

readonly attribute boolean Accessibility::Selector::supportsReplace
 

This attribute is TRUE if this Selector allows its CommandList to be specified by the client


The documentation for this interface was generated from the following file:
Generated on Tue Jul 18 16:56:16 2006 for at-spi-idl by  doxygen 1.4.3