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

PtHelpTopic()

Display help information identified by a topic path

Synopsis:

int PtHelpTopic( char *topic );

Library:

ph

Description:

PtHelpTopic() tells the Helpviewer to display the help text located by the given topic path.

PtHelpTopic() 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.

If the topic path is relative (i.e. it doesn't start with a /), it's appended to the root topic path specified in an earlier call to PtHelpTopicRoot().

Returns:

0 on success, or -1 if the Helpviewer couldn't be found or spawned.


Note: PtHelpTopic() returns immediately, before the help topic has been displayed.

Examples:

The following example shows a fragment from a hypothetical application built using PhAB. This application first sets up a topic 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 )
{
    …
    PtHelpTopicRoot(
       "/Photon microGUI/Programmer's Guide/Introduction" );
    …
}

int HelpCallback( PtWidget_t * widget, ApInfo_t * apinfo, 
                  PtCallbackInfo_t * cbinfo )
{
    …
    if( widget == ABW_Concepts )
        PtHelpTopic( "Widget concepts" );
    …
    return( Pt_CONTINUE );
}

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PtHelpQuit(), PtHelpSearch(), PtHelpTopicRoot(), PtHelpTopicTree(), PtHelpUrl(), PtHelpUrlRoot()

Context-Sensitive Help chapter of the Photon Programmer's Guide

helpviewer in the QNX Neutrino Utilities Reference.


Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/pt/pthelptopic.html on line 155

Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/pt/pthelptopic.html on line 155