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

PtDamageWidget()

Mark a widget as damaged so it will be redrawn

Synopsis:

int PtDamageWidget( PtWidget_t *widget );

Library:

ph

Description:

This function adds the specified widget's extent to the damage list of the widget's first window parent. This effectively marks the widget as being damaged so that it will be redrawn.

The widget library takes care of updating widgets whenever resources are modified; you don't normally need to use this function unless you're using a PtRaw widget and want it to redraw and repair itself.

If you want the widget to be redrawn immediately, call PtFlush() after calling PtDamageWidget().

Returns:

0
Successful completion.
-1
An error occurred.

Examples:

Set some global variables used in a PtRaw widget's draw function and then damage the widget:

grid_color  = Pg_BLACK;
line_color1 = Pg_BLUE;
line_color2 = Pg_RED;

PtDamageWidget( my_raw_widget );

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtDamageExtent(), PtFlush()


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/ptdamagewidget.html on line 121

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/ptdamagewidget.html on line 121