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/ptsurfaceadddata.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/ptsurfaceadddata.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/ptsurfaceadddata.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/ptsurfaceadddata.html on line 8
Add data to a control surface
int PtSurfaceAddData( PtWidget_t *widget,
PtSurface_t *surface,
void *data,
long len );
int PtSurfaceAddDataById( PtWidget_t *widget,
unsigned char surface_id,
void *data,
long len );
ph
These functions attach data to a control surface belonging to the given
widget.
They differ in how they identify the control surface:
- PtSurfaceAddData()
- Uses the surface argument, which points to a
PtSurface_t structure that describes the control surface.
This pointer must not be NULL.
- PtSurfaceAddDataById()
- Searches the control surfaces belonging to the widget for the one
with an ID of surface_id.
The data arguments points to the data to attach.
This data can be anything you need to store with the surface.
Any data previously added to this surface is removed and overwritten.
The len argument specifies the length (in bytes) of the data.
If len is nonzero, then len bytes of data are copied
from the data pointer, and that copy is attached to the surface.
This copy is freed when the data is removed.
If len is 0, no copying is performed, and no deallocation takes
place when the data is removed.
- 0
- Success.
- -1
- The operation failed due to a lack of memory, or the specified surface
couldn't be found.
Photon
Safety: | |
Interrupt handler |
No |
Signal handler |
No |
Thread |
No |
PtSurfaceGetData(),
PtSurfaceGetDataById(),
PtSurfaceRemoveData(),
PtSurfaceRemoveDataById()
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/ptsurfaceadddata.html on line 140
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/ptsurfaceadddata.html on line 140