AlCategory

Synopsis

#include <AlCategory.h>

class AlCategory : public AlObject

virtual	~AlCategory();

AlCategory();

virtual AlObject*	copyWrapper() const;

virtual statusCode	deleteObject();

virtual AlObjectType	type() const;

statusCode	create(const char * = NULL);

statusCode	addMember(int);

statusCode	removeMember(int);

int	numberOfMembers() const;

statusCode	members(int numMembers, int members[]);

const char *	name() const;

statusCode	setName( const char*);

const char *	description() const;

statusCode	setDescription( const char*);

statusCode	pick(int);

int	isPicked() const;

Description

Categories are a way of organizing lists of layers. This organization simplifies changing the attributes of associated layers. Each AlCategory has a non unique name, picked status, description and a list of associated layers. The layer list contains layer numbers.

Notes:

1) Attempting to add a layer to a category that is already in the list will fail.

2) Layers can belong to multiple categories.

3) All functions will fail if layers are not enabled.

4) AlCategory is available through OpenModel

AlCategory::AlCategory(void)

Description

Constructs an AlCategory wrapper object.

AlCategory::~AlCategory()

Description

Deletes an AlCategory wrapper object.

statusCode AlCategory::deleteObject()

Description

Deletes the category.

Return Codes

sSuccess - the object was deleted

sFailure - layers functionality turned off or internal failure

sInvalidObject - the object was invalid

AlObject* AlCategory::copyWrapper() const

Description

Returns an exact copy of the AlCategory wrapper.

AlObjectType AlCategory::type() const

Description

Returns the class identifier kCategoryType.

statusCode AlCategory::create( const char* name )

Description

Create a new category.

Arguments

< name - the name of the new category, default parameter name is NULL if not specified

Return Codes

sSuccess - the category was created

sFailure - the category was not created because the layer functionality is turned off.

sAlreadyCreated - object has already been created

const char * AlCategory::name() const

Description

Returns the name of the object.

statusCode AlCategory::setName( const char *newName )

Description

Sets the name of the category

Arguments

< newName - new name of category

Return Codes

sSuccess - the name was set

sFailure - the name length exceed 255 characters or layers functionality is disabled.

sInvalidArgument - newName was NULL

sInvalidObject - the object is not valid

const char * AlCategory::description() const

Description

Returns the description of the object.

statusCode AlCategory::setDescription( const char *newDesc )

Description

Sets the description of the category

Arguments

< newDesc - new description of the category

Return Codes

sSuccess - the description was set

sFailure - the description length exceed 255 characters or layers functionality is disabled.

sInvalidArgument - newDesc was NULL

sInvalidObject - the object is not valid

statusCode AlCategory::addMember(int layerID)

Description

Adds a layer to the current category.

Arguments

< layerID- Numerical ID of the Layer to be added

Return Codes

sSuccess - the layer id was added

sFailure - layers functionality turned off or internal failure or the layer id has already been added

sInvalidObject - the object was invalid

sInvalidArgument - the layer ID was invalid

statusCode AlCategory::removeMember(int layerID )

Description

Removes a layer from the current category

Arguments

< layerID- numerical ID of the layer to be removed

Return Codes

sSuccess - the layer id was removed

sFailure - layers functionality turned off or internal failure or the layer id does not exist in the category

sInvalidObject - the object was invalid

sInvalidArgument - the layer ID was invalid

int AlCategory::numberOfMembers() const

Description

Returns the member count of the category. If this method fails, -1 is returned.

statusCode AlCategory::members(int numMembers, int members[])

Description

Returns the members of the category

Arguments

< numMembers- size of array members

> members - array of size numMembers, to return the member list in

Return Codes

sSuccess - the number of members is returned can legally be zero

sFailure - layers functionality turned off or internal failure

sInvalidObject - the object was invalid

sInvalidArgument - the value numMembers was not within layer range or the numMembers was greater then the numberOfMembers() in the category

boolean AlCategory::isPicked() const

Description

Returns the pick status of the category;

Return Codes

true - if the category is picked

false - if it is not picked, the object is invalid or layer functionality is turned off.

statusCode AlCategory::pick (boolean state)

Description

Sets the pick status of the category

Arguments

< state - new state of the category, a value of true makes the category picked and false sets it to unpicked

Return Codes

sSuccess - the state was set

sFailure - layers functionality is disabled.

sInvalidObject - the object is not valid