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

`ResPluginGetChangesF_t`

A function you must write to get changed resource data

Synopsis:

typedef void ResPluginGetChangesF_t (
  ResPluginHandle_t handle,
  int *pn,
  void **pvalue )

Description:

This function is exported in the ResPluginFullEditor_t structure.

This function is called by PhAB to retrieve changes to resource data from the editor. It is called only after a call to ResPluginAnyChangesF_t indicates that there are changes to the resource editor's data.

If the master copy rule applies, PhAB will take this data and make it the new master copy.

Arguments:

handle: The ResPluginHandle_t handle returned when the instance of the editor is created with ResPluginFullCreateF_t.
pn: A pointer to resource data. The actual data depends on the resource type.
pvalue: A pointer to resource data. The actual data depends on the resource type.

Examples:

This sample ResPluginGetChangesF_t function for a full editor is from the complete plugin example at the end of this chapter.

static void plugin_full_get_changes( ResPluginHandle_t handle, int *pn, void **pvalue )
{
  PluginFullInstance_t *instance = ( PluginFullInstance_t * ) handle;
  char *p;
  PtGetResource( instance->full_widget, Pt_ARG_TEXT_STRING, &p, 0 );
  *pn = strlen( p );
  *pvalue = strdup( p );
}

Classification:

QNX Neutrino