Requirements to enable/disable controls

Many functions are dependent on certain conditions are met. For example, a tool button does not make sense, if no map window exists or there is no editable layer. So the button should not even offered in this case - and should be disable.

With the Ribbon SDK, you no longer have to validate these conditions in your own routine after the user has pressed the button. The conditions are now properties of the Control.

 

Selection

LogicalValue

True: To enable the control a selection is required.

False: To enable the control NO selection is available

Unknown: The condition does not matter

 

Editable

LogicalValue

True: To enable the control a map window with an editable layer is required

False: Although this value is possible, but there is no meaningful example

Unknown: The condition does not matter

 

Mappable

LogicalValue

True: To enable the control a mappable table or selection is required

False: To enable the control a non mappable table or selection is required

Unknown: The condition does not matter

This condition is only effective if other condition are set: Selection = True and/or Table = tablename

 

Writable

LogicalValue

True: To enable the control a writable table or selection is required

False: To enable the control a readonly table or selection is required

Unknown: The condition does not matter

This condition is only effective if other condition are set: Selection = True and/or Table = tablename

 

Table

 

Text, free: The name of the required table in conjunction with other requirements Selection/Editable/Mappable/Writable

 

Frontwindow

 

Browser

Layout

Map

The type of a required front window to enable the control

 

Examples

To enable the control a selection from 'Trees' must be available: Selection=Tue, Table=Trees

To enable the control a mapper window with any editable layer must be in front: Editable=Tue, Frontwindow=Map

To enable the control a writable and mappable table 'Trees' must be open : Editable=Tue, Mappable=True, Table=Trees

 

See also: Control Properties