PtReattach()

Send an application through the jump gate

Synopsis:

int PtReattach( char *device );

Description:

This function provides Photon's "jump gate" mechanism - it unrealizes all top-level widgets in an application, disconnects them from the current Photon server, connects to the Photon server indicated by device (e.g. //88/dev/photon), and realizes the top-level widgets at the new location.

As a result, the PHOTON environment variable is set and the user interface is rehosted to the new Photon server.

Returns:

0

Success.

-1

Unable to connect to device due to insufficient memory.

Examples:

int transport_edit_activate( PtWidget_t *widget, 
      void *data, PtCallbackInfo_t cbinfo );
{
     PtTextCallback_t *tcb=cbinfo->cbdata;
     PtReattach( tcb->text );
}

Classification:

Photon