register
Description:
Warning: register is deprecated.
Registers the role specified by name
.
Note:
Since 2.12.
If your application/toolkit doesn't find a suitable role for a specific object defined at Role , please submit a bug in order to add a new role to the specification.
name
must be a meaningful name. So it should not be empty, or consisting on whitespaces.
Parameters:
name |
a character string describing the new role. |
Returns:
an Role for the new role if added properly. ATK_ROLE_INVALID in case of error. |