home *** CD-ROM | disk | FTP | other *** search
/ Australian Personal Computer 1999 January / apc412.iso / features / quick / qvdemo.exe / DDE.TX$ / DDE.TXT
Encoding:
Text File  |  1996-05-14  |  28.8 KB  |  621 lines

  1. QuickVerse for Windows
  2. Dynamic Data Exchange Specification
  3. December, 1995
  4.  
  5. *********************************************************************
  6.                         INTRODUCTION
  7. *********************************************************************
  8.  
  9. This document specifies the Dynamic Data Exchange (DDE) support 
  10. provided by QuickVerse for Windows (QV/Win).  DDE is a method whereby 
  11. two applications can communicate with one another using a standardized 
  12. format.  The two applications can share data as well as send and 
  13. respond to commands that specific actions be performed. 
  14.  
  15. In every DDE conversation, one application is called the "client 
  16. application" and the other is called the "server application."  The 
  17. client is the application that begins the conversation, requests data 
  18. from the other application, and sends commands to the other 
  19. application.  The server application is the application that provides 
  20. data to the client or that performs actions requested by the client.  
  21. QuickVerse for Windows is capable of being both a DDE client and a DDE 
  22. server.  For example, when QuickVerse requests that PC Bible Atlas for 
  23. Windows (PCBA/Win) show a map containing a city, then QuickVerse is 
  24. acting as a DDE client.  When another program requests that QuickVerse 
  25. perform a Quick Paste operation, QuickVerse acts as a DDE server.  
  26. This document provides specifications for both server and client DDE 
  27. capability supported by QuickVerse. 
  28.  
  29. IMPORTANT NOTE:  Due to substantial improvements in dynamic data 
  30. exchange processing included with QuickVerse for Windows version 1.0i, 
  31. we recommend that this version be the minimum program version used 
  32. when using DDE with QuickVerse.  You can determine your version of 
  33. QuickVerse for Windows by referring to the "About Box" (select About 
  34. QuickVerse from the Help menu).
  35.  
  36. For specific information on using DDE with QuickVerse and another 
  37. application, refer to this document and the other application's 
  38. documentation.  For specific information on how to write your own 
  39. program that uses DDE, refer to chapter 15 of the Windows Software 
  40. Developer Kit (SDK) volume 2 and chapter 17 of "Programming Windows 
  41. 2nd edition" by Charles Petzold.
  42.  
  43.  
  44. *********************************************************************
  45.                         SERVER SPECIFICATION
  46. *********************************************************************
  47.  
  48. GENERAL METHODOLOGY
  49. -------------------
  50.  
  51. QuickVerse supports "cold" DDE links.  Cold links allow information to 
  52. be passed from one application to another without any additional 
  53. updating being required or requested.  Warm links and hot links are 
  54. not required and are not supported. 
  55.  
  56. QuickVerse responds to the application name "QVWIN" and the topic name 
  57. of "Verses."  The primary DDE interface supported by QuickVerse is the 
  58. WM_DDE_EXECUTE message.  The QuickVerse server will respond to a 
  59. variety of instructions (also called commands) passed with the 
  60. WM_DDE_EXECUTE command.  The QuickVerse server is also capable of 
  61. responding to a WM_DDE_REQUEST message; however, the preferred 
  62. interface is through the WM_DDE_EXECUTE message. 
  63.  
  64. QuickVerse responds to all WM_DDE_EXECUTE messages with a WM_DDE_ACK 
  65. acknowledgement.  A negative acknowledgement is sent if the command 
  66. could not be completed; a positive acknowledgement indicates that the 
  67. command was completed.  
  68.  
  69. SPECIFICATION FOR WM_DDE_EXECUTE
  70. --------------------------------
  71.  
  72. The WM_DDE_EXECUTE message is used to pass commands to QV/Win.  These 
  73. commands can cause QV to perform a specific action (such as a search) 
  74. or to provide information back to the caller (such as a version 
  75. number).  In all cases, the item string contains the command string.
  76. The command string is one or more execute commands and any of their 
  77. associated parameters.  
  78.  
  79. The following execute commands are supported.  The Syntax Version 
  80. column specifies the syntax version of each command, and the Program 
  81. Version column indicates which version of QuickVerse first supported 
  82. the command.  Detailed descriptions of these command are provided in a 
  83. later section.
  84.  
  85.                                     Syntax          Program
  86.     Execute Command                 Version         Version
  87.     --------------------------------------------------------
  88.     NULL                               0              1.0c
  89.     [QvPaste]                          1              1.0f
  90.     [GoTo("John 3:16")]                1              1.0f
  91.     [Translation("KJV")]               1              1.0f
  92.     [Minimize]                         1              1.0f
  93.     [Activate]                         1              1.0f
  94.     [QuickSearch("phrase")]            1              1.0g
  95.     [RefSearch("ref")]                 1              1.0i
  96.     [LoadProgVersion(hmem)]            1              1.0i
  97.     [LoadSyntaxVersion(hmem)]          1              1.0i
  98.     [LoadCurrentTranslation(hmem)]     1              1.0i
  99.     [LoadTranslations(hmem)]           1              1.0i
  100.     [LoadVerseText(parameters)]        1              1.0i
  101.  
  102. Beginning with version 1.0i of QuickVerse, QuickVerse can return the 
  103. syntax level that it supports.  A client application can determine 
  104. which syntax level is supported to determine if QuickVerse will 
  105. support a specific command.  For instance, if a client application 
  106. wants to send a "level 2 syntax" command to QuickVerse, it may first 
  107. determine if QuickVerse supports that level of syntax.  All levels are 
  108. "backwards" compatible, so a program capable of support level 2 syntax 
  109. also supports all level 0 and level 1 commands.
  110.  
  111. Each command must be enclosed by brackets [ ] and each command may be 
  112. separated by a space.  Spaces within each command are not allowed, 
  113. except in quoted strings.  Parenthesis ( ) are used to begin and end 
  114. the parameter list.  All parameters are passed as strings and decoded 
  115. depending upon the execute command.  String parameters are expected to 
  116. be enclosed by double-quotes, so the string parameter may not contain 
  117. a double quote character.  Parenthesis within quoted parameters are 
  118. allowed. 
  119.  
  120. Multiple commands may be passed in one command string.  For instance, 
  121. to display John 3:16 in the King James Version, the following command 
  122. string would be used. 
  123.  
  124.     [Translation("KJV")][GoTo("John 3:16")]
  125.  
  126. However, this is not recommended.  By passing each command in a 
  127. different WM_DDE_EXECUTE message, the return value may be examined to 
  128. determine which command, if any, failed.  The one exception to this 
  129. recommendation is the [Activate] command, which is typically sent with 
  130. some messages.
  131.  
  132. If multiple commands are contained in one item, the commands will be 
  133. processed from left to right.  The process will abort and return a 
  134. negative acknowledgement immediately upon encountering an error.  That 
  135. is, if the command string is
  136.  
  137.     [Translation("KJV")][GoTo("John 3:16")]
  138.  
  139. and the KJV translation is unavailable, then the GoTo command will not 
  140. be attempted. 
  141.  
  142. Additional details about each command are provided below.
  143.  
  144.     Application:    QVWIN
  145.     Topic:          Verses
  146.     Item:           NULL
  147.     Example:        none
  148.     Syntax Level:   0
  149.  
  150.         A null item causes QuickVerse to perform a QuickVerse paste.  
  151.         The preferred method of performing this is to use the 
  152.         [QvPaste] item (see below).  Also note that all versions of 
  153.         QV/Win prior to version 1.0f will respond to _all_ 
  154.         WM_DDE_EXECUTE messages by performing this action.
  155.  
  156.     Application:    QVWIN 
  157.     Topic:          Verses 
  158.     Item:           [QvPaste] 
  159.     Example:        [QvPaste]
  160.     Syntax Level:   1 
  161.  
  162.         This command is used to perform a QuickVerse Paste operation.  
  163.         It causes a dialog box to be displayed.  The user can select a 
  164.         reference and a translation.  The reference is copied to the 
  165.         clipboard from the specified translation using current 
  166.         clipboard setup settings. 
  167.  
  168.     Application:    QVWIN 
  169.     Topic:          Verses 
  170.     Item:           [GoTo("ref")]
  171.     Example:        [GoTo("John 3:16")]
  172.     Syntax Level:   1
  173.  
  174.         This command causes QuickVerse to go to the specified 
  175.         reference in the currently active window.  The reference is 
  176.         passed as a string, so it must be enclosed in double-quotes.  
  177.         The reference string must conform to standard QuickVerse 
  178.         references and is limited to 128 characters.  An error occurs 
  179.         if there is not an active window.  A multiple verse reference 
  180.         may be passed; in this case, the first verse in the reference 
  181.         string will be used.
  182.  
  183.     Application:    QVWIN 
  184.     Topic:          Verses 
  185.     Item:           [Translation("abbr")]
  186.     Example:        [Translation("KJV")]        
  187.     Syntax Level:   1
  188.  
  189.         This command is used to activate the specified translation.  
  190.         Since some commands require a Bible window to be open, this
  191.         command may be used to make sure that at least one Bible 
  192.         window is available before sending another command.
  193.  
  194.         The translation is passed as a string, so it must be enclosed 
  195.         in double-quotes.  The translation is the standard 
  196.         abbreviation used by QuickVerse, and is limited to 4 
  197.         characters.  (Use the LoadTranslations command to obtain a 
  198.         list of installed translations.)  If the translation is 
  199.         already the active translation then nothing happens.  If a 
  200.         window with the translation is open but not active, it is 
  201.         activated.  If the translation is not open in any window, then 
  202.         a new window is opened to contain the translation.  During the 
  203.         processing of this command, QV/Win may be temporarily 
  204.         activated.  However, it returns activation to the previously 
  205.         active application when through. 
  206.  
  207.     Application:    QVWIN 
  208.     Topic:          Verses 
  209.     Item:           [Minimize]
  210.     Example:        [Minimize]        
  211.     Syntax Level:   1
  212.  
  213.         This command causes the whole QuickVerse application to be 
  214.         minimized (i.e. made into an icon), but does not activate it. 
  215.  
  216.     Application:    QVWIN 
  217.     Topic:          Verses 
  218.     Item:           [Activate]
  219.     Example:        [Activate]        
  220.     Syntax Level:   1
  221.  
  222.         This command causes QuickVerse to be activated.  If it is 
  223.         minimized, it is also restored to normal size.
  224.  
  225.     Application:    QVWIN 
  226.     Topic:          Verses 
  227.     Item:           [QuickSearch("phrase")]
  228.     Example:        [Activate][QuickSearch("Kingdom of God")]        
  229.     Syntax Level:   1
  230.  
  231.         This command is used to perform a QuickSearch on the given 
  232.         phrase.  The phrase is passed as a string, so it must be 
  233.         enclosed by double-quotes.  The phrase is limited to 128 
  234.         characters and 10 words.  It may be any phrase supported by 
  235.         QuickVerse and may include Boolean operators and punctuation.  
  236.         QuickVerse may or may not be activated following this command; 
  237.         therefore, it is typical to use the activate command in 
  238.         conjunction with this command.  An error occurs if there is 
  239.         not an active window.
  240.  
  241.     Application:    QVWIN 
  242.     Topic:          Verses 
  243.     Item:           [RefSearch("ref")]
  244.     Example:        [RefSearch("John 3:16; Eph 2:8-9")]        
  245.     Syntax Level:   1
  246.  
  247.         This command instructs QuickVerse to perform a search for the 
  248.         specified references.  The reference is passed as a string and 
  249.         therefore must be enclosed in double-quotes.  The reference 
  250.         string may be up to 128 characters long and contain up to 10 
  251.         different references.  QuickVerse may or may not be activated 
  252.         following this command; therefore, it is typical to use the 
  253.         activate command in conjunction with this command.  An error 
  254.         occurs if there is not an active window. 
  255.  
  256.     Application:    QVWIN 
  257.     Topic:          Verses 
  258.     Item:           [LoadProgVersion(hmem)]
  259.     Example:        [LoadProgVersion(1234)]        
  260.     Syntax Level:   1
  261.  
  262.         This command causes QuickVerse to load the string identified 
  263.         by the memory handle "hmem" with the version of QuickVerse.  
  264.         hmem is converted from a string value into an unsigned integer 
  265.         (memory handle) with little error checking provided.  An error 
  266.         occurs if hmem is not a valid memory handle, or if the memory 
  267.         it references is not large enough to contain the version 
  268.         string.  The version string is something like "1.0i" where 1.0 
  269.         is the major version number and the last letter is the minor 
  270.         revision letter.
  271.  
  272.     Application:    QVWIN 
  273.     Topic:          Verses 
  274.     Item:           [LoadSyntaxVersion(hmem)]
  275.     Example:        [LoadSyntaxVersion(1234)]        
  276.     Syntax Level:   1
  277.  
  278.         This command causes QuickVerse to load the syntax version that 
  279.         it supports into the memory identified by "hmem."  hmem is 
  280.         converted from a string value into an unsigned integer (memory 
  281.         handle) with little error checking provided.  An error occurs 
  282.         if hmem is not a valid memory handle.  The memory identified 
  283.         is loaded with an integer value (i.e. not a string 
  284.         representation of an integer) such as 1, 2, etc.
  285.  
  286.         It is recommended that client applications use this command to 
  287.         determine if QuickVerse supports the commands that the client 
  288.         supports.  Versions of QuickVerse prior to version 1.0i, 
  289.         however, do not support this command.
  290.  
  291.     Application:    QVWIN 
  292.     Topic:          Verses 
  293.     Item:           [LoadCurrentTranslation(hmem)]
  294.     Example:        [LoadTranslations(1234)]
  295.     Syntax Level:   1
  296.  
  297.         This command causes QuickVerse to load the string identified
  298.         by the memory handle hmem with the abbreviation of the
  299.         translation being used by the active window.  hmem is
  300.         converted from a string value into an unsigned integer
  301.         (memory handle) with little error checking provided.  An
  302.         error occurs if hmem is not a valid memory handle, or if
  303.         the memory it references is not large enough to contain
  304.         the translation abbreviation.
  305.  
  306.         The string contains only the abbreviation of the current
  307.         translation.  For example, if the King James Version is
  308.         active, the string would contain "KJV".
  309.  
  310.     Application:    QVWIN 
  311.     Topic:          Verses 
  312.     Item:           [LoadTranslations(hmem)]
  313.     Example:        [LoadTranslations(1234)]
  314.     Syntax Level:   1
  315.  
  316.         This command causes QuickVerse to load a string containing a 
  317.         list of the installed translations into the memory identified 
  318.         by the memory handle hmem.  hmem is converted from a string 
  319.         value into an unsigned integer (memory handle) with little 
  320.         error checking provided.  An error occurs if hmem is not a 
  321.         valid memory handle, or if the memory it references is not 
  322.         large enough to contain the string of translations.  The 
  323.         loaded string contains the abbreviations of the translations 
  324.         that are installed, with a space separating each entry.  
  325.         "KJV NIV RSV" is an example returned string.
  326.  
  327.     Application:    QVWIN 
  328.     Topic:          Verses 
  329.     Item:           [LoadVerseText(hmem, flags, "ref")]
  330.     Example:        [LoadVerseText(1234,0,"John 3:16-18")]
  331.     Syntax Level:   1
  332.  
  333.         This command is used to request that QuickVerse load the
  334.         specified memory handle (hmem) with verse text from the
  335.         active translation.  An error occurs if there is not an
  336.         active window.  Also note that there may not be any spaces
  337.         included in the list of parameters (the example above is 
  338.         correct).
  339.  
  340.         The "flags" parameter is a 2-byte bit field.  The individual
  341.         bits in this flag can be used to specify the format of the
  342.         text that is loaded.  You may specify a flag value of 0 to 
  343.         use default settings.  In the following table, the bit
  344.         position is from least significant to most significant (that 
  345.         is, Bit 0 is the least significant (right-most) bit).
  346.  
  347.           Bit(s)   Value    Definition
  348.         -----------------------------------------------------------
  349.             0       0       use plain text format
  350.                     1       use rich text format (rtf)
  351.             1       0       don't use a cancel dialog box
  352.                     1       use a cancel dialog box
  353.             2       0       when using rtf, don't use bold codes
  354.                     1       when using rtf, use bold codes
  355.             3       0       when using rtf, don't use italics codes
  356.                     1       when using rtf, use italics codes
  357.             4       0       when using rtf, don't use red codes
  358.                     1       when using rtf, use red codes
  359.             5       0       don't includes quotes around verses
  360.                     1       include quotes around verses
  361.             6       0       use full book names
  362.                     1       use abbreviated book names
  363.             7       0       don't include verse and word notes
  364.                     1       include verse and word notes
  365.             8       0       don't include book notes
  366.                     1       include book notes
  367.             9       0       don't include chapter notes
  368.                     1       include chapter notes
  369.             10      0       don't include translation with reference 
  370.                     1       include translation with reference
  371.          11-13      0       reference followed by verse format
  372.                     1       verse followed by reference format
  373.                     2       verse only format (no reference)
  374.                     3       reference above verse format
  375.                     4       reference only format (no verse)
  376.                     5       paragraph format
  377.          14-15      0       use Strong's numbers only
  378.                     1       use transliterated HG word only
  379.                     2       use both word and Strong's number
  380.  
  381.         Bits 14 and 15 are valid only when the Hebrew and Greek 
  382.         Transliterated Bible is being exported.
  383.  
  384. As previously noted, QuickVerse will respond to the WM_DDE_EXECUTE 
  385. messages with a WM_DDE_ACK message.  A positive acknowledgement is 
  386. sent when the command was successful; a negative acknowledgement is 
  387. sent otherwise.  Information about the WM_DDE_ACK message and error 
  388. handling is provided in a following section. 
  389.  
  390. Additional commands may be added in later editions of QuickVerse.  If 
  391. so, these commands will be identified with a new syntax version.  This 
  392. allows a client application to determine which commands are available 
  393. before trying to use one.
  394.  
  395. SPECIFICATION FOR WM_DDE_REQUEST
  396. --------------------------------
  397.  
  398. The WM_DDE_REQUEST message is used to request QV/Win to place the text 
  399. for a specified passage in DDE shared memory that can then be used by 
  400. the client application.  The preferred method of performing this 
  401. activity is with the LoadVerseText execute command discussed above.
  402.  
  403. The DDE conversation must be initiated with an application name of 
  404. "QVWIN" and a topics name of "Verses."  wParam of the WM_DDE_REQUEST 
  405. message is the handle to the DDE client window.  The low word of 
  406. lParam is the requested clipboard format.  CF_TEXT and rich text 
  407. format are supported.  To obtain the rich text format specifier, use 
  408. the RegisterClipboardFormat("Rich Text Format") API.  The high word of 
  409. lParam is an atom containing the requested verse reference or 
  410. references. 
  411.  
  412. In response to this message, QuickVerse will allocate DDE shared 
  413. memory and transfer the text into this memory.  QuickVerse will then 
  414. post a WM_DDE_DATA message.  The low word of lParam contains the 
  415. handle to the DDEDATA memory block.  The values stored in this memory 
  416. block are shown below. 
  417.  
  418.     Field       Value   Explanation
  419.     -------------------------------------------------------------
  420.     fResponse   TRUE    The client application is expected to
  421.                         free the  memory object.
  422.     fRelease    TRUE    This data is offered in response to a
  423.                         WM_DDE_REQUEST message.
  424.     reserved    FALSE   Reserved by Windows.
  425.     fAckReq     TRUE    The client application is expected to
  426.                         send a WM_DDE_ACK message after the
  427.                         WM_DDE_DATA message has been
  428.                         processed.
  429.     cfFormat   CF_TEXT  Format of the data in the value
  430.                         field.
  431.     Value       hMem    Handle to the memory block
  432.                         containing the verse text.
  433.  
  434. The client window is expected to send a WM_DDE_ACK message to 
  435. QuickVerse after the WM_DDE_DATA message has been processed.  If the 
  436. client window does not respond within a specified time period, 
  437. QuickVerse will free the memory blocks it allocated for the 
  438. WM_DDE_DATA message. 
  439.  
  440. If the requested data can not be provided, QuickVerse will respond by 
  441. sending a WM_DDE_ACK message with a negative acknowledgement) instead
  442. of the WM_DDE_DATA message.  See the following section on error 
  443. handling for more details.
  444.  
  445. ERROR HANDLING
  446. --------------
  447.  
  448. The client application can generally rely upon QuickVerse to display 
  449. an error message that describes the error condition.  
  450.  
  451. In addition, QuickVerse responds to all WM_DDE_EXECUTE messages and 
  452. failure conditions for WM_DDE_REQUEST with a WM_DDE_ACK message.  A 
  453. DDEACK structure accompanies the acknowledge message.  This structure 
  454. contains 3 fields of interest:  fAck, fBusy, and bAppReturnCode.  The 
  455. fAck flag contains the acknowledgement.  A positive acknowledgement is 
  456. sent if the command string was completely executed; otherwise a 
  457. negative acknowledgement is sent.  The remaining two fields contain 
  458. information about the failure, since there may be many reasons that 
  459. the commands were not completed. 
  460.  
  461. The client application should not assume that the command was 
  462. unrecognized if a negative acknowledgement was received.  If a 
  463. negative acknowledgement is received, the client application should 
  464. first examine the fBusy flag.  If this flag is set, then QuickVerse 
  465. did not execute the commands because it was busy.  Additionally, the 
  466. bAppReturnCode field may contain additional information about why a 
  467. negative acknowledgement was received.  Since QuickVerse will 
  468. generally display a message to the user when a bona-fide error occurs, 
  469. the client application does not need to examine the application error 
  470. code.  However, it is provided for convenience. 
  471.  
  472. The following application return codes are provided.
  473.  
  474.     bAppReturnCode  Description
  475.     ----------------------------------------------------------------
  476.         0           Additional information about the error source
  477.                     is not provided.
  478.  
  479.         1           Busy.  QuickVerse did not respond because it
  480.                     was busy.  QuickVerse is "busy" when a modal 
  481.                     dialog box is displayed, or when an error message 
  482.                     is displayed, or when QuickVerse is still
  483.                     processing a previous DDE message.
  484.                     Note that the client application should not rely 
  485.                     on this value, but should instead check the fBusy 
  486.                     field to determine if the command failed because 
  487.                     QuickVerse was busy.
  488.  
  489.         2           The DDE message is not supported by QuickVerse.  
  490.                     The WM_DDE_ADVISE is an example of this.
  491.  
  492.         3           An unrecognized execute command was received.
  493.  
  494.         4           The command contained a syntax error or an invalid 
  495.                     parameter.  This code is also returned when the
  496.                     command does not provide a valid memory handle.
  497.  
  498.         5           The operation failed.  This can occur when an
  499.                     active window is required, but not available, or
  500.                     when memory was not available.
  501.  
  502.         6           A system error occurred.  These are rather severe
  503.                     and occur only when a system level activity (such 
  504.                     as atom string retrieval or posting a message)
  505.                     fail.
  506.  
  507.  
  508. *********************************************************************
  509.                         CLIENT SPECIFICATION
  510. *********************************************************************
  511.  
  512. GENERAL METHODOLOGY
  513. -------------------
  514.  
  515. QuickVerse can serve as a DDE client application and pass instructions 
  516. to other applications with the WM_DDE_EXECUTE command.
  517.  
  518. NOTES FOR ALL SERVER APPLICATIONS
  519. ---------------------------------
  520.  
  521. One important note is that QuickVerse expects a WM_DDE_ACK message to 
  522. be received within a specified period after sending the execute 
  523. command.  If the message is not received, QuickVerse will prompt the 
  524. user about whether or not to continue waiting.  The server program
  525. should, therefore, send an acknowledge message promptly.
  526.  
  527. QuickVerse checks the returned acknowledgement for a positive or 
  528. negative acknowledgement, as well as the busy flag as appropriate.  It 
  529. does not check the bAppReturnCode flag.
  530.  
  531. SPECIFICATION FOR THE INTERFACE TO A BIBLE ATLAS
  532. ------------------------------------------------
  533.  
  534. A QuickVerse user can choose the Bible Atlas program that QuickVerse 
  535. interacts with.  While QuickVerse is designed to be used with PC Bible 
  536. Atlas for Windows, any Bible Atlas program that supports the 
  537. following WM_DDE_EXECUTE commands may be used.
  538.  
  539.     Application:    User defined
  540.     Topic name:     Commands
  541.  
  542.                                 Syntax          Program Version
  543.     Item                        Level           Used In
  544.     ------------------------------------------------------------
  545.     [Show("item")]              1               1.0i
  546.     [Activate]                  1               1.0i
  547.     [LoadSyntaxVersion(hmem)]   1               1.0i
  548.  
  549. Refer to the DDE Specification for PC Bible Atlas for Windows for more 
  550. detail regarding these specific commands.
  551.  
  552. SPECIFICATION FOR THE INTERFACE TO A BIBLE DICTIONARY
  553. -----------------------------------------------------
  554.  
  555. A QuickVerse user can choose the dictionary program that QuickVerse 
  556. interacts with.  While QuickVerse is designed to be used with the
  557. Holman Bible Dictionary, and dictionary that supports the following
  558. WM_DDE_EXECUTE commands may be used.
  559.  
  560.     Application:    User defined
  561.     Topic name:     Commands
  562.  
  563.                                 Syntax          Program Version
  564.     Item                        Level           Used In
  565.     ------------------------------------------------------------
  566.     [Show("item")]              1               1.0j
  567.     [ShowVerseRefs("ref")]      1               1.0j
  568.     [Activate]                  1               1.0j
  569.     [LoadSyntaxVersion(hmem)]   1               1.0j
  570.  
  571. Refer to the DDE Specification for the Holman Bible Dictionary
  572. for more detail regarding these specific commands.
  573.  
  574. SPECIFICATION FOR THE INTERFACE TO BIBLE ILLUSTRATOR
  575. ----------------------------------------------------
  576.  
  577. QuickVerse is designed to be used with Bible Illustrator for
  578. Windows, but may be used with any illustration program that
  579. supports the correct syntax.  The following WM_DDE_EXECUTE
  580. commands may be used.
  581.  
  582.     Application:    User defined
  583.     Topic name:     Commands
  584.  
  585.                                 Syntax          Program Version
  586.     Item                        Level           Used In
  587.     ------------------------------------------------------------
  588.     [Show("item")]              1               3.0c
  589.     [ShowVerseRefs("ref")]      1               3.0c
  590.     [Activate]                  1               3.0c
  591.     [LoadSyntaxVersion(hmem)]   1               3.0c
  592.  
  593. Refer to the DDE Specification for Bible Illustrator for more 
  594. detail regarding these specific commands.
  595.  
  596. SPECIFICATION FOR THE INTERFACE TO THE QUICKVERSE LIBRARY
  597. ---------------------------------------------------------
  598.  
  599. QuickVerse is designed to be used with the QuickVerse Library, 
  600. but it can be used with any reference library that supports
  601. the following commands.
  602.  
  603.     Application:    User defined
  604.     Topic name:     Commands
  605.  
  606.                                        Syntax          Program Version
  607.     Item                               Level           Used In
  608.     ------------------------------------------------------------
  609.     [Activate]                         1               3.0j
  610.     [Minimize]                         1               3.0j
  611.     [Synchronize(#,#,#)]               1               3.0j
  612.     [WordSearch("word","language")]    1               3.0j
  613.     [WordSync("word")]                 1               3.0j
  614.     [VerseSearch("ref")]               1               3.0j
  615.     [VerseSync("ref")]                 1               3.0j
  616.  
  617. Refer to the DDE Specification for the QuickVerse Library
  618. for more detail regarding these specific commands.
  619.  
  620.  
  621.