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

PtWidgetPreferredSize()

Retrieve the preferred size of a widget

Synopsis:

PhDim_t *PtWidgetPreferredSize(
            PtWidget_t const *widget,
            PhDim_t *dim );

Library:

ph

Description:

This function retrieves the optimal size of a widget, which is recorded whenever the widget calls PtResizeCanvas() or PtAttemptResize() while calculating its extent (see Building Custom Widgets).

The preferred size is the size the widget would be if Pt_RESIZE_XY_ALWAYS were set in its Pt_ARG_RESIZE_FLAGS. The preferred size is never any smaller than the widget's minimum size. The resulting dimension is stored in the PhDim_t structure pointed to by dim.

Returns:

A pointer to the PhDim_t structure that was passed in.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No