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/ptsurfaceremovedata.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/ptsurfaceremovedata.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/ptsurfaceremovedata.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/ptsurfaceremovedata.html on line 8

PtSurfaceRemoveData(), PtSurfaceRemoveDataById()

Remove data from a control surface

Synopsis:

int PtSurfaceRemoveData( PtWidget_t *widget,
                         PtSurface_t *surface );

int PtSurfaceRemoveDataById( PtWidget_t *widget,
                             unsigned char surface_id );

Library:

ph

Description:

These functions remove user data from a control surface belonging to the given widget. They differ in the way they identify the control surface:

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

If, when the data was added, the len argument was nonzero, the copy of the data that was made is automatically freed, otherwise no deallocation takes place.


Note: Data is automatically removed when a control surface is destroyed.

Returns:

-1
The control surface or data wasn't found.
Pt_CONTINUE
The data was found and released.
Pt_HALT
The data was found, the node was released, and the data was taken care of by the remove function.
Pt_END
The node wasn't removed; refused by the remove function.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtSurfaceAddData(), PtSurfaceAddDataById(), PtSurfaceGetData(), PtSurfaceGetDataById()

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/ptsurfaceremovedata.html on line 149

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/ptsurfaceremovedata.html on line 149