Display help information identified by a URL
int PtHelpUrl( char *url );
ph
PtHelpUrl() tells the Helpviewer to display the help text located by the given Universal Resource Locator. If the URL is relative (i.e. it doesn't start with a /), it's appended to any partial URL root specified in a previous call to PtHelpUrlRoot().
PtHelpUrl() spawns the Helpviewer if it isn't running, or sends a message to the Helpviewer if it is. Using this function, a Photon application can respond to a help request from the user by telling the Helpviewer to display the relevant help information.
0 on success, or -1 if the Helpviewer couldn't be found or spawned.
PtHelpUrl() returns immediately, before the help topic has been displayed. |
The following example shows a fragment from a hypothetical application built using PhAB. This application first sets up a URL root for all help requests; it then displays help for a particular part of the application in response to a callback (which could be attached to a hotkey, for example).
#include <Pt.h> int main( void ) { … PtHelpUrlRoot( "$YOUR_QNX_TARGET_NAME/usr/help/product/photon/prog_guide/intro.html" ); … } int HelpCallback( PtWidget_t * widget, ApInfo_t * apinfo, PtCallbackInfo_t * cbinfo ) { … if( widget == ABW_Libraries ) PtHelpUrl( "#PhotonLibraries" ); … return( Pt_CONTINUE ); }
Photon
Safety: | |
---|---|
Interrupt handler | No |
Signal handler | No |
Thread | No |
PtHelpQuit(), PtHelpSearch(), PtHelpTopic(), PtHelpTopicRoot(), PtHelpTopicTree(), PtHelpUrlRoot()
Context-Sensitive Help chapter of the Photon Programmer's Guide
helpviewer in the QNX Neutrino Utilities Reference.