Using online Help

PowerBuilder has two kinds of online Help: HTML Help and Windows Help.

About HTML Help

HTML Help contains several PowerBuilder books: this Users Guide, Application Techniques, the DataWindow Programmers Guide, Connecting to Your Database, and Deploying Applications and Components to .NET.

About Windows Help

Windows Help contains a list of new features in this release, context-sensitive Help, all the reference information in Objects and Controls, the Connection Reference, the DataWindow Reference, and the PowerScript Reference, and Help for tools such as the Migration Assistant and the Profiling and DWSyntax tools.

Some Windows Help topics provide links to related topics in the HTML Help.

NoteVista support for Windows Help If you or your users use the Windows Vista operating system, see “Using Windows Help files on Vista”.

Accessing Help

Table 1-8 lists the ways you can access Help.

Table 1-8: Accessing online Help

Approach

What it does

Use the Help menu on the menu bar

Displays the Help contents, the What’s New in PowerBuilder Help, or Help for the current painter.

In a wizard, click the Help button [?] in the upper right corner of the window

The pointer displays with a question mark so you can get context-sensitive Help. Point and click in a field you need Help on.

In the Properties view in a painter, select Help from the pop-up menu on any tab page

Displays a Help topic from which you can get Help on the properties, events, and functions for the object or control whose properties are displaying in the Properties view.

Add a Help button to the PowerBar and use it

Displays the Help contents.

Press F1

Displays the Help contents.

Press Shift+F1 in the Script view or Function painter

Displays context-sensitive Help about the function, event, or keyword under the cursor.

Select Help from the pop-up menu in the Browser

Displays Help for the Browser or for the selected object, control, or function.

Click the Help button in a dialog box

Displays information about that dialog box.

Click the link to HTML Help icon in a Windows Help topic

Opens the HTML Help at the linked topic.

Sybooks CD and Web site

PowerBuilder books are also provided on the Sybooks CD and the Sybase Product Manuals Web site. For more information, see “Other sources of information”.

Using Windows Help files on Vista

Windows Vista does not distribute the WinHlp32.exe file required to open Windows Help files such as the pbhlp115.hlp file used in PowerBuilder. To use .hlp files, you need to download a special Vista version of WinHlp32.exe from the Microsoft Web site.

Compiled HTML Help (.chm) files are supported, but you need to edit the Windows registry to enable a Help macro that supports links from the pbhlp115.hlp file to the pbman115.chm file. If you do not edit the registry, the “For more information” links at the bottom of many topics in the Windows Help display an error.

You also need to edit the registry if you need to run Windows Help files at a remote location on an intranet.

NoteRegistry reflection on 64-bit Windows 64-bit versions of Windows use registry reflection to maintain a 32-bit registry view and a 64-bit registry view. On 64-bit Windows, configuration information related to 32-bit applications is stored in the HKEY_LOCAL_MACHINE\Software\WOW6432node registry hive.

StepsTo enable Windows Help macros and remote access on Vista:

  1. Create the following registry key.

    On 32-bit Windows:

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WinHelp
    

    On 64-bit Windows:

    HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432node\Microsoft\
    WinHelp
    

  2. Add a new DWORD value with the name AllowProgrammaticMacros and the value 1.

  3. Add a new DWORD value with the name AllowIntranetAccess and the value 1.

You can also add this support by saving the following lines in Notepad to a file with the extension .reg and importing it into the registry.

On 32-bit Windows:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WinHelp]
"AllowProgrammaticMacros"=dword:00000001
"AllowIntranetAccess"=dword:00000001

On 64-bit Windows:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432node\Microsoft\WinHelp]
"AllowProgrammaticMacros"=dword:00000001
"AllowIntranetAccess"=dword:00000001

Microsoft prohibits the distribution of WinHlp32.exe with deployed applications. If your application uses .hlp files, you should provide your users with instructions on how to download WinHlp32.exe. Links for downloading WinHlp32.exe are available by searching for it on the Microsoft download site.