Programmer Guide/Shell Items/DDECONV/NEW DDECONV: Difference between revisions

From STX Wiki
Jump to navigationJump to search
m (1 revision: Initial import)
No edit summary
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
{{DDECONV Item}}
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
==NEW DDECONV==
See [[Programmer_Guide/Shell_Items/DDECONV/SET_DDECONV|SET DDECONV]] for the SET commands and [[Programmer Guide/Shell Items/DDECONV/DDECONV Item Attributes|DDECONV Item Attributes]] for a list of attributes.


See [[User Guide/Waveform Plot and Segmentation/Segment Line Graphs|SET DDECONV]] for the SET commands and [[Programmer Guide/Shell Items/DDECONV/DDECONV Item Attributes|DDECONV Item Attributes]] for a list of attributes.
NEW DDECONV <var>name</var> <var>service</var> <var>topic</var>


<code>NEW DDECONV <var>name</var> <var>service</var> <var>topic</var> [ /G ]</code>
creates a DDE conversation.


Create a DDE conversation.
{| class="keinrahmen"
|-
| <var>name</var>
| The item name of the established conversation.
|-
| <var>service</var>
| The service to connect to (e.g. '<code>Excel</code>').
|-
| <var>topic</var>
| The the topic to connect to (e.g. '<code>System</code>').


;<var>name</var>
If the command fails, check the following: Failure occurs if the application supplying the service is not running, or the topic does not exist. You can check if the topic exists by establishing a conversation with the service on the ''System'' topic and getting the item ''topics'', a tab-delimited list of topics currently available on that server.
 
|-
:The item name of the established conversation.
| <code>/G</code>
 
| Garbage collection. If specified, the item is automatically deleted when exiting the macro.
;<var>service</var>
|}
 
:The service to connect to (e.g. '<code>Excel</code>').
 
;<var>topic</var>
 
:The the topic to connect to (e.g. '<code>System</code>').
 
If the command fails, check the following: Failure occurs if the application supplying the service is not running, or the topic does not exist. You can check if the topic exists by establishing a conversation with the service on the 'System' topic and getting the item 'topics', a tab-delimited list of topics currently available on that server.
 
;<var>/G</var>
 
:Garbage collection. If specified, the item is automatically deleted when exiting the macro.


Example:
Example:

Latest revision as of 07:34, 10 April 2015

DDECONV Item
NEW SET ATTRIBUTES MESSAGES

See SET DDECONV for the SET commands and DDECONV Item Attributes for a list of attributes. 

NEW DDECONV name service topic

creates a DDE conversation.

name The item name of the established conversation.
service The service to connect to (e.g. 'Excel').
topic The the topic to connect to (e.g. 'System').

If the command fails, check the following: Failure occurs if the application supplying the service is not running, or the topic does not exist. You can check if the topic exists by establishing a conversation with the service on the System topic and getting the item topics, a tab-delimited list of topics currently available on that server.

/G Garbage collection. If specified, the item is automatically deleted when exiting the macro.

Example: 

   NEW DDEConv myExcelConv 'Excel' '[stxdata.xls]Sheet1'

Establishes a conversation with Excel on the topic '[stxdata.xls]Sheet1' which is an open file. The shell creates a new ddeconv, adds it to the server, and then connects.

The service (in the example Excel) must already be active/running. Automatic startup of services has not yet been implemented.

Retrieved from "https://mediawiki.kfs.oeaw.ac.at/stx/docs/wiki/index.php?title=Programmer_Guide/Shell_Items/DDECONV/NEW_DDECONV&oldid=7331"

Navigation menu

Personal tools