Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pt/ptdisablesurface.html on line 1

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pt/ptdisablesurface.html on line 1

Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pt/ptdisablesurface.html on line 8

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pt/ptdisablesurface.html on line 8

PtDisableSurface(), PtDisableSurfaceById()

Disable a control surface

Synopsis:

void PtDisableSurface( PtWidget_t *widget,
                       PtSurface_t *surface,
                       unsigned long flags );

void PtDisableSurfaceById( PtWidget_t *widget,
                           unsigned char surface_id,
                           unsigned long flags );

Library:

ph

Description:

These functions disable a control surface belonging to the given widget.

PtDisableSurface()
Uses the surface argument, which points to a PtSurface_t structure that describes the control surface. This pointer must not be NULL.
PtDisableSurfaceById()
Searches the control surfaces belonging to the widget for the one with an ID of surface_id.

Disabled surfaces are drawn, but they don't respond to events. They do or don't consume events to which they're sensitive, depending on the setting of their Pt_SURFACE_CONSUME_EVENTS flag. If this bit is set, the surface effectively blocks events to which it's sensitive.

The flags argument specifies additional action to take, and may include the following values:

Pt_DAMAGE_SURFACE
Damage the surface if its state changes. This is useful if a surface draws differently depending on its enabled/disabled state.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtDisableSurfaceByAction(), PtEnableSurface(), PtEnableSurfaceByAction(), PtEnableSurfaceById(), PtSurfaceIsDisabled(), PtSurfaceIsEnabled()

Control Surfaces chapter of the Photon Programmer's Guide


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pt/ptdisablesurface.html on line 133

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pt/ptdisablesurface.html on line 133