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
Remove data from a control surface
int PtSurfaceRemoveData( PtWidget_t *widget,
PtSurface_t *surface );
int PtSurfaceRemoveDataById( PtWidget_t *widget,
unsigned char surface_id );
ph
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.
|
Data is automatically removed when a control surface is destroyed. |
- -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.
Photon
Safety: | |
Interrupt handler |
No |
Signal handler |
No |
Thread |
No |
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