Please enable JavaScript to view this site.

ESL Documentation

Function

Enumerate all entries in the topics poll list that result from a call to DDEPollTopics.

 

DDEEnumeratePollTopics ( LastTopic_IV )

 

LastTopic_IV is 0 to start, and then is the return value from the previous call.

Description

Called by the client.  This function enumerates all entries in the topics poll list that result from the most recent call to DDEPollTopics.

 

To begin enumeration of the current list, use an argument of 0.  Each subsequent call should pass the value returned by the previous call as the LastTopic_IV argument.  When all entries have been enumerated, the return value is 0.  (You can use the value returned as an argument to DDEGetPollAppName and DDEGetPollTopic.  Do not use the value returned as an argument to any other DDE function or subroutine except DDEEnumeratePollTopics.)

 

Do not call DDEPollTopics while enumerating poll topics, as the results will be unpredictable.

Example

# Display the application names and topics for

# all servers

 

copy 0 to LastTopic_IV

copy DDEPollTopics ("", "") to NumConvs_IV

while (NumConvs_IV > 0) loop

   copy DDEEnumeratePollTopics (LastTopic_IV) to LastTopic_IV

   add to TopicWindow insert at cursor

      DDEGetPollAppName (LastTopic_IV) " "

      DDEGetPollTopic (LastTopic_IV) "\n"

   copy (NumConvs_IV - 1) to NumConvs_IV

end loop