This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtGetResources()

Retrieve one or more resource values for a widget

Synopsis:

int PtGetResources( PtWidget_t *widget,
                    int n_args,
                    PtArg_t *args );

Library:

ph

Description:

This function sets pointers to resource values within the specified widget. The args array indicates which resources are desired, and n_args indicates the number of items in the args array.

If you're getting only one resource, it's easier to call PtGetResource().

You must initialize the args array with PtSetArg() or Pt_ARG() before calling PtGetResources(). The Pt type of a resource determines how that resource should be set or queried. You use the Pt type when setting a resource entry with PtSetArg().

For more information, see the Manipulating Resources in Application Code chapter of the Photon Programmer's Guide.

Because PtGetResources() returns pointers directly into the internals of the widget, don't modify those values directly. If you wish to retrieve the value of a given resource and then modify that value: Get the resource. Copy the resource to a temporary variable. Modify the temporary variable. Using the modified copy, set the resource.

Returns:

0

Success.

-1

An error occurred.

Examples:

Determine a widget's color, and determine whether or not the widget is highlighted:

PtArg_t          args[2];
PgColor_t        *color;
unsigned long    *flags;
PtWidget_t       *widget;

PtSetArg( &args[0], Pt_ARG_FILL_COLOR, &color, 0 );
PtSetArg( &args[1], Pt_ARG_FLAGS, &flags, 0 );
PtGetResources( widget, 2, args );

printf( "Color: %08lx Highlighted: %s\n", *color, 
        *flags & Pt_HIGHLIGHTED ? "Yes":"No" );

Classification:

Photon

See also:

PtArg_t, Pt_ARG(), PtGetResource(), PtSetArg(), PtSetResource(), PtSetResources()

Manipulating Resources in Application Code chapter of the Photon Programmer's Guide.