VisClass: 3.6 VisClass Instance Data: VI_specAttrs

| Up: GEOS SDK TechDocs | Up | Prev: 3.5 VI_geoAttrs | Next: 3.7 VI_link 
VI_specAttrs, MSG_SPEC_SET_ATTRS, MSG_SPEC_GET_ATTRS

The VI_specAttrs field is a record of eight flags. This field is accessed only by objects that are part of a Specific UI library. Applications will almost never access this field or use its flags. Documentation on creating specific UI libraries may be published under separate cover.

MSG_SPEC_SET_ATTRS

void	MSG_SPEC_SET_ATTRS(
        SpecAttrs		attrsToSet,
        SpecAttrs		attrsToClear,
        VisUpdateMode		updateMode);

This message sets the current VI_specAttrs field to the values passed. A flag set in both attributes parameters will be cleared.

Source: Unrestricted.

Destination: Any visible object used as a specific UI object.

Parameters: attrsToSet A record of SpecAttrs indicating which flags are to be set in the object's VI_specAttrs field.

attrsToClear
A record of VisAttrs indicating which flags are to be cleared for the object (a flag set in attrsToClear will be cleared in VI_specAttrs ).
updateMode
A VisUpdateMode indicating when the object should be visually updated on the screen.

Return: Nothing.

Interception: Unlikely.

MSG_SPEC_GET_ATTRS

SpecAttrs MSG_SPEC_GET_ATTRS();

This message returns a visible object's current VI_specAttrs field. This field is used only by Specific UI libraries and is meaningful only for objects in these libraries.

Source: Unrestricted.

Destination: Any visible object that is used as a specific UI object.

Parameters: None.

Return: A byte of type SpecAttrs indicating which flags are set in the object's VI_specAttrs field.

Interception: Unlikely.

| Up: GEOS SDK TechDocs | Up | Prev: 3.5 VI_geoAttrs | Next: 3.7 VI_link