Registering and logging in removes this ad.
Registering and logging in removes this ad.
Scripts to Bring Up Help Pages for Scripting Topics
Submitted by BruceCyr on Mon, 08/11/2008 - 20:41.
Does anyone have an example of a script that will pull up a specific scripting topic, for example the section on "Advanced Scripting Basic Language"? Clicking on that link in the help file yields this link:
ms-its:F:\NATURA~1\help\enx\power\dragon_enx.chm::/vbs/SpeechLinks_Basic_Language.htm
Another possibly useful topic would be "Dragon NaturallySpeaking Scripting Language Extensions", whose link is:
ms-its:F:\NATURA~1\help\enx\power\dragon_enx.chm::/scrptref/Scripting_Language_quickref.htm
I don't know how to translate these into scripts.
TIA
Bruce
in Vocola...
I don't know if this will help, but here's an early attempt at macros for pulling up Dragon help in Vocola 2.6:
###
### Voice commands for displaying parts of the Dragon help pages
###
Help(topic) := HTMLHelp("dragon_enx.chm", "HH_DISPLAY_TOPIC", $topic);
##
## Help for functions available through Vocola
##
#
# Dragon calls for which Dragon documentation is available:
#
<command> := (
Active Control Pick = activecontrolpick |
Active Menu Pick = activemenupick |
App Bring Up = appbringup |
App Swap With = appswapwith |
Beep = beep |
Button Click = buttonclick |
Clear Desktop = cleardesktop |
Control Pick = controlpick |
Dde Execute = ddeexecute |
Dde Poke = ddepoke |
Dll Call = dllcall |
Drag To Point = dragtopoint |
Go To Sleep = gotosleep |
Heard Word = heardword |
HTML Help = htmlhelp |
Menu Cancel = menucancel |
Menu Pick = menupick |
Mouse Grid = mousegrid |
message Box Confirm = msgboxconfirm |
Play Sound = playsound |
Remember Point = rememberpoint |
Run Script File = runscriptfile |
Send Keys = sendkeys | # equivalent to SendDragonKeys
Send Dragon Keys = sendkeys | # !?!
Send System Keys = sendsystemkeys |
Set Microphone = setmicrophone |
Set Mouse Position = setmouseposition |
Set Natural Text = setnaturaltext |
Shell Execute = shellexecute |
TTS Play String = ttsplaystring |
Wait = wait |
Wait For Window = waitforwindow |
Wake Up = wakeup |
Win Help = winhelp |
key names = key_names
);
show help for <command> = Help("scrptref/$1.htm");
<command2> := (
Shift Key = ShiftKey | # undocumented Dragon call
Eval = Eval |
Repeat = Repeat
);
show help for <command2> =
AppBringUp("lookup", "http://vocola.net/BuiltinFunctions.html#$1");
I believe HTMLHelp(-) works the same way in advanced scripting macros so this is probably convertible...
- Mark
Mark, That looks like good
Mark,
That looks like good code and I appreciate the effort. The fact that it doesn't help me reflects my incompetence, but maybe another DNS Pro user will be able to use it.
Bruce
Command to go to help topics
Bruce,
This is a portion of a DNS Pro command I use. The command is simple to code, HTMLHelp. The hard part is getting the path of the help file you want to view.
These three commands are long and will wrap in the browser window.
' Case "VB Help"
HTMLHelp "C:\Program Files\Nuance\NaturallySpeaking9\Help\enx\profrt\dragon_enx.chm::/vbs/Abs_Function.htm","HH_DISPLAY_TOC"
'
' Case "SendKeys Help"
HTMLHelp "C:\Program Files\Nuance\NaturallySpeaking9\Help\enx\profrt\dragon_enx.chm::/vbs/SendKeys_Instruction.htm","HH_DISPLAY_TOC"
'
' Case "Dragon Help"
HTMLHelp "C:\Program Files\Nuance\NaturallySpeaking9\Help\enx\profrt\dragon_enx.chm::/vbs/AcctiveControlPick.htm.htm","HH_DISPLAY_TOC"
Here is the DNS help file for HTMLHelp.
Calls the Microsoft HTML Help API. This command enables you to display HTML Help and close HTML Help windows. For more information on the HTML Help API, see the Microsoft HTML Help documentation.
Syntax
The following sections provide the syntax for each supported HTML Help API commands and describe the command's function. They use the following common parameter names:
Parameter Description
helpFile The name of the complied HTML Help file to open, for example, dragon_enx.chm. If you do not specify a full path, Dragon NaturallySpeaking looks in the currently active Dragon NaturallySpeaking Help folder. If the file is not found there, the normal HTML Help file search rules apply.
topic The specific HTML topic to display. If the compiled help uses subdirectories, this parameter must include the subdirectory. For example, this topic is scrptref/htmlhelp.htm. Note that the identifier uses a forward slash (/).
window The name of the window in which to display the HTML Help, for example, main. This parameter is always optional.
HH_DISPLAY_TOPIC
HTMLHelp "helpFile[>window]", "HH_DISPLAY_TOPIC", "topic"
Opens the specified topic.
HH_DISPLAY_TOC
HTMLHelp "helpFile[::/topic][>window]", "HH_DISPLAY_TOC"
Displays the Table of Contents navigation pane and opens the specified topic, if any.
HH_DISPLAY_INDEX
HTMLHelp "helpFile[::/topic][>window]", "HH_DISPLAY_INDEX", "[indexSearchText]"
Displays the Index navigation pane and enters the indexSearchText string, if any, in the keyword field.
HH_HELP_CONTEXT
HTMLHelp "helpFile[>window]", "HH_HELP_CONTEXT", "ContextId"
Displays the Help topic for the specified contextId in the specified window. The contextId must be the numeric ID in the [MAP] section of the Help project (.hhp) file for the topic to display.
HH_CLOSE_ALL
HTMLHelp "", "HH_CLOSE_ALL"
Closes all HTML Help Windows opened by this program. The first argument must be an empty pair of double quotes.
Examples
HH_DISPLAY_TOC
This instruction opens dragon_enx.chm in the default window, displays the Contents tab in the navigation pane, and displays the htmlhelp.htm topic (this topic) in the topic pane.
HTMLHelp "dragon_enx.chm::/scrptref/htmlhelp.htm, "HH_DISPLAY_TOC"
HH_HELP_CONTEXT
This instruction opens MyProg.chm in a Help window named "HiddenNav" and displays the topic with the context ID 133096 (Hex 207E8).
HTMLHelp "C:\\MyProg\Help\MyProg.chm>HiddenNav", "HH_HELP_CONTEXT", "133096"
Notes
Dragon NaturallySpeaking does not get error returns from the HTML Help engine. As a result, it cannot display any messages when an HTML Help error occurs.
If the HTML Help file name does not use an absolute path, The HTMLHelp command first checks in the Dragon NaturallySpeaking Help directory for the requested help file. If the file is not found, the he normal HTML Help file search rules apply.
Bruce
Bruce T, Thanks -- maybe I
Bruce T,
Thanks -- maybe I can work with these examples, maybe not. I haven't tried any VB in several years.
Seems to me Nuance should have provided this type of help help years ago.
Bruce C
Bruce. You really ned an
Bruce.
You really need an HTML help decompiler to get the directory and file in order to create a command to display a directory of help files or the files.
These are two decompiler applications I have used. I like both of them.
HTML Help workshop
http://www.microsoft.com/downloads/details.aspx?fa...
CHM Decoder
http://www.gridinsoft.com/chm.php
Any of the CHM files in this directory, or any other directory, can be decompiled.
C:\Program Files\Nuance\NaturallySpeaking9\Help\enx\profrt
Good Luck
Bruce
Just use the addresses from the
Maybe I'm missing something, but I don't think you need a decompiler.
Open up the Help screen that you wish to display using the HTMLhelp. Then in the upper left of the window, right-click and then choose "Jump to URL...".
At that point, the "Current URL" field has almost what you need. Copy it. The file name needs to change from:
C:\PROGRA~1\Nuance\NATURA~1\help\...
to
C:\Program Files\Nuance\NaturallySpeaking10\help\...
(substituting the proper release... this illustrates 10)
and you have to strip off the "mk:@MSITStore:" from the front of the string.
Larry Allen
http://www.pcspeak.com
Larry, You were not missing
Larry,
You were not missing anything. I didn't know about that option.
Boy do I love user forums.
Thanks
Bruce