{ WebProperty=ClientProtected }
Property Boolean pbEnabled
| Web Property Read Access: | WebGet pbEnabled to BooleanVariable |
| Web Property Write Access: | WebSet pbEnabled to BooleanVariable/Value |
| Read Access: | Get pbEnabled to BooleanVariable |
| Write Access: | Set pbEnabled to BooleanVariable/Value |
The pbEnabled property is used to control user access to a web control.
If pbEnabled is set to False, then the user cannot give focus to the control or edit any data that it is displaying. You can set the value programmatically, but it will not be saved.
The control is still visible, but it will be rendered in a lighter color (according to the cascading style sheets (CSS) theme (psTheme) you are using).
The other properties that can be used to manage the visibility of a Web Control are pbVisible and pbRender.
pbNoAccessibilityCheck controls whether the framework looks at pbRender, pbVisible and pbEnabled of itself or its parents to determine if the control is accessible.
If pbEnabled is set to False in a cWebGrid, the control can still take the focus, but disabled columns cannot.
If pbEnabled is set to False in a cWebColumn, disabled columns cannot take the focus, but do not appear disabled.
If pbEditable is set to False in a cWebColumn, disabled columns cannot take the focus and appear disabled.
Each web property maintains two values: The regular property value is set during object creation and should not be changed during the lifetime of that object. To access that value, use the standard property Get and Set syntax.
The web property value is the local value stored at each client. This is synchronized to the client's local value whenever a server call is being processed. To access the web property value, use the WebGet and WebSet syntax above instead of the standard Get and Set syntax.