home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv4.zip / VACPP / IBMCPP / HELP / CPPAPP.INF (.txt) < prev    next >
OS/2 Help File  |  1995-05-24  |  223KB  |  10,415 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Application Control Classes ΓòÉΓòÉΓòÉ
  3.  
  4. Provide support for the application, threads, timers, profiles, and the 
  5. resources used by the applications you develop. 
  6.  
  7.  
  8. ΓòÉΓòÉΓòÉ 1.1. Class Hierarchy ΓòÉΓòÉΓòÉ
  9.  
  10. IBase
  11.  Γö£ΓöÇICritSec
  12.  Γö£ΓöÇIHandle
  13.  Γöé  Γö£ΓöÇIContextHandle
  14.  Γöé  Γö£ΓöÇIProcessId
  15.  Γöé  Γö£ΓöÇIProfileHandle
  16.  Γöé  Γö£ΓöÇISemaphoreHandle
  17.  Γöé  ΓööΓöÇIThreadId
  18.  Γö£ΓöÇIProcedureAddress
  19.  Γö£ΓöÇIResourceId
  20.  ΓööΓöÇIVBase
  21.     Γö£ΓöÇIApplication
  22.     Γöé  ΓööΓöÇICurrentApplication
  23.     Γö£ΓöÇIClipboard
  24.     Γö£ΓöÇIClipboard::Cursor
  25.     Γö£ΓöÇIHandler
  26.     Γöé  ΓööΓöÇIClipboardHandler
  27.     Γö£ΓöÇIProfile::Cursor
  28.     Γö£ΓöÇIProfile
  29.     Γö£ΓöÇIRefCounted
  30.     Γöé  Γö£ΓöÇIThreadFn
  31.     Γöé  Γöé  ΓööΓöÇIThreadMemberFn
  32.     Γöé  ΓööΓöÇITimerFn
  33.     Γöé     Γö£ΓöÇITimerMemberFn
  34.     Γöé     ΓööΓöÇITimerMemberFn0
  35.     Γö£ΓöÇIResource
  36.     Γöé  Γö£ΓöÇIPrivateResource
  37.     Γöé  ΓööΓöÇISharedResource
  38.     Γö£ΓöÇIResourceLibrary
  39.     Γöé  ΓööΓöÇIDynamicLinkLibrary
  40.     Γö£ΓöÇIResourceLock
  41.     Γö£ΓöÇIThread
  42.     Γöé  ΓööΓöÇICurrentThread
  43.     Γö£ΓöÇIThread::Cursor
  44.     Γö£ΓöÇITimer
  45.     ΓööΓöÇITimer::Cursor
  46.  
  47.  
  48. ΓòÉΓòÉΓòÉ 1.2. IApplication ΓòÉΓòÉΓòÉ
  49.  
  50. Description 
  51.  
  52. Derivation 
  53.  
  54. Public Functions 
  55.  
  56. Protected Functions 
  57.  
  58. Protected Data 
  59.  
  60. Nested Types 
  61.  
  62. To close all the panels in a chapter, double click on this panel's system menu. 
  63.  
  64.  
  65. ΓòÉΓòÉΓòÉ <hidden> Derivation - IApplication ΓòÉΓòÉΓòÉ
  66.  
  67. IBase
  68.   Γöé
  69. IVBase
  70.   Γöé
  71. IApplication
  72.  
  73. Inherited by: 
  74.  
  75.       ICurrentApplication 
  76.  
  77.  
  78. ΓòÉΓòÉΓòÉ <hidden> Class Description - IApplication ΓòÉΓòÉΓòÉ
  79.  
  80. iapp.hpp 
  81.  
  82. The IApplication class represents processes. The User Interface Class Library 
  83. only supports the currently executing application, the single object of the 
  84. derived class ICurrentApplication. IApplication::current provides access to 
  85. that object. 
  86.  
  87. This class maintains a static pointer to the C++ object representing the 
  88. currently executing application. It does so to implement the static member 
  89. function current, which returns a reference to the ICurrentApplication object. 
  90. The set of functions that you can apply to the current application is different 
  91. from the set of functions you can apply to other applications. 
  92. ICurrentApplication defines these functions. 
  93.  
  94.  
  95. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IApplication ΓòÉΓòÉΓòÉ
  96.  
  97. Diagnostics
  98. asDebugInfo
  99. asString
  100.  
  101. Priority
  102. adjustPriority
  103. setPriority
  104.  
  105. Process Information
  106. current
  107. currentPID
  108. id
  109.  
  110. Inherited Members
  111. IVBase
  112. asDebugInfo
  113. asString
  114.  
  115. IBase
  116. asDebugInfo
  117. asString
  118. messageFile
  119. messageText
  120. setMessageFile
  121. version
  122.  
  123.  
  124. ΓòÉΓòÉΓòÉ <hidden> IApplication - Constructors ΓòÉΓòÉΓòÉ
  125.  
  126. The constructors and destructor for this class are protected.  You must derive 
  127. from this class if you want to use it to represent an application. 
  128.  
  129.  
  130. ΓòÉΓòÉΓòÉ <hidden> IApplication - Diagnostics ΓòÉΓòÉΓòÉ
  131.  
  132. Use these members for diagnostic purposes.  They return an IString 
  133. representation of an object of this class. 
  134.  
  135.  
  136. ΓòÉΓòÉΓòÉ <hidden> IApplication - Priority ΓòÉΓòÉΓòÉ
  137.  
  138. Use these members to control the priority of the application (and its threads). 
  139.  
  140. Note:  While you can set priorities using this class, only threads actually 
  141.        have a priority.  As a result, you need to use functions of the IThread 
  142.        class to query the priority of an application's threads. 
  143.  
  144.  
  145. ΓòÉΓòÉΓòÉ <hidden> IApplication - Process Information ΓòÉΓòÉΓòÉ
  146.  
  147. Use these members to get additional information about a process, such as the 
  148. process identifier, or to access the object for the current process. 
  149.  
  150.  
  151. ΓòÉΓòÉΓòÉ <hidden> IApplication - Setting Process Information ΓòÉΓòÉΓòÉ
  152.  
  153. Use these members to set the information on a process, such as the process 
  154. identifier of this object. 
  155.  
  156.  
  157. ΓòÉΓòÉΓòÉ <hidden> Protected Functions - IApplication ΓòÉΓòÉΓòÉ
  158.  
  159. Constructors
  160. IApplication
  161. ~IApplication
  162.  
  163. Setting Process Information
  164. setId
  165.  
  166.  
  167. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IApplication ΓòÉΓòÉΓòÉ
  168.  
  169. Inherited Members
  170. IBase
  171. recoverable
  172. unrecoverable
  173.  
  174.  
  175. ΓòÉΓòÉΓòÉ 1.2.1. IApplication::adjustPriority ΓòÉΓòÉΓòÉ
  176.  
  177. Adjusts the priority level of all of the application's threads by some amount. 
  178. An optional flag specifies whether the library also modifies the priority of 
  179. descendent processes. 
  180.  
  181. public:
  182. virtual IApplication&
  183.   adjustPriority( long adjustment,
  184.                   Boolean setDescendents = false);
  185.  
  186.  adjustment Long value that represents the adjustment delta. This value must be 
  187.            in the range of -31 to 31. 
  188.  
  189.  setDescendents Boolean that determines whether the library also modifies the 
  190.            priority of descendent processes. 
  191.  
  192.  Platform Support 
  193.  
  194.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  195.   ΓöéPM          ΓöéMOTIF       Γöé
  196.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  197.   ΓöéYes         ΓöéYes         Γöé
  198.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  199.  
  200.  Motif: This member function calls IThread::adjustPriority for the current (and 
  201.  only) thread. The AIX release of the User Interface Class Library does not 
  202.  support multiple threads or thread priorities; thus, IThread::adjustPriority 
  203.  and IApplication::adjustPriority have no effect. 
  204.  
  205.  Exceptions 
  206.  
  207.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  208.   ΓöéIAccessError        ΓöéThe priority was not adjusted.  The     Γöé
  209.   Γöé                    Γöéadjustment delta must be in the range ofΓöé
  210.   Γöé                    Γöé-31 to 31.                              Γöé
  211.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  212.  
  213.  
  214. ΓòÉΓòÉΓòÉ 1.2.2. IApplication::asDebugInfo ΓòÉΓòÉΓòÉ
  215.  
  216. Returns a representation of the application as debug information. The 
  217. representation is returned as an IString with the following contents: 
  218.  
  219. IApplication(IVBase(@addr),id=pid)
  220. This represents the following: 
  221.  
  222.  addr      The address of the object (in hexadecimal). 
  223.  
  224.  pid       The process ID (in hexadecimal). 
  225.  
  226.   public:
  227.   virtual IString asDebugInfo() const;
  228.  
  229.  Platform Support 
  230.  
  231.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  232.   ΓöéPM          ΓöéMOTIF       Γöé
  233.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  234.   ΓöéYes         ΓöéYes         Γöé
  235.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  236.  
  237.  
  238. ΓòÉΓòÉΓòÉ 1.2.3. IApplication::asString ΓòÉΓòÉΓòÉ
  239.  
  240. Returns the string "IApplication(process identifier value)". 
  241.  
  242. public:
  243. virtual IString asString() const;
  244.  
  245. Platform Support 
  246.  
  247. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  248. ΓöéPM          ΓöéMOTIF       Γöé
  249. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  250. ΓöéYes         ΓöéYes         Γöé
  251. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  252.  
  253.  
  254. ΓòÉΓòÉΓòÉ 1.2.4. IApplication::current ΓòÉΓòÉΓòÉ
  255.  
  256. Returns a reference to the current application, which is an object of the class 
  257. ICurrentApplication. 
  258.  
  259. public:
  260. static ICurrentApplication& current();
  261.  
  262. Platform Support 
  263.  
  264. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  265. ΓöéPM          ΓöéMOTIF       Γöé
  266. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  267. ΓöéYes         ΓöéYes         Γöé
  268. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  269.  
  270. Used in samples: 
  271.  
  272.       Hello World Sample - Version 1: ahellow1.cpp 
  273.       Hello World Sample - Version 2: ahellow2.cpp 
  274.       Hello World Sample - Version 3: ahellow3.cpp 
  275.       Hello World Sample - Version 4: ahellow4.cpp 
  276.       Hello World Sample - Version 5: ahellow5.cpp 
  277.  
  278.  
  279. ΓòÉΓòÉΓòÉ 1.2.5. IApplication::currentPID ΓòÉΓòÉΓòÉ
  280.  
  281. Returns the current process identifier value. 
  282.  
  283. public:
  284. static IProcessId currentPID();
  285.  
  286. Platform Support 
  287.  
  288. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  289. ΓöéPM          ΓöéMOTIF       Γöé
  290. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  291. ΓöéYes         ΓöéYes         Γöé
  292. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  293.  
  294.  
  295. ΓòÉΓòÉΓòÉ 1.2.6. IApplication::IApplication ΓòÉΓòÉΓòÉ
  296.  
  297. You can only construct objects of this class with the process identifier for 
  298. the process that the object will represent. 
  299.  
  300. protected:
  301. IApplication(const IProcessId& id);
  302.  
  303.  id        Reference to the process identifier for the process that the object 
  304.            will represent. 
  305.  
  306.  Platform Support 
  307.  
  308.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  309.   ΓöéPM          ΓöéMOTIF       Γöé
  310.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  311.   ΓöéYes         ΓöéYes         Γöé
  312.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  313.  
  314.  
  315. ΓòÉΓòÉΓòÉ 1.2.7. IApplication::id ΓòÉΓòÉΓòÉ
  316.  
  317. Returns this object's process identifier value. 
  318.  
  319. public:
  320. virtual IProcessId id() const;
  321.  
  322. Platform Support 
  323.  
  324. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  325. ΓöéPM          ΓöéMOTIF       Γöé
  326. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  327. ΓöéYes         ΓöéYes         Γöé
  328. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  329.  
  330.  
  331. ΓòÉΓòÉΓòÉ 1.2.8. IApplication::setId ΓòÉΓòÉΓòÉ
  332.  
  333. Sets this object's process identifier.  You call this function in your derived 
  334. class when you start a process in order to save the process identifier for this 
  335. object. 
  336.  
  337. protected:
  338. virtual IApplication& setId(const IProcessId& id);
  339.  
  340.  id        Reference to the process identifier to save. 
  341.  
  342.  Platform Support 
  343.  
  344.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  345.   ΓöéPM          ΓöéMOTIF       Γöé
  346.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  347.   ΓöéYes         ΓöéYes         Γöé
  348.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  349.  
  350.  
  351. ΓòÉΓòÉΓòÉ 1.2.9. IApplication::setPriority ΓòÉΓòÉΓòÉ
  352.  
  353. Sets the priority class and level of all of the application's threads to the 
  354. specified value.  An optional flag specifies whether the library also modifies 
  355. the priority of descendent processes. 
  356.  
  357. public:
  358. virtual IApplication&
  359.   setPriority( PriorityClass priorityClass,
  360.                long priorityLevel = 0,
  361.                Boolean setDescendents = false);
  362.  
  363.  priorityClass Enumeration that identifies the priority class to set. 
  364.  
  365.  priorityLevel Long value that represents the new priority level of all the 
  366.            application's threads for the priority class. This value must be in 
  367.            the range of -31 to 31. 
  368.  
  369.  setDescendents Boolean that determines whether the library also modifies the 
  370.            priority of descendent processes. 
  371.  
  372.  Platform Support 
  373.  
  374.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  375.   ΓöéPM          ΓöéMOTIF       Γöé
  376.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  377.   ΓöéYes         ΓöéYes         Γöé
  378.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  379.  
  380.  Motif: This member function calls IThread::setPriority for the current (and 
  381.  only) thread. The AIX release of the User Interface Class Library does not 
  382.  support multiple threads or thread priorities; thus, IThread::setPriority and 
  383.  IApplication::setPriority have no effect. 
  384.  
  385.  Exceptions 
  386.  
  387.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  388.   ΓöéIAccessError        ΓöéThe priority was not set.  The priority Γöé
  389.   Γöé                    Γöélevel may be invalid.                   Γöé
  390.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  391.  
  392.  
  393. ΓòÉΓòÉΓòÉ 1.2.10. IApplication::~IApplication ΓòÉΓòÉΓòÉ
  394.  
  395. protected:
  396. virtual  ~IApplication();
  397.  
  398. Platform Support 
  399.  
  400. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  401. ΓöéPM          ΓöéMOTIF       Γöé
  402. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  403. ΓöéYes         ΓöéYes         Γöé
  404. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  405.  
  406.  
  407. ΓòÉΓòÉΓòÉ <hidden> Nested Types - IApplication ΓòÉΓòÉΓòÉ
  408.  
  409. Enumerations 
  410.  
  411.        PriorityClass 
  412.  
  413.  
  414. ΓòÉΓòÉΓòÉ <hidden> Enums - PriorityClass ΓòÉΓòÉΓòÉ
  415.  
  416. enum PriorityClass { noChange,
  417.                      idleTime,
  418.                      regular,
  419.                      timeCritical,
  420.                      foregroundServer };
  421.  
  422. These enumerators specify one of the priority classes, such as when using 
  423. setPriority: 
  424.  
  425.  noChange 
  426.       Specifies no change to the thread priority. 
  427.  
  428.  idleTime 
  429.       Specifies the lowest priority. This priority only gets processing time 
  430.       when there is no other work to do. 
  431.  
  432.  regular 
  433.       Specifies the default priority. Most threads belong to this class. 
  434.  
  435.  timeCritical 
  436.       Specifies the highest priority. Use this priority when response time is 
  437.       critical. 
  438.  
  439.  foregroundServer 
  440.       Specifies that a program running on a server takes precedence over other 
  441.       processes on the server. 
  442.  
  443.  Presentation Manager Information For additional information, see the OS/2 2.1 
  444.  Technical Library Programming Guide Volume I.
  445.  
  446.  Motif InformationThe library provides this enumeration for portability 
  447.  purposes only. The AIX release of the User Interface Class Library does not 
  448.  support priority adjustment. 
  449.  
  450.  
  451. ΓòÉΓòÉΓòÉ 1.3. IClipboard ΓòÉΓòÉΓòÉ
  452.  
  453. Description 
  454.  
  455. Derivation 
  456.  
  457. Constructors 
  458.  
  459. Public Functions 
  460.  
  461. Protected Functions 
  462.  
  463. Public Data 
  464.  
  465. Protected Data 
  466.  
  467. Nested Types 
  468.  
  469. Public Data includes Styles and Notification IDs if they exist. 
  470.  
  471. To close all the panels in a chapter, double click on this panel's system menu. 
  472.  
  473.  
  474. ΓòÉΓòÉΓòÉ <hidden> Derivation - IClipboard ΓòÉΓòÉΓòÉ
  475.  
  476. IBase
  477.   Γöé
  478. IVBase
  479.   Γöé
  480. IClipboard
  481.  
  482. Inherited by none. 
  483.  
  484.  
  485. ΓòÉΓòÉΓòÉ <hidden> Class Description - IClipboard ΓòÉΓòÉΓòÉ
  486.  
  487. iclipbrd.hpp 
  488.  
  489. The IClipboard class provides support for writing data to and reading data from 
  490. the system clipboard. While you can only store a single item of data in the 
  491. clipboard, you can store this item in multiple formats. IClipboard predefines 
  492. several system clipboard formats. In addition, any application can create and 
  493. register additional private formats. 
  494.  
  495. Before you can write any data to, or read any data from, the clipboard, you 
  496. first open it. Only a single application at a time can open the clipboard. If 
  497. an application tries to open the clipboard but another application already has 
  498. it open, it waits until the clipboard is available. Therefore, the default 
  499. behavior of the clipboard classes minimizes the time the clipboard is open. 
  500.  
  501. If you use the default behavior of IClipboard, the clipboard functions that 
  502. require an open clipboard, will open it when needed and close it when finished. 
  503. You turn off the default behavior of IClipboard when you explicitly open the 
  504. clipboard by calling IClipboard::open. If you open the clipboard in this 
  505. manner, IClipboard functions will not close the clipboard. If you explicitly 
  506. open the clipboard, close the clipboard by calling IClipboard::close . You can 
  507. turn off the default behavior of IClipboard to place several different formats 
  508. of your data on the clipboard without opening and closing it to write each 
  509. format. 
  510.  
  511. All clipboard operations must be associated with a window. You provide this 
  512. window on the IClipboard constructor. If necessary, IClipboard makes this 
  513. window the owner of the clipboard. The clipboard owner is the window 
  514. responsible for the data put on the clipboard. It is also the window that the 
  515. operating system sends messages to for events relating to the clipboard. The 
  516. IClipboard object establishes this window as the system clipboard owner when 
  517. you call IClipboard::empty. If you call IClipboard::owner before calling empty, 
  518. your window will not be returned because it is not yet the system clipboard 
  519. owner. 
  520.  
  521. You process clipboard events by creating and attaching an IClipboardHandler 
  522. object to your clipboard owner window. In particular, if you use delayed 
  523. rendering, you must attach an IClipboardHandler object to your clipboard's 
  524. window (the owner window). The window dispatcher calls this handler when a 
  525. request is made to the clipboard for data that has not been placed there yet. 
  526.  
  527. Because the clipboard should only be kept open for a short time, create 
  528. IClipboard objects as temporary objects with a short lifetime. This helps 
  529. ensure that the clipboard is only open for the time necessary. 
  530.  
  531. The IClipboard destructor always closes the clipboard if it is still open. 
  532.  
  533.  
  534. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IClipboard ΓòÉΓòÉΓòÉ
  535.  
  536. Clipboard Data Transfer
  537. bitmap
  538. data
  539. hasBitmap
  540. hasData
  541. hasText
  542. setBitmap
  543. setData
  544. setHandle
  545. setText
  546. text
  547.  
  548. Clipboard Formats
  549. format
  550. formatAsHandle
  551. formatCount
  552. primaryFormat
  553. registerFormat
  554.  
  555. Clipboard Ownership
  556. owner
  557.  
  558. Clipboard Setup
  559. close
  560. empty
  561. isOpen
  562. open
  563.  
  564. Constructors
  565. IClipboard
  566. ~IClipboard
  567.  
  568. Inherited Members
  569. IVBase
  570. asDebugInfo
  571. asString
  572.  
  573. IBase
  574. asDebugInfo
  575. asString
  576. messageFile
  577. messageText
  578. setMessageFile
  579. version
  580.  
  581.  
  582. ΓòÉΓòÉΓòÉ <hidden> IClipboard - Clipboard Data Transfer ΓòÉΓòÉΓòÉ
  583.  
  584. These members move data to and from the clipboard. You can request delayed 
  585. rendering of data by calling setText, setBitmap, setHandle, or setData with a 0 
  586. data pointer or handle. For delayed rendering, create an IClipboard handler and 
  587. attach it to the clipboard owner window to process requests to render the data 
  588. when it is needed. Use delayed rendering when you have complex data formats or 
  589. multiple data formats. It allows you to postpone moving the data to the 
  590. clipboard until it is needed. 
  591.  
  592. These members open the clipboard as needed and close it after transferring 
  593. data, unless you have explicitly opened the clipboard by calling open. 
  594.  
  595.  
  596. ΓòÉΓòÉΓòÉ <hidden> IClipboard - Clipboard Formats ΓòÉΓòÉΓòÉ
  597.  
  598. Use these members to register and query the clipboard formats. Register all 
  599. private clipboard formats before using them. 
  600.  
  601.  
  602. ΓòÉΓòÉΓòÉ <hidden> IClipboard - Clipboard Ownership ΓòÉΓòÉΓòÉ
  603.  
  604. The clipboard owner is the window responsible for the data on the clipboard. 
  605. IClipboard::empty establishes the window you provided on the IClipboard 
  606. constructor as the clipboard owner. If you use delayed rendering, attach a 
  607. handler to the clipboard owner window to process the delayed request to put the 
  608. data on the clipboard. 
  609.  
  610.  
  611. ΓòÉΓòÉΓòÉ <hidden> IClipboard - Clipboard Predefined Formats ΓòÉΓòÉΓòÉ
  612.  
  613. IClipboard provides a number of predefined clipboard formats that you can use 
  614. for many standard data formats.  You can use these formats without first 
  615. registering them.  You can also define additional clipboard formats by calling 
  616. registerFormat. before using them. 
  617.  
  618.  
  619. ΓòÉΓòÉΓòÉ <hidden> IClipboard - Clipboard Setup ΓòÉΓòÉΓòÉ
  620.  
  621. The clipboard setup members handle opening and closing the clipboard and 
  622. clearing the initial contents of the clipboard. 
  623.  
  624.  
  625. ΓòÉΓòÉΓòÉ <hidden> IClipboard - Constructors ΓòÉΓòÉΓòÉ
  626.  
  627. Use these members to construct and destruct clipboard objects. 
  628.  
  629.  
  630. ΓòÉΓòÉΓòÉ <hidden> IClipboard - Hidden Members ΓòÉΓòÉΓòÉ
  631.  
  632. IClipboard does not support the copy or assignment of objects. 
  633.  
  634.  
  635. ΓòÉΓòÉΓòÉ <hidden> Protected Functions - IClipboard ΓòÉΓòÉΓòÉ
  636.  
  637. Clipboard Ownership
  638. setOwner
  639.  
  640.  
  641. ΓòÉΓòÉΓòÉ <hidden> Public Data - IClipboard ΓòÉΓòÉΓòÉ
  642.  
  643. Clipboard Predefined Formats
  644. bitmapFormat
  645. displayBitmapFormat
  646. displayMetafileFormat
  647. displayTextFormat
  648. metafileFormat
  649. paletteFormat
  650. textFormat
  651.  
  652.  
  653. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IClipboard ΓòÉΓòÉΓòÉ
  654.  
  655. Inherited Members
  656. IBase
  657. recoverable
  658. unrecoverable
  659.  
  660.  
  661. ΓòÉΓòÉΓòÉ 1.3.1. IClipboard::bitmap ΓòÉΓòÉΓòÉ
  662.  
  663. If data of the format IClipboard::bitmapFormat exists on the clipboard, this 
  664. function creates a copy of the bitmap and returns its IBitmapHandle.  An 
  665. IInvalidRequest exception occurs if the format does not exist on the clipboard. 
  666. You should call the function hasBitmap prior to calling this function to ensure 
  667. that a bitmap exists on the clipboard. 
  668.  
  669. public:
  670. virtual IBitmapHandle bitmap();
  671.  
  672. Platform Support 
  673.  
  674. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  675. ΓöéPM          ΓöéMOTIF       Γöé
  676. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  677. ΓöéYes         ΓöéNo          Γöé
  678. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  679.  
  680.  
  681. ΓòÉΓòÉΓòÉ 1.3.2. IClipboard::bitmapFormat ΓòÉΓòÉΓòÉ
  682.  
  683. Defines a bitmap format for data on the clipboard. 
  684.  
  685. public:
  686. static const char * const * const bitmapFormat;
  687.  
  688. Platform Support 
  689.  
  690. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  691. ΓöéPM          ΓöéMOTIF       Γöé
  692. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  693. ΓöéYes         ΓöéNo          Γöé
  694. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  695.  
  696. Presentation Manager: This format is implemented by the OS/2 format 
  697. SZFMT_BITMAP. 
  698.  
  699.  
  700. ΓòÉΓòÉΓòÉ 1.3.3. IClipboard::close ΓòÉΓòÉΓòÉ
  701.  
  702. Closes the clipboard. 
  703.  
  704. If you manually open the clipboard by calling open , you must also close the 
  705. clipboard when you are finished transferring data. If you do not close the 
  706. clipboard, other applications will wait indefinitely when they try to open the 
  707. clipboard. 
  708.  
  709. public:
  710. virtual IClipboard& close();
  711.  
  712. Platform Support 
  713.  
  714. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  715. ΓöéPM          ΓöéMOTIF       Γöé
  716. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  717. ΓöéYes         ΓöéNo          Γöé
  718. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  719.  
  720. Exceptions 
  721.  
  722. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  723. ΓöéIAccessError        ΓöéThe operating system request to close   Γöé
  724. Γöé                    Γöéthe clipboard failed. See the text of   Γöé
  725. Γöé                    Γöéthe exception for further information.  Γöé
  726. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  727.  
  728.  
  729. ΓòÉΓòÉΓòÉ 1.3.4. IClipboard::data ΓòÉΓòÉΓòÉ
  730.  
  731. Returns a void* value. This value can either be a pointer or handle to the data 
  732. returned from the clipboard. It is your responsibility to know the type of the 
  733. value because it is based on the format of the data. 
  734.  
  735. This function always leaves the clipboard open. You must copy the data before 
  736. closing the clipboard since you lose access to the data after you close the 
  737. clipboard. 
  738.  
  739. public:
  740. virtual void* data(const char* format);
  741.  
  742.  format    A valid clipboard format. 
  743.  
  744.  Platform Support 
  745.  
  746.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  747.   ΓöéPM          ΓöéMOTIF       Γöé
  748.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  749.   ΓöéYes         ΓöéNo          Γöé
  750.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  751.  
  752.  Exceptions 
  753.  
  754.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  755.   ΓöéIInvalidRequest     ΓöéNo data of the requested format exists  Γöé
  756.   Γöé                    Γöéon the clipboard.                       Γöé
  757.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  758.  
  759.  Used in sample:   Container Clipboard Sample: clipbrd.cpp 
  760.  
  761.  
  762. ΓòÉΓòÉΓòÉ 1.3.5. IClipboard::displayBitmapFormat ΓòÉΓòÉΓòÉ
  763.  
  764. Defines a bitmap representation of a private data format for clipboard data 
  765. displayed in a Clipboard Viewer window. The data on the clipboard is identical 
  766. to bitmapFormat. Support this format if you do not support any of the standard 
  767. clipboard formats. 
  768.  
  769. public:
  770. static const char * const * const displayBitmapFormat;
  771.  
  772. Platform Support 
  773.  
  774. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  775. ΓöéPM          ΓöéMOTIF       Γöé
  776. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  777. ΓöéYes         ΓöéNo          Γöé
  778. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  779.  
  780. Presentation Manager: This format is implemented by the OS/2 format 
  781. SZFMT_DSPBITMAP. 
  782.  
  783.  
  784. ΓòÉΓòÉΓòÉ 1.3.6. IClipboard::displayMetafileFormat ΓòÉΓòÉΓòÉ
  785.  
  786. Defines a metafile representation of a private data format displayed in a 
  787. Clipboard Viewer window. The data on the clipboard is identical to 
  788. metafileFormat. Support this format if you do not support any of the standard 
  789. clipboard formats. 
  790.  
  791. public:
  792. static const char * const * const displayMetafileFormat;
  793.  
  794. Platform Support 
  795.  
  796. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  797. ΓöéPM          ΓöéMOTIF       Γöé
  798. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  799. ΓöéYes         ΓöéNo          Γöé
  800. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  801.  
  802. Presentation Manager: This format is implemented by the OS/2 format 
  803. SZFMT_DSPMETAFILE. 
  804.  
  805.  
  806. ΓòÉΓòÉΓòÉ 1.3.7. IClipboard::displayTextFormat ΓòÉΓòÉΓòÉ
  807.  
  808. Defines a text representation of a private data format displayed in a Clipboard 
  809. Viewer window. The data on the clipboard is identical to textFormat. Support 
  810. this format if you do not support any of the standard clipboard formats. 
  811.  
  812. public:
  813. static const char * const * const displayTextFormat;
  814.  
  815. Platform Support 
  816.  
  817. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  818. ΓöéPM          ΓöéMOTIF       Γöé
  819. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  820. ΓöéYes         ΓöéNo          Γöé
  821. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  822.  
  823. Presentation Manager: This format is implemented by the OS/2 format 
  824. SZFMT_DSPTEXT. 
  825.  
  826.  
  827. ΓòÉΓòÉΓòÉ 1.3.8. IClipboard::empty ΓòÉΓòÉΓòÉ
  828.  
  829. Clears the clipboard of all formats of data and establishes the window provided 
  830. on the constructor as the clipboard owner. 
  831.  
  832. This function opens the clipboard if it is not already open. It also closes it 
  833. after use unless you have explicitly opened the clipboard by calling open. 
  834.  
  835. public:
  836. virtual IClipboard& empty();
  837.  
  838. Platform Support 
  839.  
  840. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  841. ΓöéPM          ΓöéMOTIF       Γöé
  842. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  843. ΓöéYes         ΓöéNo          Γöé
  844. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  845.  
  846. Exceptions 
  847.  
  848. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  849. ΓöéIAccessError        ΓöéThe operating system request to empty   Γöé
  850. Γöé                    Γöéthe clipboard failed. See the text of   Γöé
  851. Γöé                    Γöéthe exception for further information.  Γöé
  852. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  853. ΓöéIAccessError        ΓöéThe operating system request to         Γöé
  854. Γöé                    Γöéestablish the owner of the clipboard    Γöé
  855. Γöé                    Γöéfailed.                                 Γöé
  856. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  857.  
  858. Used in sample:   Container Clipboard Sample: clipbrd.cpp 
  859.  
  860.  
  861. ΓòÉΓòÉΓòÉ 1.3.9. IClipboard::format ΓòÉΓòÉΓòÉ
  862.  
  863. Returns the requested clipboard format. Use the returned format to query or set 
  864. data on the clipboard. 
  865.  
  866. Overload 1 
  867.  
  868. public:
  869. static IString format(const FormatHandle& handle);
  870.  
  871. Returns the clipboard format of the format handle. 
  872.  
  873.  handle    The handle of a valid clipboard format. 
  874.  
  875.  Platform Support 
  876.  
  877.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  878.   ΓöéPM          ΓöéMOTIF       Γöé
  879.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  880.   ΓöéYes         ΓöéNo          Γöé
  881.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  882.  
  883.  Exceptions 
  884.  
  885.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  886.   ΓöéIInvalidRequest     ΓöéNo data of the format handle exists on  Γöé
  887.   Γöé                    Γöéthe clipboard. Ensure that the handle isΓöé
  888.   Γöé                    Γöévalid.                                  Γöé
  889.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  890.  
  891.  Overload 2 
  892.  
  893.   public:
  894.   static IString format(const Cursor& cursor);
  895.  
  896.  Returns the format of the data at the cursor location. 
  897.  
  898.  cursor    A valid clipboard cursor. 
  899.  
  900.  Platform Support 
  901.  
  902.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  903.   ΓöéPM          ΓöéMOTIF       Γöé
  904.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  905.   ΓöéYes         ΓöéNo          Γöé
  906.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  907.  
  908.  Exceptions 
  909.  
  910.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  911.   ΓöéIInvalidParameter   ΓöéThe cursor is not valid.                Γöé
  912.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  913.   ΓöéIInvalidRequest     ΓöéNo data of the format indicated by the  Γöé
  914.   Γöé                    Γöécursor exists on the clipboard.         Γöé
  915.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  916.  
  917.  
  918. ΓòÉΓòÉΓòÉ 1.3.10. IClipboard::formatAsHandle ΓòÉΓòÉΓòÉ
  919.  
  920. Returns a clipboard format as a handle. Use this handle to perform clipboard 
  921. operations that are not supported by the IClipboard class. 
  922.  
  923. public:
  924. static FormatHandle formatAsHandle(const char* format);
  925.  
  926.  format    A valid clipboard format. 
  927.  
  928.  Platform Support 
  929.  
  930.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  931.   ΓöéPM          ΓöéMOTIF       Γöé
  932.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  933.   ΓöéYes         ΓöéNo          Γöé
  934.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  935.  
  936.  Exceptions 
  937.  
  938.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  939.   ΓöéIInvalidRequest     ΓöéNo data of the requested format exists  Γöé
  940.   Γöé                    Γöéon the clipboard.                       Γöé
  941.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  942.  
  943.  
  944. ΓòÉΓòÉΓòÉ 1.3.11. IClipboard::formatCount ΓòÉΓòÉΓòÉ
  945.  
  946. Returns the number of clipboard formats in the clipboard. 
  947.  
  948. public:
  949. unsigned long formatCount() const;
  950.  
  951. Platform Support 
  952.  
  953. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  954. ΓöéPM          ΓöéMOTIF       Γöé
  955. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  956. ΓöéYes         ΓöéNo          Γöé
  957. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  958.  
  959.  
  960. ΓòÉΓòÉΓòÉ 1.3.12. IClipboard::hasBitmap ΓòÉΓòÉΓòÉ
  961.  
  962. If the clipboard has data with the format IClipboard::bitmapFormat, returns 
  963. true. 
  964.  
  965. public:
  966. virtual Boolean hasBitmap() const;
  967.  
  968. Platform Support 
  969.  
  970. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  971. ΓöéPM          ΓöéMOTIF       Γöé
  972. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  973. ΓöéYes         ΓöéNo          Γöé
  974. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  975.  
  976.  
  977. ΓòÉΓòÉΓòÉ 1.3.13. IClipboard::hasData ΓòÉΓòÉΓòÉ
  978.  
  979. If the clipboard has data of the requested format, returns true. 
  980.  
  981. public:
  982. virtual Boolean hasData(const char* format) const;
  983.  
  984.  format    A valid clipboard format. 
  985.  
  986.  Platform Support 
  987.  
  988.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  989.   ΓöéPM          ΓöéMOTIF       Γöé
  990.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  991.   ΓöéYes         ΓöéNo          Γöé
  992.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  993.  
  994.  Used in sample:   Container Clipboard Sample: clipbrd.cpp 
  995.  
  996.  
  997. ΓòÉΓòÉΓòÉ 1.3.14. IClipboard::hasText ΓòÉΓòÉΓòÉ
  998.  
  999. If the clipboard has data with the format IClipboard::textFormat, returns true. 
  1000.  
  1001. public:
  1002. virtual Boolean hasText() const;
  1003.  
  1004. Platform Support 
  1005.  
  1006. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1007. ΓöéPM          ΓöéMOTIF       Γöé
  1008. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1009. ΓöéYes         ΓöéNo          Γöé
  1010. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1011.  
  1012.  
  1013. ΓòÉΓòÉΓòÉ 1.3.15. IClipboard::IClipboard ΓòÉΓòÉΓòÉ
  1014.  
  1015. Use these members to construct and destruct clipboard objects. 
  1016.  
  1017. public:
  1018. IClipboard(const IWindowHandle& clipboardWindow);
  1019.  
  1020. Creates clipboard objects. You can construct an IClipboard object by providing 
  1021. the window handle for the object to use for the owner of the clipboard. 
  1022.  
  1023.  clipboardWindow A valid window handle used for clipboard data transfer. If you 
  1024.            call empty , it will establish this window as the owner of the 
  1025.            clipboard. 
  1026.  
  1027.  Platform Support 
  1028.  
  1029.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1030.   ΓöéPM          ΓöéMOTIF       Γöé
  1031.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1032.   ΓöéYes         ΓöéNo          Γöé
  1033.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1034.  
  1035.  Exceptions 
  1036.  
  1037.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1038.   ΓöéIInvalidParameter   ΓöéThe clipboard window handle is not      Γöé
  1039.   Γöé                    Γöévalid.                                  Γöé
  1040.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1041.  
  1042.  Used in sample:   Container Clipboard Sample: clipbrd.cpp 
  1043.  
  1044.  
  1045. ΓòÉΓòÉΓòÉ 1.3.16. IClipboard::isOpen ΓòÉΓòÉΓòÉ
  1046.  
  1047. Returns true if this IClipboard object has opened the clipboard. 
  1048.  
  1049. public:
  1050. virtual Boolean isOpen() const;
  1051.  
  1052. Platform Support 
  1053.  
  1054. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1055. ΓöéPM          ΓöéMOTIF       Γöé
  1056. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1057. ΓöéYes         ΓöéNo          Γöé
  1058. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1059.  
  1060.  
  1061. ΓòÉΓòÉΓòÉ 1.3.17. IClipboard::metafileFormat ΓòÉΓòÉΓòÉ
  1062.  
  1063. Defines a metafile format for data on the clipboard. 
  1064.  
  1065. public:
  1066. static const char * const * const metafileFormat;
  1067.  
  1068. Platform Support 
  1069.  
  1070. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1071. ΓöéPM          ΓöéMOTIF       Γöé
  1072. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1073. ΓöéYes         ΓöéNo          Γöé
  1074. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1075.  
  1076. Presentation Manager: This format is implemented by the OS/2 format 
  1077. SZFMT_METAFILE. 
  1078.  
  1079.  
  1080. ΓòÉΓòÉΓòÉ 1.3.18. IClipboard::open ΓòÉΓòÉΓòÉ
  1081.  
  1082. Opens the clipboard. 
  1083.  
  1084. This function prevents other threads or processes from changing or examining 
  1085. the contents of the clipboard. Therefore, only keep the clipboard open for the 
  1086. time needed to place data on or remove data from the clipboard. 
  1087.  
  1088. All IClipboard functions open the clipboard when needed. Unless you call this 
  1089. function to open the clipboard, they also close the clipboard when they are 
  1090. finished transferring data. Therefore, if you use this function to open the 
  1091. clipboard you must also explicitly close the clipboard by calling close. 
  1092.  
  1093. public:
  1094. virtual IClipboard& open();
  1095.  
  1096. Platform Support 
  1097.  
  1098. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1099. ΓöéPM          ΓöéMOTIF       Γöé
  1100. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1101. ΓöéYes         ΓöéNo          Γöé
  1102. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1103.  
  1104. Exceptions 
  1105.  
  1106. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1107. ΓöéIAccessError        ΓöéThe operating system request to open theΓöé
  1108. Γöé                    Γöéclipboard failed. See the exception textΓöé
  1109. Γöé                    Γöéfor further information about the       Γöé
  1110. Γöé                    Γöéfailure.                                Γöé
  1111. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1112.  
  1113.  
  1114. ΓòÉΓòÉΓòÉ 1.3.19. IClipboard::owner ΓòÉΓòÉΓòÉ
  1115.  
  1116. Returns the current clipboard owner window.  The owner of the clipboard is 
  1117. established when the clipboard is emptied.  If you have provided a clipboard 
  1118. window on the IClipboard constructor but have not yet emptied the clipboard, 
  1119. this function does not return your owner window unless your owner window was 
  1120. already the clipboard owner. 
  1121.  
  1122. public:
  1123. IWindowHandle owner() const;
  1124.  
  1125. Platform Support 
  1126.  
  1127. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1128. ΓöéPM          ΓöéMOTIF       Γöé
  1129. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1130. ΓöéYes         ΓöéNo          Γöé
  1131. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1132.  
  1133.  
  1134. ΓòÉΓòÉΓòÉ 1.3.20. IClipboard::paletteFormat ΓòÉΓòÉΓòÉ
  1135.  
  1136. Defines a palette format for data on the clipboard. 
  1137.  
  1138. public:
  1139. static const char * const * const paletteFormat;
  1140.  
  1141. Platform Support 
  1142.  
  1143. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1144. ΓöéPM          ΓöéMOTIF       Γöé
  1145. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1146. ΓöéYes         ΓöéNo          Γöé
  1147. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1148.  
  1149. Presentation Manager: This format is implemented by the OS/2 format 
  1150. SZFMT_PALETTE. 
  1151.  
  1152.  
  1153. ΓòÉΓòÉΓòÉ 1.3.21. IClipboard::primaryFormat ΓòÉΓòÉΓòÉ
  1154.  
  1155. Returns the primary format of the data on the clipboard. The primary format is 
  1156. the first format you place on the clipboard after you call empty. An 
  1157. IInvalidRequest results if there is no data on the clipboard. 
  1158.  
  1159. public:
  1160. static IString primaryFormat();
  1161.  
  1162. Platform Support 
  1163.  
  1164. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1165. ΓöéPM          ΓöéMOTIF       Γöé
  1166. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1167. ΓöéYes         ΓöéNo          Γöé
  1168. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1169.  
  1170.  
  1171. ΓòÉΓòÉΓòÉ 1.3.22. IClipboard::registerFormat ΓòÉΓòÉΓòÉ
  1172.  
  1173. Registers privateFormat as a private format and returns its format handle. 
  1174.  
  1175. public:
  1176. static FormatHandle
  1177.   registerFormat( const char* privateFormat);
  1178.  
  1179.  privateFormat The text string that identifies your private clipboard format. 
  1180.  
  1181.  Platform Support 
  1182.  
  1183.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1184.   ΓöéPM          ΓöéMOTIF       Γöé
  1185.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1186.   ΓöéYes         ΓöéNo          Γöé
  1187.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1188.  
  1189.  Exceptions 
  1190.  
  1191.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1192.   ΓöéIAccessError        ΓöéThe operating system request to registerΓöé
  1193.   Γöé                    Γöéthe format failed. See the exception    Γöé
  1194.   Γöé                    Γöétext provided with the exception for    Γöé
  1195.   Γöé                    Γöéfurther details about the failure.      Γöé
  1196.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1197.  
  1198.  Used in sample:   Container Clipboard Sample: clipbrd.cpp 
  1199.  
  1200.  
  1201. ΓòÉΓòÉΓòÉ 1.3.23. IClipboard::setBitmap ΓòÉΓòÉΓòÉ
  1202.  
  1203. Copies the passed bitmap and places the handle on the clipboard with the format 
  1204. IClipboard::bitmapFormat. 
  1205.  
  1206. This function opens the clipboard if it is not already open. It also closes it 
  1207. after placing the bitmap on the clipboard unless you have explicitly opened the 
  1208. clipboard by calling open. 
  1209.  
  1210. public:
  1211. virtual IClipboard& setBitmap(const IBitmapHandle& bitmap);
  1212.  
  1213.  bitmap    The handle of a valid bitmap. 
  1214.  
  1215.  Platform Support 
  1216.  
  1217.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1218.   ΓöéPM          ΓöéMOTIF       Γöé
  1219.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1220.   ΓöéYes         ΓöéNo          Γöé
  1221.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1222.  
  1223.  
  1224. ΓòÉΓòÉΓòÉ 1.3.24. IClipboard::setData ΓòÉΓòÉΓòÉ
  1225.  
  1226. Copies the passed data buffer and places it on the clipboard with the format 
  1227. specified. Register any private formats, before placing data of the indicated 
  1228. format on the clipboard by calling registerFormat . If the pointer to the data 
  1229. is 0, create an IClipboardHandler object to process requests to render the 
  1230. data. 
  1231.  
  1232. This function opens the clipboard if it is not already open. It also closes it 
  1233. after placing the data on the clipboard unless you have explicitly opened the 
  1234. clipboard by calling open. 
  1235.  
  1236. public:
  1237. virtual IClipboard&
  1238.   setData( const char* format,
  1239.            const void* data,
  1240.            unsigned long dataLength);
  1241.  
  1242.  format    A valid clipboard format. 
  1243.  
  1244.  data      A pointer to a buffer containing the data of the indicated format. 
  1245.  
  1246.  dataLength The length of the buffer stored in the data argument. 
  1247.  
  1248.  Platform Support 
  1249.  
  1250.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1251.   ΓöéPM          ΓöéMOTIF       Γöé
  1252.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1253.   ΓöéYes         ΓöéNo          Γöé
  1254.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1255.  
  1256.  Exceptions 
  1257.  
  1258.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1259.   ΓöéIAccessError        ΓöéThe operating system request to acquire Γöé
  1260.   Γöé                    Γöéshared storage failed.                  Γöé
  1261.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1262.   ΓöéIAccessError        ΓöéThe operating system request to put the Γöé
  1263.   Γöé                    Γöédata on the clipboard failed.           Γöé
  1264.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1265.  
  1266.  Used in sample:   Container Clipboard Sample: clipbrd.cpp 
  1267.  
  1268.  
  1269. ΓòÉΓòÉΓòÉ 1.3.25. IClipboard::setHandle ΓòÉΓòÉΓòÉ
  1270.  
  1271. Makes handle shareable (so that it can be accessed by other processes), and 
  1272. places it on the clipboard. Use this function to copy bitmaps and metafiles to 
  1273. the clipboard. setBitmap uses this function to place the bitmap on the 
  1274. clipboard. 
  1275.  
  1276. This function opens the clipboard if it is not already open. It also closes it 
  1277. after placing the handle on the clipboard unless you have explicitly opened the 
  1278. clipboard by calling open. 
  1279.  
  1280. public:
  1281. virtual IClipboard&
  1282.   setHandle( const char* format,
  1283.              unsigned long handle);
  1284.  
  1285.  format    A valid clipboard format. 
  1286.  
  1287.  handle    A handle to the object identified by the format parameter. 
  1288.  
  1289.  Platform Support 
  1290.  
  1291.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1292.   ΓöéPM          ΓöéMOTIF       Γöé
  1293.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1294.   ΓöéYes         ΓöéNo          Γöé
  1295.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1296.  
  1297.  Exceptions 
  1298.  
  1299.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1300.   ΓöéIAccessError        ΓöéThe operating system request to place   Γöé
  1301.   Γöé                    Γöéthe handle on the clipboard failed.     Γöé
  1302.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1303.  
  1304.  
  1305. ΓòÉΓòÉΓòÉ 1.3.26. IClipboard::setOwner ΓòÉΓòÉΓòÉ
  1306.  
  1307. Establishes the owner of the clipboard. The owner of the clipboard controls the 
  1308. data on the clipboard and is responsible for responding to clipboard messages 
  1309. to render clipboard data. empty calls this function to establish the clipboard 
  1310. window you provide on the IClipboard constructor as the clipboard owner. 
  1311.  
  1312. protected:
  1313. virtual IClipboard& setOwner();
  1314.  
  1315. Platform Support 
  1316.  
  1317. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1318. ΓöéPM          ΓöéMOTIF       Γöé
  1319. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1320. ΓöéYes         ΓöéNo          Γöé
  1321. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1322.  
  1323. Exceptions 
  1324.  
  1325. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1326. ΓöéIAccessError        ΓöéThe operating system request to update  Γöé
  1327. Γöé                    Γöéthe owner window failed. See the        Γöé
  1328. Γöé                    Γöéexception text for further details of   Γöé
  1329. Γöé                    Γöéthe failure.                            Γöé
  1330. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1331.  
  1332.  
  1333. ΓòÉΓòÉΓòÉ 1.3.27. IClipboard::setText ΓòÉΓòÉΓòÉ
  1334.  
  1335. Copies text and places it on the clipboard with the format 
  1336. IClipboard::textFormat. 
  1337.  
  1338. This function opens the clipboard if it is not already open. It also closes it 
  1339. after placing the text on the clipboard unless you have explicitly opened the 
  1340. clipboard by calling open. 
  1341.  
  1342. public:
  1343. virtual IClipboard& setText(const char* text);
  1344.  
  1345.  text      A null-terminated character string. 
  1346.  
  1347.  Platform Support 
  1348.  
  1349.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1350.   ΓöéPM          ΓöéMOTIF       Γöé
  1351.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1352.   ΓöéYes         ΓöéNo          Γöé
  1353.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1354.  
  1355.  Used in sample:   Container Clipboard Sample: clipbrd.cpp 
  1356.  
  1357.  
  1358. ΓòÉΓòÉΓòÉ 1.3.28. IClipboard::text ΓòÉΓòÉΓòÉ
  1359.  
  1360. Returns IClipboard::textFormat data as an IString object. 
  1361.  
  1362. If IClipboard::textFormat data exists on the clipboard, it returns the data as 
  1363. an IString object.  An IInvalidRequest exception occurs if the format does not 
  1364. exist on the clipboard. Call hasText before calling this function to ensure 
  1365. that text exists on the clipboard. 
  1366.  
  1367. This function opens the clipboard if it is not already open. It also closes it 
  1368. after retrieving the text from the clipboard unless you have explicitly opened 
  1369. the clipboard by calling open. 
  1370.  
  1371. public:
  1372. virtual IString text();
  1373.  
  1374. Platform Support 
  1375.  
  1376. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1377. ΓöéPM          ΓöéMOTIF       Γöé
  1378. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1379. ΓöéYes         ΓöéNo          Γöé
  1380. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1381.  
  1382.  
  1383. ΓòÉΓòÉΓòÉ 1.3.29. IClipboard::textFormat ΓòÉΓòÉΓòÉ
  1384.  
  1385. Defines a text format for data on the clipboard. The data is an array of text 
  1386. characters with a terminating null character. 
  1387.  
  1388. public:
  1389. static const char * const textFormat;
  1390.  
  1391. Platform Support 
  1392.  
  1393. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1394. ΓöéPM          ΓöéMOTIF       Γöé
  1395. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1396. ΓöéYes         ΓöéNo          Γöé
  1397. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1398.  
  1399. Presentation Manager: This format is implemented by the OS/2 format SZFMT_TEXT. 
  1400.  
  1401.  
  1402. ΓòÉΓòÉΓòÉ 1.3.30. IClipboard::~IClipboard ΓòÉΓòÉΓòÉ
  1403.  
  1404. Calls close to close the clipboard if it is open. 
  1405.  
  1406. public:
  1407. virtual  ~IClipboard();
  1408.  
  1409. Platform Support 
  1410.  
  1411. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1412. ΓöéPM          ΓöéMOTIF       Γöé
  1413. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1414. ΓöéYes         ΓöéNo          Γöé
  1415. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1416.  
  1417.  
  1418. ΓòÉΓòÉΓòÉ <hidden> Nested Types - IClipboard ΓòÉΓòÉΓòÉ
  1419.  
  1420. Classes 
  1421.  
  1422.        IClipboard::Cursor 
  1423.  
  1424.  Type Definitions 
  1425.  
  1426.        FormatHandle 
  1427.  
  1428.  
  1429. ΓòÉΓòÉΓòÉ <hidden> Type Definition - IClipboard::FormatHandle ΓòÉΓòÉΓòÉ
  1430.  
  1431. typedef unsigned long FormatHandle;
  1432.  
  1433. A FormatHandle is a unique number (typically an atom) used by the operating 
  1434. system to identify a clipboard format. 
  1435.  
  1436.  
  1437. ΓòÉΓòÉΓòÉ 1.4. IClipboard::Cursor ΓòÉΓòÉΓòÉ
  1438.  
  1439. Description 
  1440.  
  1441. Derivation 
  1442.  
  1443. Constructors 
  1444.  
  1445. Public Functions 
  1446.  
  1447. Protected Data 
  1448.  
  1449. To close all the panels in a chapter, double click on this panel's system menu. 
  1450.  
  1451.  
  1452. ΓòÉΓòÉΓòÉ <hidden> Derivation - IClipboard::Cursor ΓòÉΓòÉΓòÉ
  1453.  
  1454. IBase
  1455.   Γöé
  1456. IVBase
  1457.   Γöé
  1458. IClipboard::Cursor
  1459.  
  1460. Inherited by none. 
  1461.  
  1462.  
  1463. ΓòÉΓòÉΓòÉ <hidden> Class Description - IClipboard::Cursor ΓòÉΓòÉΓòÉ
  1464.  
  1465. iclipbrd.hpp 
  1466.  
  1467. The IClipboard::Cursor class is a nested cursor class used to iterate through 
  1468. the available formats of data in the clipboard. Unlike many other cursor 
  1469. classes, IClipboard::Cursor only supports movement in a forward direction. When 
  1470. you use a cursor loop like the one in the following example, the clipboard 
  1471. formats are returned in the same order that they were added. 
  1472.  
  1473.   // Iterate over clipboard formats...
  1474.   IClipboard clipboard(mleHandle);
  1475.   IClipboard::Cursor(clipboard);
  1476.   for ( cursor.setToFirst(); cursor.isValid(); cursor.setToNext() )
  1477.     { // Do something with each format
  1478.       cout << "The format is: " << clipboard.format(cursor);
  1479.     }
  1480.  
  1481.  
  1482. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IClipboard::Cursor ΓòÉΓòÉΓòÉ
  1483.  
  1484. Constructors
  1485. Cursor
  1486. ~Cursor
  1487.  
  1488. Cursor Movement
  1489. setToFirst
  1490. setToNext
  1491.  
  1492. Cursor Validation
  1493. invalidate
  1494. isValid
  1495.  
  1496. Inherited Members
  1497. IVBase
  1498. asDebugInfo
  1499. asString
  1500.  
  1501. IBase
  1502. asDebugInfo
  1503. asString
  1504. messageFile
  1505. messageText
  1506. setMessageFile
  1507. version
  1508.  
  1509.  
  1510. ΓòÉΓòÉΓòÉ <hidden> IClipboard::Cursor - Constructors ΓòÉΓòÉΓòÉ
  1511.  
  1512. You can construct objects of this class from a reference to the window whose 
  1513. child windows are iterated.  You can also destruct objects of this class. 
  1514.  
  1515.  
  1516. ΓòÉΓòÉΓòÉ <hidden> IClipboard::Cursor - Cursor Movement ΓòÉΓòÉΓòÉ
  1517.  
  1518. You use the cursor movement members to position the clipboard cursor. 
  1519.  
  1520.  
  1521. ΓòÉΓòÉΓòÉ <hidden> IClipboard::Cursor - Cursor Validation ΓòÉΓòÉΓòÉ
  1522.  
  1523. You use the cursor validation members to determine if the clipboard cursor is 
  1524. valid or to indicate that it is no longer valid. 
  1525.  
  1526.  
  1527. ΓòÉΓòÉΓòÉ <hidden> IClipboard::Cursor - Hidden Members ΓòÉΓòÉΓòÉ
  1528.  
  1529. The IClipboard::Cursor class does not support copying or assigning clipboard 
  1530. cursors. 
  1531.  
  1532.  
  1533. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IClipboard::Cursor ΓòÉΓòÉΓòÉ
  1534.  
  1535. Inherited Members
  1536. IBase
  1537. recoverable
  1538. unrecoverable
  1539.  
  1540.  
  1541. ΓòÉΓòÉΓòÉ 1.4.1. IClipboard::Cursor::Cursor ΓòÉΓòÉΓòÉ
  1542.  
  1543. You can construct objects of this class from a reference to an IClipboard 
  1544. object. 
  1545.  
  1546. public:
  1547. Cursor(IClipboard& clipboard);
  1548.  
  1549.  clipboard Reference to a clipboard object. 
  1550.  
  1551.  Platform Support 
  1552.  
  1553.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1554.   ΓöéPM          ΓöéMOTIF       Γöé
  1555.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1556.   ΓöéYes         ΓöéNo          Γöé
  1557.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1558.  
  1559.  
  1560. ΓòÉΓòÉΓòÉ 1.4.2. IClipboard::Cursor::invalidate ΓòÉΓòÉΓòÉ
  1561.  
  1562. Puts the cursor in an invalid state. 
  1563.  
  1564. public:
  1565. virtual void invalidate();
  1566.  
  1567. Platform Support 
  1568.  
  1569. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1570. ΓöéPM          ΓöéMOTIF       Γöé
  1571. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1572. ΓöéYes         ΓöéNo          Γöé
  1573. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1574.  
  1575.  
  1576. ΓòÉΓòÉΓòÉ 1.4.3. IClipboard::Cursor::isValid ΓòÉΓòÉΓòÉ
  1577.  
  1578. If the cursor is valid, returns true. 
  1579.  
  1580. public:
  1581. virtual Boolean isValid() const;
  1582.  
  1583. Platform Support 
  1584.  
  1585. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1586. ΓöéPM          ΓöéMOTIF       Γöé
  1587. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1588. ΓöéYes         ΓöéNo          Γöé
  1589. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1590.  
  1591.  
  1592. ΓòÉΓòÉΓòÉ 1.4.4. IClipboard::Cursor::setToFirst ΓòÉΓòÉΓòÉ
  1593.  
  1594. Positions the cursor on the first format in the clipboard. 
  1595.  
  1596. public:
  1597. virtual Boolean setToFirst();
  1598.  
  1599. Platform Support 
  1600.  
  1601. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1602. ΓöéPM          ΓöéMOTIF       Γöé
  1603. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1604. ΓöéYes         ΓöéNo          Γöé
  1605. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1606.  
  1607.  
  1608. ΓòÉΓòÉΓòÉ 1.4.5. IClipboard::Cursor::setToNext ΓòÉΓòÉΓòÉ
  1609.  
  1610. Positions the cursor on the next format in the clipboard. If you call setToNext 
  1611. before calling setToFirst, it positions the cursor on the first format in the 
  1612. clipboard. 
  1613.  
  1614. public:
  1615. virtual Boolean setToNext();
  1616.  
  1617. Platform Support 
  1618.  
  1619. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1620. ΓöéPM          ΓöéMOTIF       Γöé
  1621. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1622. ΓöéYes         ΓöéNo          Γöé
  1623. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1624.  
  1625.  
  1626. ΓòÉΓòÉΓòÉ 1.4.6. IClipboard::Cursor::~Cursor ΓòÉΓòÉΓòÉ
  1627.  
  1628. public:
  1629. virtual  ~Cursor();
  1630.  
  1631. Platform Support 
  1632.  
  1633. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1634. ΓöéPM          ΓöéMOTIF       Γöé
  1635. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1636. ΓöéYes         ΓöéNo          Γöé
  1637. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1638.  
  1639.  
  1640. ΓòÉΓòÉΓòÉ 1.5. IClipboardHandler ΓòÉΓòÉΓòÉ
  1641.  
  1642. Description 
  1643.  
  1644. Derivation 
  1645.  
  1646. Constructors 
  1647.  
  1648. Public Functions 
  1649.  
  1650. Protected Functions 
  1651.  
  1652. Protected Data 
  1653.  
  1654. To close all the panels in a chapter, double click on this panel's system menu. 
  1655.  
  1656.  
  1657. ΓòÉΓòÉΓòÉ <hidden> Derivation - IClipboardHandler ΓòÉΓòÉΓòÉ
  1658.  
  1659. IBase
  1660.   Γöé
  1661. IVBase
  1662.   Γöé
  1663. IHandler
  1664.   Γöé
  1665. IClipboardHandler
  1666.  
  1667. Inherited by none. 
  1668.  
  1669.  
  1670. ΓòÉΓòÉΓòÉ <hidden> Class Description - IClipboardHandler ΓòÉΓòÉΓòÉ
  1671.  
  1672. icliphdr.hpp 
  1673.  
  1674. The IClipboardHandler class processes the events that the clipboard sends to 
  1675. its owner.  This includes requests to render clipboard data for formats that 
  1676. were put on the clipboard with delayed rendering. 
  1677.  
  1678. The handler processes these events by creating an IEvent object and routing it 
  1679. to the appropriate virtual function.  The virtual function allows you to supply 
  1680. your own specialized processing of the event.  The return values from the 
  1681. virtual function specify whether the clipboard event is passed on to another 
  1682. handler object to be processed, as follows: 
  1683.  
  1684.  Value     Meaning 
  1685.  
  1686.  true      The IEvent has been handled and requires no additional processing. 
  1687.  
  1688.  false     The IEvent is passed to the next handler, as follows: 
  1689.  
  1690.                If there is another handler for the window, the event is passed 
  1691.                 on to the next handler. 
  1692.  
  1693.                If this is the last handler for the window, the event is passed 
  1694.                 on a call to the window's defaultProcedure function. 
  1695.  
  1696.  
  1697. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IClipboardHandler ΓòÉΓòÉΓòÉ
  1698.  
  1699. Constructors
  1700. IClipboardHandler
  1701. ~IClipboardHandler
  1702.  
  1703. Inherited Members
  1704. IHandler
  1705. asDebugInfo
  1706. asString
  1707. disable
  1708. enable
  1709. handleEventsFor
  1710. isEnabled
  1711. stopHandlingEventsFor
  1712.  
  1713. IVBase
  1714. asDebugInfo
  1715. asString
  1716.  
  1717. IBase
  1718. asDebugInfo
  1719. asString
  1720. messageFile
  1721. messageText
  1722. setMessageFile
  1723. version
  1724.  
  1725.  
  1726. ΓòÉΓòÉΓòÉ <hidden> IClipboardHandler - Constructors ΓòÉΓòÉΓòÉ
  1727.  
  1728. Use these members to construct and destruct clipboard handler objects. 
  1729.  
  1730.  
  1731. ΓòÉΓòÉΓòÉ <hidden> IClipboardHandler - Event Dispatching ΓòÉΓòÉΓòÉ
  1732.  
  1733. Event dispatching members evaluate the event to determine if it is appropriate 
  1734. for this handler object to process.  If it is, the member calls the virtual 
  1735. function used to process the event. 
  1736.  
  1737.  
  1738. ΓòÉΓòÉΓòÉ <hidden> IClipboardHandler - Event Processing ΓòÉΓòÉΓòÉ
  1739.  
  1740. These members are pure virtual functions that derived classes must implement. 
  1741. There is no default behavior for these functions. 
  1742.  
  1743.  
  1744. ΓòÉΓòÉΓòÉ <hidden> Protected Functions - IClipboardHandler ΓòÉΓòÉΓòÉ
  1745.  
  1746. Event Dispatching
  1747. dispatchHandlerEvent
  1748.  
  1749. Event Processing
  1750. clipboardEmptied
  1751. renderAllFormats
  1752. renderFormat
  1753.  
  1754. Inherited Members
  1755. IHandler
  1756. defaultProcedure
  1757. dispatchHandlerEvent
  1758.  
  1759.  
  1760. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IClipboardHandler ΓòÉΓòÉΓòÉ
  1761.  
  1762. Inherited Members
  1763. IBase
  1764. recoverable
  1765. unrecoverable
  1766.  
  1767.  
  1768. ΓòÉΓòÉΓòÉ 1.5.1. IClipboardHandler::clipboardEmptied ΓòÉΓòÉΓòÉ
  1769.  
  1770. Called when the current clipboard owner needs to clean up data in the clipboard 
  1771. because another application window has requested ownership by clearing the data 
  1772. in the clipboard. 
  1773.  
  1774. protected:
  1775. virtual Boolean clipboardEmptied(IEvent& event) = 0;
  1776.  
  1777.  event     Reference to an event object. 
  1778.  
  1779.  Platform Support 
  1780.  
  1781.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1782.   ΓöéPM          ΓöéMOTIF       Γöé
  1783.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1784.   ΓöéYes         ΓöéNo          Γöé
  1785.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1786.  
  1787.  
  1788. ΓòÉΓòÉΓòÉ 1.5.2. IClipboardHandler::dispatchHandlerEvent ΓòÉΓòÉΓòÉ
  1789.  
  1790. Calls the appropriate virtual function to process clipboard events. 
  1791.  
  1792. protected:
  1793. virtual Boolean dispatchHandlerEvent(IEvent& event);
  1794.  
  1795.  event     Reference to an event object. 
  1796.  
  1797.  Platform Support 
  1798.  
  1799.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1800.   ΓöéPM          ΓöéMOTIF       Γöé
  1801.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1802.   ΓöéYes         ΓöéNo          Γöé
  1803.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1804.  
  1805.  
  1806. ΓòÉΓòÉΓòÉ 1.5.3. IClipboardHandler::IClipboardHandler ΓòÉΓòÉΓòÉ
  1807.  
  1808. Creates IClipboardHandler objects. Construct objects of this class only by 
  1809. using the default constructor, which does not take any arguments. 
  1810.  
  1811. public:
  1812. IClipboardHandler();
  1813.  
  1814. Platform Support 
  1815.  
  1816. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1817. ΓöéPM          ΓöéMOTIF       Γöé
  1818. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1819. ΓöéYes         ΓöéNo          Γöé
  1820. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1821.  
  1822.  
  1823. ΓòÉΓòÉΓòÉ 1.5.4. IClipboardHandler::renderAllFormats ΓòÉΓòÉΓòÉ
  1824.  
  1825. Implemented by derived classes to render the data for all formats with delayed 
  1826. rendering.  Place the data for all delayed formats into the clipboard with 
  1827. calls to setText, setBitmap, setMetafile, and setData. 
  1828.  
  1829. Note:  Do not open the clipboard during the processing of this function as you 
  1830. can hang the system.  You can put data on the clipboard during the processing 
  1831. of this function without explicitly opening the clipboard. 
  1832.  
  1833. protected:
  1834. virtual Boolean renderAllFormats(IEvent& event) = 0;
  1835.  
  1836.  event     Reference to an event object. 
  1837.  
  1838.  Platform Support 
  1839.  
  1840.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1841.   ΓöéPM          ΓöéMOTIF       Γöé
  1842.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1843.   ΓöéYes         ΓöéNo          Γöé
  1844.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1845.  
  1846.  
  1847. ΓòÉΓòÉΓòÉ 1.5.5. IClipboardHandler::renderFormat ΓòÉΓòÉΓòÉ
  1848.  
  1849. Implemented by derived classes to render the data for a format with delayed 
  1850. rendering. Place data into the clipboard with setText, setBitmap, or setData. 
  1851.  
  1852. Note:  Do not open the clipboard during the processing of this function as you 
  1853. can hang the system. You can put data on the clipboard during the processing of 
  1854. this function without explicitly opening the clipboard. 
  1855.  
  1856. protected:
  1857. virtual Boolean
  1858.   renderFormat( IEvent& event,
  1859.                 const IString& format) = 0;
  1860.  
  1861.  event     Reference to an event object. 
  1862.  
  1863.  format    A valid clipboard format. 
  1864.  
  1865.  Platform Support 
  1866.  
  1867.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1868.   ΓöéPM          ΓöéMOTIF       Γöé
  1869.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1870.   ΓöéYes         ΓöéNo          Γöé
  1871.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1872.  
  1873.  
  1874. ΓòÉΓòÉΓòÉ 1.5.6. IClipboardHandler::~IClipboardHandler ΓòÉΓòÉΓòÉ
  1875.  
  1876. public:
  1877. virtual  ~IClipboardHandler();
  1878.  
  1879. Platform Support 
  1880.  
  1881. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1882. ΓöéPM          ΓöéMOTIF       Γöé
  1883. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1884. ΓöéYes         ΓöéNo          Γöé
  1885. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1886.  
  1887.  
  1888. ΓòÉΓòÉΓòÉ 1.6. IContextHandle ΓòÉΓòÉΓòÉ
  1889.  
  1890. Description 
  1891.  
  1892. Derivation 
  1893.  
  1894. Constructors 
  1895.  
  1896. Public Functions 
  1897.  
  1898. Protected Data 
  1899.  
  1900. To close all the panels in a chapter, double click on this panel's system menu. 
  1901.  
  1902.  
  1903. ΓòÉΓòÉΓòÉ <hidden> Derivation - IContextHandle ΓòÉΓòÉΓòÉ
  1904.  
  1905. IBase
  1906.   Γöé
  1907. IHandle
  1908.   Γöé
  1909. IContextHandle
  1910.  
  1911. Inherited by none. 
  1912.  
  1913.  
  1914. ΓòÉΓòÉΓòÉ <hidden> Class Description - IContextHandle ΓòÉΓòÉΓòÉ
  1915.  
  1916. ihandle.hpp 
  1917.  
  1918. Objects of the IContextHandle class access and manage the application context. 
  1919.  
  1920. Motif Information 
  1921.  
  1922. IContextHandle is an alias for the X Toolkit type XtAppContext. 
  1923.  
  1924.  
  1925. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IContextHandle ΓòÉΓòÉΓòÉ
  1926.  
  1927. Constructors
  1928. IContextHandle
  1929.  
  1930. Operators
  1931. operator _XtAppStruct *
  1932.  
  1933. Inherited Members
  1934. IHandle
  1935. asDebugInfo
  1936. asString
  1937. asUnsigned
  1938. operator Value
  1939.  
  1940. IBase
  1941. asDebugInfo
  1942. asString
  1943. messageFile
  1944. messageText
  1945. setMessageFile
  1946. version
  1947.  
  1948.  
  1949. ΓòÉΓòÉΓòÉ <hidden> IContextHandle - Constructors ΓòÉΓòÉΓòÉ
  1950.  
  1951. You can construct objects of this class. 
  1952.  
  1953.  
  1954. ΓòÉΓòÉΓòÉ <hidden> IContextHandle - Operators ΓòÉΓòÉΓòÉ
  1955.  
  1956. This operator allows you to use IContextHandle where an XtAppContext structure 
  1957. is expected. 
  1958.  
  1959.  
  1960. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IContextHandle ΓòÉΓòÉΓòÉ
  1961.  
  1962. Inherited Members
  1963. IHandle
  1964. handle
  1965.  
  1966. IBase
  1967. recoverable
  1968. unrecoverable
  1969.  
  1970.  
  1971. ΓòÉΓòÉΓòÉ 1.6.1. IContextHandle::IContextHandle ΓòÉΓòÉΓòÉ
  1972.  
  1973. You can construct objects of this class from an XtAppContext (a value of type 
  1974. IHandle::Value), which defaults to 0. 
  1975.  
  1976. public:
  1977. IContextHandle(_XtAppStruct* value = 0);
  1978.  
  1979. Platform Support 
  1980.  
  1981. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1982. ΓöéPM          ΓöéMOTIF       Γöé
  1983. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  1984. ΓöéNo          ΓöéYes         Γöé
  1985. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  1986.  
  1987.  
  1988. ΓòÉΓòÉΓòÉ 1.6.2. IContextHandle::operator _XtAppStruct * ΓòÉΓòÉΓòÉ
  1989.  
  1990. Returns the IContextHandle value. 
  1991.  
  1992. public:
  1993. operator _XtAppStruct *() const;
  1994.  
  1995. Platform Support 
  1996.  
  1997. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  1998. ΓöéPM          ΓöéMOTIF       Γöé
  1999. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2000. ΓöéNo          ΓöéYes         Γöé
  2001. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2002.  
  2003.  
  2004. ΓòÉΓòÉΓòÉ 1.7. ICritSec ΓòÉΓòÉΓòÉ
  2005.  
  2006. Description 
  2007.  
  2008. Derivation 
  2009.  
  2010. Constructors 
  2011.  
  2012. Public Functions 
  2013.  
  2014. Public Data 
  2015.  
  2016. Protected Data 
  2017.  
  2018. Public Data includes Styles and Notification IDs if they exist. 
  2019.  
  2020. To close all the panels in a chapter, double click on this panel's system menu. 
  2021.  
  2022.  
  2023. ΓòÉΓòÉΓòÉ <hidden> Derivation - ICritSec ΓòÉΓòÉΓòÉ
  2024.  
  2025. IBase
  2026.   Γöé
  2027. ICritSec
  2028.  
  2029. Inherited by none. 
  2030.  
  2031.  
  2032. ΓòÉΓòÉΓòÉ <hidden> Class Description - ICritSec ΓòÉΓòÉΓòÉ
  2033.  
  2034. icritsec.hpp 
  2035.  
  2036. The ICritSec class isolates blocks of code you consider to be critical 
  2037. sections. Such blocks usually manipulate static data and need to do so without 
  2038. interruption from code that is executing in other threads. 
  2039.  
  2040. Objects of this class guarantee that no other thread in the current process 
  2041. executes between the object's construction and destruction. 
  2042.  
  2043. Typically, code that must execute without interruption by other threads is 
  2044. partitioned into a separate block, delimited by braces ({}). You create an 
  2045. object of this class within that block. 
  2046.  
  2047. Note:  While the critical section is executing, avoid actions having the 
  2048.        potential to interrupt it, such as system calls. If you must preserve 
  2049.        locks beyond the scope of a critical section object, use semaphores as 
  2050.        implemented by the class IResourceLock. 
  2051.  
  2052.  Motif Information 
  2053.  
  2054.  Use this class to temporarily block signals from the current process. The 
  2055.  constructor sets the process signal mask to block all maskable signals except 
  2056.  SIGTRAP. SIGTRAP is not masked to allow debug tracing through a critical 
  2057.  section. The destructor restores the process signal mask to the value it had 
  2058.  before creation of the object. 
  2059.  
  2060.  Because signals are masked, some services might not operate correctly inside a 
  2061.  critical section. An example of this is timer signals. If you attempt to lock 
  2062.  an ISharedResource inside a critical section, any timeout you specify will be 
  2063.  ineffective because the timer signal is masked. 
  2064.  
  2065.  
  2066. ΓòÉΓòÉΓòÉ <hidden> Public Functions - ICritSec ΓòÉΓòÉΓòÉ
  2067.  
  2068. Constructors
  2069. ICritSec
  2070. ~ICritSec
  2071.  
  2072. Inherited Members
  2073. IBase
  2074. asDebugInfo
  2075. asString
  2076. messageFile
  2077. messageText
  2078. setMessageFile
  2079. version
  2080.  
  2081.  
  2082. ΓòÉΓòÉΓòÉ <hidden> ICritSec - Constructors ΓòÉΓòÉΓòÉ
  2083.  
  2084. Use these members to construct and destruct objects of this class. The 
  2085. constructor and destructor implement all of the function of this class.  The 
  2086. constructor causes a critical section to be entered. The corresponding 
  2087. destructor exits the critical section. 
  2088.  
  2089.  
  2090. ΓòÉΓòÉΓòÉ <hidden> ICritSec - Diagnostics ΓòÉΓòÉΓòÉ
  2091.  
  2092. Use these members for diagnostic purposes.  They contain additional information 
  2093. on the critical section. 
  2094.  
  2095.  
  2096. ΓòÉΓòÉΓòÉ <hidden> ICritSec - Hidden Members ΓòÉΓòÉΓòÉ
  2097.  
  2098. You cannot access these members. 
  2099.  
  2100.  
  2101. ΓòÉΓòÉΓòÉ <hidden> Public Data - ICritSec ΓòÉΓòÉΓòÉ
  2102.  
  2103. Diagnostics
  2104. count
  2105.  
  2106.  
  2107. ΓòÉΓòÉΓòÉ <hidden> Protected Data - ICritSec ΓòÉΓòÉΓòÉ
  2108.  
  2109. Inherited Members
  2110. IBase
  2111. recoverable
  2112. unrecoverable
  2113.  
  2114.  
  2115. ΓòÉΓòÉΓòÉ 1.7.1. ICritSec::count ΓòÉΓòÉΓòÉ
  2116.  
  2117. Tracks the total number of critical sections entered but not yet exited.  It is 
  2118. equivalent to the number of ICritSec objects in existence. 
  2119.  
  2120. public:
  2121. static unsigned long count;
  2122.  
  2123. Platform Support 
  2124.  
  2125. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2126. ΓöéPM          ΓöéMOTIF       Γöé
  2127. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2128. ΓöéYes         ΓöéYes         Γöé
  2129. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2130.  
  2131.  
  2132. ΓòÉΓòÉΓòÉ 1.7.2. ICritSec::ICritSec ΓòÉΓòÉΓòÉ
  2133.  
  2134. Use these members to construct and destruct objects of this class. The 
  2135. constructor and destructor implement all of the function of this class.  The 
  2136. constructor causes a critical section to be entered. The corresponding 
  2137. destructor exits the critical section. 
  2138.  
  2139. public:
  2140. ICritSec();
  2141.  
  2142. Creates a critical section object, and enters a critical section within the 
  2143. block of code where you create the object. 
  2144.  
  2145. Platform Support 
  2146.  
  2147. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2148. ΓöéPM          ΓöéMOTIF       Γöé
  2149. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2150. ΓöéYes         ΓöéYes         Γöé
  2151. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2152.  
  2153.  
  2154. ΓòÉΓòÉΓòÉ 1.7.3. ICritSec::~ICritSec ΓòÉΓòÉΓòÉ
  2155.  
  2156. Exits a critical section within the block of code where you create the critical 
  2157. section object and deletes the object. 
  2158.  
  2159. public:
  2160. ~ICritSec();
  2161.  
  2162. Platform Support 
  2163.  
  2164. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2165. ΓöéPM          ΓöéMOTIF       Γöé
  2166. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2167. ΓöéYes         ΓöéYes         Γöé
  2168. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2169.  
  2170.  
  2171. ΓòÉΓòÉΓòÉ 1.8. ICurrentApplication ΓòÉΓòÉΓòÉ
  2172.  
  2173. Description 
  2174.  
  2175. Derivation 
  2176.  
  2177. Public Functions 
  2178.  
  2179. Protected Functions 
  2180.  
  2181. Protected Data 
  2182.  
  2183. To close all the panels in a chapter, double click on this panel's system menu. 
  2184.  
  2185.  
  2186. ΓòÉΓòÉΓòÉ <hidden> Derivation - ICurrentApplication ΓòÉΓòÉΓòÉ
  2187.  
  2188. IBase
  2189.   Γöé
  2190. IVBase
  2191.   Γöé
  2192. IApplication
  2193.   Γöé
  2194. ICurrentApplication
  2195.  
  2196. Inherited by none. 
  2197.  
  2198.  
  2199. ΓòÉΓòÉΓòÉ <hidden> Class Description - ICurrentApplication ΓòÉΓòÉΓòÉ
  2200.  
  2201. iapp.hpp 
  2202.  
  2203. The ICurrentApplication class represents the program that is currently running. 
  2204. You are limited to a single object of this class. To obtain a reference to the 
  2205. object, use the static function IApplication::current. The object of this class 
  2206. contains information that the User Interface Class Library maintains for each 
  2207. running application. 
  2208.  
  2209.  
  2210. ΓòÉΓòÉΓòÉ <hidden> Public Functions - ICurrentApplication ΓòÉΓòÉΓòÉ
  2211.  
  2212. Arguments
  2213. argc
  2214. argv
  2215. setArgs
  2216.  
  2217. Diagnostics
  2218. asDebugInfo
  2219.  
  2220. Resource Libraries
  2221. resourceLibrary
  2222. setResourceLibrary
  2223. setUserResourceLibrary
  2224. userResourceLibrary
  2225.  
  2226. Starting and Stopping
  2227. exit
  2228. run
  2229.  
  2230. Inherited Members
  2231. IApplication
  2232. adjustPriority
  2233. asDebugInfo
  2234. asString
  2235. current
  2236. currentPID
  2237. id
  2238. setPriority
  2239.  
  2240. IVBase
  2241. asDebugInfo
  2242. asString
  2243.  
  2244. IBase
  2245. asDebugInfo
  2246. asString
  2247. messageFile
  2248. messageText
  2249. setMessageFile
  2250. version
  2251.  
  2252.  
  2253. ΓòÉΓòÉΓòÉ <hidden> ICurrentApplication - Arguments ΓòÉΓòÉΓòÉ
  2254.  
  2255. Use these members to access or set the program arguments that can be passed to 
  2256. a program when it is executed. 
  2257.  
  2258.  
  2259. ΓòÉΓòÉΓòÉ <hidden> ICurrentApplication - Constructors ΓòÉΓòÉΓòÉ
  2260.  
  2261. The constructors of this class are protected to ensure that the static function 
  2262. IApplication::current returns the correct reference to the only object of this 
  2263. class.  Also, the destructor is protected. 
  2264.  
  2265.  
  2266. ΓòÉΓòÉΓòÉ <hidden> ICurrentApplication - Diagnostics ΓòÉΓòÉΓòÉ
  2267.  
  2268. Use these members for diagnostic purposes.  They return an IString 
  2269. representation of an object of this class. 
  2270.  
  2271.  
  2272. ΓòÉΓòÉΓòÉ <hidden> ICurrentApplication - Process Information ΓòÉΓòÉΓòÉ
  2273.  
  2274. Use these members to access process information. 
  2275.  
  2276.  
  2277. ΓòÉΓòÉΓòÉ <hidden> ICurrentApplication - Resource Libraries ΓòÉΓòÉΓòÉ
  2278.  
  2279. Use these members to access the user's default application resource library and 
  2280. the User Interface Class Library resource library. 
  2281.  
  2282.  
  2283. ΓòÉΓòÉΓòÉ <hidden> ICurrentApplication - Starting and Stopping ΓòÉΓòÉΓòÉ
  2284.  
  2285. Use these members to start or stop the current process. 
  2286.  
  2287.  
  2288. ΓòÉΓòÉΓòÉ <hidden> Protected Functions - ICurrentApplication ΓòÉΓòÉΓòÉ
  2289.  
  2290. Constructors
  2291. ICurrentApplication
  2292. ~ICurrentApplication
  2293.  
  2294. Process Information
  2295. pib
  2296.  
  2297. Inherited Members
  2298. IApplication
  2299. setId
  2300.  
  2301.  
  2302. ΓòÉΓòÉΓòÉ <hidden> Protected Data - ICurrentApplication ΓòÉΓòÉΓòÉ
  2303.  
  2304. Inherited Members
  2305. IBase
  2306. recoverable
  2307. unrecoverable
  2308.  
  2309.  
  2310. ΓòÉΓòÉΓòÉ 1.8.1. ICurrentApplication::argc ΓòÉΓòÉΓòÉ
  2311.  
  2312. Obtains the number of application arguments. 
  2313.  
  2314. public:
  2315. virtual int argc() const;
  2316.  
  2317. Platform Support 
  2318.  
  2319. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2320. ΓöéPM          ΓöéMOTIF       Γöé
  2321. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2322. ΓöéYes         ΓöéYes         Γöé
  2323. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2324.  
  2325.  
  2326. ΓòÉΓòÉΓòÉ 1.8.2. ICurrentApplication::argv ΓòÉΓòÉΓòÉ
  2327.  
  2328. Obtains the specified argument that is passed to the application. 
  2329.  
  2330. public:
  2331. virtual IString argv(int argumentNumber) const;
  2332.  
  2333.  argumentNumber Integer value that represents the specified argument. 
  2334.  
  2335.  Platform Support 
  2336.  
  2337.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2338.   ΓöéPM          ΓöéMOTIF       Γöé
  2339.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2340.   ΓöéYes         ΓöéYes         Γöé
  2341.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2342.  
  2343.  
  2344. ΓòÉΓòÉΓòÉ 1.8.3. ICurrentApplication::asDebugInfo ΓòÉΓòÉΓòÉ
  2345.  
  2346. Use this function to return a diagnostic representation of the object. The 
  2347. information that is returned is 
  2348.  
  2349.      User Interface Class Library resource library name 
  2350.      User-defined resource library name 
  2351.      Number of arguments 
  2352.      Argument list 
  2353.  
  2354.   public:
  2355.   virtual IString asDebugInfo() const;
  2356.  
  2357.  Platform Support 
  2358.  
  2359.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2360.   ΓöéPM          ΓöéMOTIF       Γöé
  2361.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2362.   ΓöéYes         ΓöéYes         Γöé
  2363.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2364.  
  2365.  Presentation Manager: A pointer to the process information block is also 
  2366.  returned as an unsigned long value. 
  2367.  
  2368.  
  2369. ΓòÉΓòÉΓòÉ 1.8.4. ICurrentApplication::exit ΓòÉΓòÉΓòÉ
  2370.  
  2371. Ends the current thread of execution. If the current thread is thread 1, the 
  2372. process is ended. 
  2373.  
  2374. public:
  2375. virtual ICurrentApplication& exit();
  2376.  
  2377. Platform Support 
  2378.  
  2379. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2380. ΓöéPM          ΓöéMOTIF       Γöé
  2381. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2382. ΓöéYes         ΓöéYes         Γöé
  2383. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2384.  
  2385.  
  2386. ΓòÉΓòÉΓòÉ 1.8.5. ICurrentApplication::ICurrentApplication ΓòÉΓòÉΓòÉ
  2387.  
  2388. You can only construct objects of this class with the default constructor, 
  2389. which does not require any arguments. 
  2390.  
  2391. protected:
  2392. ICurrentApplication();
  2393.  
  2394. Platform Support 
  2395.  
  2396. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2397. ΓöéPM          ΓöéMOTIF       Γöé
  2398. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2399. ΓöéYes         ΓöéYes         Γöé
  2400. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2401.  
  2402.  
  2403. ΓòÉΓòÉΓòÉ 1.8.6. ICurrentApplication::pib ΓòÉΓòÉΓòÉ
  2404.  
  2405. Returns a pointer to the current process' process information block. 
  2406.  
  2407. protected:
  2408. struct pib_s& pib();
  2409.  
  2410. Platform Support 
  2411.  
  2412. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2413. ΓöéPM          ΓöéMOTIF       Γöé
  2414. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2415. ΓöéYes         ΓöéNo          Γöé
  2416. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2417.  
  2418.  
  2419. ΓòÉΓòÉΓòÉ 1.8.7. ICurrentApplication::resourceLibrary ΓòÉΓòÉΓòÉ
  2420.  
  2421. Obtains a reference to the User Interface Class Library's resource library. 
  2422. Resources required by the base library code are loaded from this resource 
  2423. library. If ICurrentApplication::setResourceLibrary has been called with the 
  2424. name of a dynamic link library (DLL), the handle of this library is returned. 
  2425. Otherwise, the environment variable ICLUI RESLIB is checked for the name of a 
  2426. DLL, and its handle is returned. You can set the environment variable using the 
  2427. statement SET ICLUI RESLIB=myappdll from an operating system command line. 
  2428.  
  2429. public:
  2430. virtual IResourceLibrary& resourceLibrary() const;
  2431.  
  2432. Platform Support 
  2433.  
  2434. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2435. ΓöéPM          ΓöéMOTIF       Γöé
  2436. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2437. ΓöéYes         ΓöéYes         Γöé
  2438. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2439.  
  2440. Presentation Manager: If you call ICurrentApplication::setResourceLibrary with 
  2441. the name of a dynamic link library (DLL), the handle of this library is 
  2442. returned. Otherwise, the library checks the environment variable ICLUI RESLIB 
  2443. for the name of a DLL, and its handle is returned. 
  2444.  
  2445. Set the environment variable by using the following: 
  2446.  
  2447. SET ICLUI RESLIB=myappdll
  2448.  
  2449. If you have not set the environment variable, the default User Interface Class 
  2450. Library resource DLL, cppoor3u.dll, is used. 
  2451.  
  2452.  
  2453. ΓòÉΓòÉΓòÉ 1.8.8. ICurrentApplication::run ΓòÉΓòÉΓòÉ
  2454.  
  2455. Starts the processing of events in the current process. 
  2456.  
  2457. public:
  2458. virtual ICurrentApplication& run();
  2459.  
  2460. Platform Support 
  2461.  
  2462. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2463. ΓöéPM          ΓöéMOTIF       Γöé
  2464. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2465. ΓöéYes         ΓöéYes         Γöé
  2466. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2467.  
  2468. Used in samples: 
  2469.  
  2470.       Hello World Sample - Version 1: ahellow1.cpp 
  2471.       Hello World Sample - Version 2: ahellow2.cpp 
  2472.       Hello World Sample - Version 3: ahellow3.cpp 
  2473.       Hello World Sample - Version 4: ahellow4.cpp 
  2474.       Hello World Sample - Version 5: ahellow5.cpp 
  2475.  
  2476.  
  2477. ΓòÉΓòÉΓòÉ 1.8.9. ICurrentApplication::setArgs ΓòÉΓòÉΓòÉ
  2478.  
  2479. Sets the program arguments. Call this member function from your application's 
  2480. main function, passing its argc and argv argument values. 
  2481.  
  2482. public:
  2483. virtual ICurrentApplication&
  2484.   setArgs( int argc,
  2485.            const char * const argv [ ]);
  2486.  
  2487.  argc      Integer value that states the number of arguments. 
  2488.  
  2489.  argv      Pointer to an array of arguments. 
  2490.  
  2491.  Platform Support 
  2492.  
  2493.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2494.   ΓöéPM          ΓöéMOTIF       Γöé
  2495.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2496.   ΓöéYes         ΓöéYes         Γöé
  2497.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2498.  
  2499.  
  2500. ΓòÉΓòÉΓòÉ 1.8.10. ICurrentApplication::setResourceLibrary ΓòÉΓòÉΓòÉ
  2501.  
  2502. Sets the resource library from which the User Interface Class Library's 
  2503. resources are loaded. You specify the resource library as the name of the 
  2504. dynamic link library (DLL) without the file extension.  If you pass a 0 instead 
  2505. of a DLL name, the resources are loaded from the application's executable file. 
  2506.  
  2507. Note:  When you rename the User Interface Class Library resource DLL, 
  2508. cppoor3u.dll, to ship with your application (per the licensing agreement), you 
  2509. should call this function to specify the new resource DLL name. 
  2510.  
  2511. public:
  2512. virtual ICurrentApplication&
  2513.   setResourceLibrary( const char* resLibName);
  2514.  
  2515.  resLibName Pointer to the resource library name. 
  2516.  
  2517.  Platform Support 
  2518.  
  2519.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2520.   ΓöéPM          ΓöéMOTIF       Γöé
  2521.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2522.   ΓöéYes         ΓöéYes         Γöé
  2523.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2524.  
  2525.  Presentation Manager: You must specify the resource library as the name of the 
  2526.  dynamic link library without the file extension. If you specify 0, the 
  2527.  application loads the resources from the application's executable file. 
  2528.  
  2529.  Motif: The AIX environment uses the standard X resource database; therefore, 
  2530.  this function has no effect. 
  2531.  
  2532.  
  2533. ΓòÉΓòÉΓòÉ 1.8.11. ICurrentApplication::setUserResourceLibrary ΓòÉΓòÉΓòÉ
  2534.  
  2535. Sets the user resource library from which you obtain application resources. The 
  2536. default is the executable file. 
  2537.  
  2538. Note:  You can use an argument of 0 for resLibName parameter to reset the user 
  2539.        resource library to the executable file. 
  2540.  
  2541.   public:
  2542.   virtual ICurrentApplication&
  2543.     setUserResourceLibrary( const char* resLibName);
  2544.  
  2545.  resLibName Pointer to the resource library name. 
  2546.  
  2547.  Platform Support 
  2548.  
  2549.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2550.   ΓöéPM          ΓöéMOTIF       Γöé
  2551.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2552.   ΓöéYes         ΓöéYes         Γöé
  2553.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2554.  
  2555.  Presentation Manager: The default is IResourceId. If you specify 0 for 
  2556.  resLibName, the application uses the executable file. 
  2557.  
  2558.  Motif: The AIX environment uses the standard X resource database; therefore, 
  2559.  this function has no effect. 
  2560.  
  2561.  Used in sample:   List Box Sample: alistbox.cpp 
  2562.  
  2563.  
  2564. ΓòÉΓòÉΓòÉ 1.8.12. ICurrentApplication::userResourceLibrary ΓòÉΓòÉΓòÉ
  2565.  
  2566. Obtains a reference to the default user resource library for this application. 
  2567. The default is the executable file. If you do not explicitly specify a resource 
  2568. library, IResourceId uses this resource library. 
  2569.  
  2570. public:
  2571. virtual IResourceLibrary& userResourceLibrary() const;
  2572.  
  2573. Platform Support 
  2574.  
  2575. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2576. ΓöéPM          ΓöéMOTIF       Γöé
  2577. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2578. ΓöéYes         ΓöéYes         Γöé
  2579. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2580.  
  2581. Used in samples: 
  2582.  
  2583.       List Box Sample: alistbox.cpp 
  2584.       Multi-Line Entry Field Sample: amle.cpp 
  2585.       Container Sample: acnr.cpp 
  2586.       Multi Cell Canvas Sample: amcelcv.cpp 
  2587.       Lancelot - A Valiant Example: lmainwin.cpp 
  2588.  
  2589.  
  2590. ΓòÉΓòÉΓòÉ 1.8.13. ICurrentApplication::~ICurrentApplication ΓòÉΓòÉΓòÉ
  2591.  
  2592. protected:
  2593. virtual  ~ICurrentApplication();
  2594.  
  2595. Platform Support 
  2596.  
  2597. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2598. ΓöéPM          ΓöéMOTIF       Γöé
  2599. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2600. ΓöéYes         ΓöéYes         Γöé
  2601. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2602.  
  2603.  
  2604. ΓòÉΓòÉΓòÉ 1.9. ICurrentThread ΓòÉΓòÉΓòÉ
  2605.  
  2606. Description 
  2607.  
  2608. Derivation 
  2609.  
  2610. Public Functions 
  2611.  
  2612. Protected Functions 
  2613.  
  2614. Protected Data 
  2615.  
  2616. To close all the panels in a chapter, double click on this panel's system menu. 
  2617.  
  2618.  
  2619. ΓòÉΓòÉΓòÉ <hidden> Derivation - ICurrentThread ΓòÉΓòÉΓòÉ
  2620.  
  2621. IBase
  2622.   Γöé
  2623. IVBase
  2624.   Γöé
  2625. IThread
  2626.   Γöé
  2627. ICurrentThread
  2628.  
  2629. Inherited by none. 
  2630.  
  2631.  
  2632. ΓòÉΓòÉΓòÉ <hidden> Class Description - ICurrentThread ΓòÉΓòÉΓòÉ
  2633.  
  2634. ithread.hpp 
  2635.  
  2636. The ICurrentThread class represents the current thread of execution. An object 
  2637. of this class contains information that the User Interface Class Library 
  2638. maintains for the current thread of execution.  You are limited to a single 
  2639. object of this class. 
  2640.  
  2641. This class provides functions that you can only apply to the current thread of 
  2642. execution.  To obtain a reference to the object, use the static function 
  2643. IThread::current. 
  2644.  
  2645.  
  2646. ΓòÉΓòÉΓòÉ <hidden> Public Functions - ICurrentThread ΓòÉΓòÉΓòÉ
  2647.  
  2648. Current Thread Information
  2649. id
  2650.  
  2651. Current Thread Support
  2652. exit
  2653. isTopLevelShell
  2654. isXerrorCodeAvailable
  2655. remainingStack
  2656. sleep
  2657. waitFor
  2658. waitForAllThreads
  2659. waitForAnyThread
  2660.  
  2661. Graphical User Interface (GUI) Support
  2662. anchorBlock
  2663. appContext
  2664. appShell
  2665. initializeGUI
  2666. isGUIInitialized
  2667. messageQueue
  2668. processMsgs
  2669. terminateGUI
  2670.  
  2671. Implementation
  2672. setTopLevelShell
  2673. setXerrorCode
  2674. XerrorCode
  2675.  
  2676. Suspending Threads
  2677. suspend
  2678.  
  2679. Inherited Members
  2680. IThread
  2681. adjustPriority
  2682. asDebugInfo
  2683. asString
  2684. autoInitGUI
  2685. current
  2686. currentId
  2687. defaultAutoInitGUI
  2688. defaultQueueSize
  2689. defaultStackSize
  2690. id
  2691. isStarted
  2692. messageQueue
  2693. priorityClass
  2694. priorityLevel
  2695. queueSize
  2696. relatedHandlesList
  2697. resume
  2698. setAutoInitGUI
  2699. setDefaultAutoInitGUI
  2700. setDefaultQueueSize
  2701. setDefaultStackSize
  2702. setPriority
  2703. setQueueSize
  2704. setRelatedHandlesList
  2705. setStackSize
  2706. setVariable
  2707. setWindowList
  2708. stackSize
  2709. start
  2710. stop
  2711. stopProcessingMsgs
  2712. suspend
  2713. variable
  2714. windowList
  2715.  
  2716. IVBase
  2717. asDebugInfo
  2718. asString
  2719.  
  2720. IBase
  2721. asDebugInfo
  2722. asString
  2723. messageFile
  2724. messageText
  2725. setMessageFile
  2726. version
  2727.  
  2728.  
  2729. ΓòÉΓòÉΓòÉ <hidden> ICurrentThread - Constructors ΓòÉΓòÉΓòÉ
  2730.  
  2731. Use these protected constructors to construct objects of this class. 
  2732.  
  2733.  
  2734. ΓòÉΓòÉΓòÉ <hidden> ICurrentThread - Current Thread Information ΓòÉΓòÉΓòÉ
  2735.  
  2736. Use these members to access general information on the current thread. 
  2737.  
  2738.  
  2739. ΓòÉΓòÉΓòÉ <hidden> ICurrentThread - Current Thread Support ΓòÉΓòÉΓòÉ
  2740.  
  2741. Use these members to enable thread operations that only apply to the current 
  2742. thread. 
  2743.  
  2744.  
  2745. ΓòÉΓòÉΓòÉ <hidden> ICurrentThread - Graphical User Interface (GUI) Support ΓòÉΓòÉΓòÉ
  2746.  
  2747. Use these members to support GUI activities on the current thread. 
  2748.  
  2749.  
  2750. ΓòÉΓòÉΓòÉ <hidden> ICurrentThread - Hidden Members ΓòÉΓòÉΓòÉ
  2751.  
  2752. You cannot access these members. 
  2753.  
  2754.  
  2755. ΓòÉΓòÉΓòÉ <hidden> ICurrentThread - Implementation ΓòÉΓòÉΓòÉ
  2756.  
  2757. These members provide utilities used to implement this class.  They are used by 
  2758. the User Interface Class Library. 
  2759.  
  2760.  
  2761. ΓòÉΓòÉΓòÉ <hidden> ICurrentThread - Obsolete Members ΓòÉΓòÉΓòÉ
  2762.  
  2763. Use these members to provide basic OS/2 Presentation Manager (PM) support for 
  2764. the current thread. 
  2765.  
  2766. Note:  Please note that these members are obsolete, and have been replaced with 
  2767.        new members due to portability requirements.  These new members are 
  2768.        described in the group, Graphical User Interface (GUI) Support  We 
  2769.        provide you with the name of the new member you should be using in the 
  2770.        documentation for each of the members in this group. 
  2771.  
  2772.  
  2773. ΓòÉΓòÉΓòÉ <hidden> ICurrentThread - Suspending Threads ΓòÉΓòÉΓòÉ
  2774.  
  2775. Use these members to suspend your current thread of execution, if the thread is 
  2776. a non-GUI thread.  Use IThread::resume to resume execution of the thread. 
  2777.  
  2778.  
  2779. ΓòÉΓòÉΓòÉ <hidden> Protected Functions - ICurrentThread ΓòÉΓòÉΓòÉ
  2780.  
  2781. Constructors
  2782. ICurrentThread
  2783.  
  2784. Implementation
  2785. startedThread
  2786.  
  2787. Inherited Members
  2788. IThread
  2789. newStartedThread
  2790. operator =
  2791. startedThread
  2792.  
  2793.  
  2794. ΓòÉΓòÉΓòÉ <hidden> Protected Data - ICurrentThread ΓòÉΓòÉΓòÉ
  2795.  
  2796. Inherited Members
  2797. IBase
  2798. recoverable
  2799. unrecoverable
  2800.  
  2801.  
  2802. ΓòÉΓòÉΓòÉ 1.9.1. ICurrentThread::anchorBlock ΓòÉΓòÉΓòÉ
  2803.  
  2804. Obtains the anchor block handle for the current thread. If the anchor block 
  2805. handle is not initialized, 0 is returned. 
  2806.  
  2807. public:
  2808. virtual IAnchorBlockHandle anchorBlock() const;
  2809.  
  2810. Platform Support 
  2811.  
  2812. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2813. ΓöéPM          ΓöéMOTIF       Γöé
  2814. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2815. ΓöéYes         ΓöéNo          Γöé
  2816. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2817.  
  2818. Used in sample:   Hello World Sample - Version 6: atimehdr.cpp 
  2819.  
  2820.  
  2821. ΓòÉΓòÉΓòÉ 1.9.2. ICurrentThread::appContext ΓòÉΓòÉΓòÉ
  2822.  
  2823. Obtains the application context handle for the current thread. If the 
  2824. application context handle is not initialized, 0 is returned. 
  2825.  
  2826. public:
  2827. virtual IContextHandle appContext() const;
  2828.  
  2829. Platform Support 
  2830.  
  2831. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2832. ΓöéPM          ΓöéMOTIF       Γöé
  2833. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2834. ΓöéNo          ΓöéYes         Γöé
  2835. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2836.  
  2837.  
  2838. ΓòÉΓòÉΓòÉ 1.9.3. ICurrentThread::appShell ΓòÉΓòÉΓòÉ
  2839.  
  2840. Obtains the application shell handle for the current thread. If the application 
  2841. shell handle is not initialized, 0 is returned. 
  2842.  
  2843. public:
  2844. virtual IWindowHandle appShell() const;
  2845.  
  2846. Platform Support 
  2847.  
  2848. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2849. ΓöéPM          ΓöéMOTIF       Γöé
  2850. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2851. ΓöéNo          ΓöéYes         Γöé
  2852. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2853.  
  2854.  
  2855. ΓòÉΓòÉΓòÉ 1.9.4. ICurrentThread::exit ΓòÉΓòÉΓòÉ
  2856.  
  2857. Ends the current thread with the specified return value. 
  2858.  
  2859. public:
  2860. virtual void exit(unsigned long returnCode);
  2861.  
  2862.  returnCode Unsigned long value that specifies the return value for 
  2863.            termination. 
  2864.  
  2865.  Platform Support 
  2866.  
  2867.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2868.   ΓöéPM          ΓöéMOTIF       Γöé
  2869.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2870.   ΓöéYes         ΓöéYes         Γöé
  2871.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2872.  
  2873.  
  2874. ΓòÉΓòÉΓòÉ 1.9.5. ICurrentThread::ICurrentThread ΓòÉΓòÉΓòÉ
  2875.  
  2876. The constructor is protected to prevent the accidental creation of objects of 
  2877. this class.  Creation of objects of this class is restricted to 
  2878. IThread::current. 
  2879.  
  2880. protected:
  2881. ICurrentThread();
  2882.  
  2883. Platform Support 
  2884.  
  2885. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2886. ΓöéPM          ΓöéMOTIF       Γöé
  2887. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2888. ΓöéYes         ΓöéYes         Γöé
  2889. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2890.  
  2891.  
  2892. ΓòÉΓòÉΓòÉ 1.9.6. ICurrentThread::id ΓòÉΓòÉΓòÉ
  2893.  
  2894. Obtains the current thread's identifier (ID). 
  2895.  
  2896. public:
  2897. virtual IThreadId id() const;
  2898.  
  2899. Platform Support 
  2900.  
  2901. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2902. ΓöéPM          ΓöéMOTIF       Γöé
  2903. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2904. ΓöéYes         ΓöéYes         Γöé
  2905. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2906.  
  2907. Motif: The AIX release of the User Interface Class Library supports only one 
  2908. thread. Therefore, this function returns the value 1. 
  2909.  
  2910. Used in sample:   Multi-Line Entry Field Sample: amle.cpp 
  2911.  
  2912.  
  2913. ΓòÉΓòÉΓòÉ 1.9.7. ICurrentThread::initializeGUI ΓòÉΓòÉΓòÉ
  2914.  
  2915. Initializes the graphical user interface (GUI) environment on the current 
  2916. thread. 
  2917.  
  2918. public:
  2919. virtual void initializeGUI(long queueSize = 30);
  2920.  
  2921.  queueSize Long value that represents the queue size for the GUI environment. 
  2922.            The User Interface Class Library default queue size is 30. 
  2923.  
  2924.  Platform Support 
  2925.  
  2926.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2927.   ΓöéPM          ΓöéMOTIF       Γöé
  2928.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2929.   ΓöéYes         ΓöéYes         Γöé
  2930.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2931.  
  2932.  Presentation Manager: Sets up a Presentation Manager environment (anchor block 
  2933.  and message queue). 
  2934.  
  2935.  Motif: Initializes the X library environment by calling XtAppInitialize to 
  2936.  establish a connection to the display. This function also creates an 
  2937.  application context and an initial application shell. 
  2938.  
  2939.  Exceptions 
  2940.  
  2941.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2942.   ΓöéIAccessError        ΓöéThe graphical user interface (GUI) was  Γöé
  2943.   Γöé                    Γöénot initialized.  The window            Γöé
  2944.   Γöé                    Γöéinitialization failed.                  Γöé
  2945.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2946.   ΓöéIAccessError        ΓöéThe graphical user interface (GUI) was  Γöé
  2947.   Γöé                    Γöénot initialized.  The message queue     Γöé
  2948.   Γöé                    Γöécreation failed.                        Γöé
  2949.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2950.  
  2951.  
  2952. ΓòÉΓòÉΓòÉ 1.9.8. ICurrentThread::isGUIInitialized ΓòÉΓòÉΓòÉ
  2953.  
  2954. Determines if the graphical user interface (GUI) environment is active for this 
  2955. thread.  If the GUI is active, true is returned. 
  2956.  
  2957. public:
  2958. virtual Boolean isGUIInitialized() const;
  2959.  
  2960. Platform Support 
  2961.  
  2962. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2963. ΓöéPM          ΓöéMOTIF       Γöé
  2964. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2965. ΓöéYes         ΓöéYes         Γöé
  2966. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2967.  
  2968.  
  2969. ΓòÉΓòÉΓòÉ 1.9.9. ICurrentThread::isTopLevelShell ΓòÉΓòÉΓòÉ
  2970.  
  2971. Determines if the application shell window is completely initialized.  If it 
  2972. is, true is returned. 
  2973.  
  2974. public:
  2975. virtual Boolean isTopLevelShell() const;
  2976.  
  2977. Platform Support 
  2978.  
  2979. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2980. ΓöéPM          ΓöéMOTIF       Γöé
  2981. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  2982. ΓöéNo          ΓöéYes         Γöé
  2983. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  2984.  
  2985.  
  2986. ΓòÉΓòÉΓòÉ 1.9.10. ICurrentThread::isXerrorCodeAvailable ΓòÉΓòÉΓòÉ
  2987.  
  2988. Determines if an X library error code is available for querying. If one is 
  2989. available, true is returned. This function uses XerrorCode to retrieve the 
  2990. error code, which resets this flag. 
  2991.  
  2992. public:
  2993. virtual Boolean isXerrorCodeAvailable() const;
  2994.  
  2995. Platform Support 
  2996.  
  2997. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  2998. ΓöéPM          ΓöéMOTIF       Γöé
  2999. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3000. ΓöéNo          ΓöéYes         Γöé
  3001. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3002.  
  3003.  
  3004. ΓòÉΓòÉΓòÉ 1.9.11. ICurrentThread::messageQueue ΓòÉΓòÉΓòÉ
  3005.  
  3006. Obtains the message queue handle for the current thread. A 0 is returned if the 
  3007. handle is not initialized or is invalid. 
  3008.  
  3009. Overload 1 
  3010.  
  3011. public:
  3012. virtual IMessageQueueHandle messageQueue();
  3013.  
  3014. Use this version of the function if you want to reset an invalid message queue 
  3015. handle to 0.  Do this if the handle is determined to be invalid. 
  3016.  
  3017. Platform Support 
  3018.  
  3019. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3020. ΓöéPM          ΓöéMOTIF       Γöé
  3021. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3022. ΓöéYes         ΓöéNo          Γöé
  3023. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3024.  
  3025. Overload 2 
  3026.  
  3027. public:
  3028. virtual IMessageQueueHandle messageQueue() const;
  3029.  
  3030. Use this version of the function if you want the invalid message queue handle 
  3031. to remain invalid. 
  3032.  
  3033. Platform Support 
  3034.  
  3035. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3036. ΓöéPM          ΓöéMOTIF       Γöé
  3037. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3038. ΓöéYes         ΓöéNo          Γöé
  3039. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3040.  
  3041.  
  3042. ΓòÉΓòÉΓòÉ 1.9.12. ICurrentThread::processMsgs ΓòÉΓòÉΓòÉ
  3043.  
  3044. Gets messages from the message queue and dispatches them to the appropriate 
  3045. handlers. 
  3046.  
  3047. public:
  3048. virtual void processMsgs();
  3049.  
  3050. Platform Support 
  3051.  
  3052. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3053. ΓöéPM          ΓöéMOTIF       Γöé
  3054. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3055. ΓöéYes         ΓöéYes         Γöé
  3056. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3057.  
  3058. Presentation Manager: Messages are dispatched until the WM_QUIT message is 
  3059. received. 
  3060.  
  3061. Motif: ICurrentThread dispatches messages until it receives the client message 
  3062. WM_QUIT or the application is terminated through the Motif Window Manager. 
  3063.  
  3064.  
  3065. ΓòÉΓòÉΓòÉ 1.9.13. ICurrentThread::remainingStack ΓòÉΓòÉΓòÉ
  3066.  
  3067. Obtains an approximation of the number of available bytes that remain on the 
  3068. stack.  If the stack is not initialized, 0 is returned. 
  3069.  
  3070. public:
  3071. virtual unsigned long remainingStack() const;
  3072.  
  3073. Platform Support 
  3074.  
  3075. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3076. ΓöéPM          ΓöéMOTIF       Γöé
  3077. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3078. ΓöéYes         ΓöéIgnored     Γöé
  3079. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3080.  
  3081.  
  3082. ΓòÉΓòÉΓòÉ 1.9.14. ICurrentThread::setTopLevelShell ΓòÉΓòÉΓòÉ
  3083.  
  3084. Called when the application shell window has been initialized.  The User 
  3085. Interface Class Library calls this function to prevent multiple initializations 
  3086. of the graphical user interface. 
  3087.  
  3088. Note:  A user of the User Interface Class Library should never call this member 
  3089.        function. 
  3090.  
  3091.   public:
  3092.   virtual void setTopLevelShell() const;
  3093.  
  3094.  Platform Support 
  3095.  
  3096.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3097.   ΓöéPM          ΓöéMOTIF       Γöé
  3098.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3099.   ΓöéNo          ΓöéYes         Γöé
  3100.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3101.  
  3102.  
  3103. ΓòÉΓòÉΓòÉ 1.9.15. ICurrentThread::setXerrorCode ΓòÉΓòÉΓòÉ
  3104.  
  3105. Sets the error code that the last call to an X library function reported. 
  3106. Typically, you use this function to save the error code detected by the handler 
  3107. set by XSetErrorHandler in IThread.  The error handler is set by IThread so 
  3108. that the error codes are maintained on a per thread basis. 
  3109.  
  3110. Note:  A user of the User Interface Class Library should never call this member 
  3111.        function. 
  3112.  
  3113.   public:
  3114.   virtual void setXerrorCode(int errorCode);
  3115.  
  3116.  errorCode Integer value that specifies the error code to set. 
  3117.  
  3118.  Platform Support 
  3119.  
  3120.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3121.   ΓöéPM          ΓöéMOTIF       Γöé
  3122.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3123.   ΓöéNo          ΓöéYes         Γöé
  3124.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3125.  
  3126.  
  3127. ΓòÉΓòÉΓòÉ 1.9.16. ICurrentThread::sleep ΓòÉΓòÉΓòÉ
  3128.  
  3129. Suspends the thread for a specified number of milliseconds. 
  3130.  
  3131. public:
  3132. virtual ICurrentThread& sleep(unsigned long milliseconds);
  3133.  
  3134.  milliseconds Unsigned long value that specifies the number of milliseconds to 
  3135.            sleep. 
  3136.  
  3137.  Platform Support 
  3138.  
  3139.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3140.   ΓöéPM          ΓöéMOTIF       Γöé
  3141.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3142.   ΓöéYes         ΓöéYes         Γöé
  3143.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3144.  
  3145.  Motif: The granularity for sleeping on AIX is in seconds. The number of 
  3146.  milliseconds is divided by 1000 to determine the number of seconds the process 
  3147.  will sleep. If the number of milliseconds is less than 1 second, the process 
  3148.  will not sleep. 
  3149.  
  3150.  
  3151. ΓòÉΓòÉΓòÉ 1.9.17. ICurrentThread::startedThread ΓòÉΓòÉΓòÉ
  3152.  
  3153. Returns a pointer to the object of the IStartedThread class that corresponds to 
  3154. the current thread. 
  3155.  
  3156. protected:
  3157. virtual IStartedThread* startedThread() const;
  3158.  
  3159. Platform Support 
  3160.  
  3161. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3162. ΓöéPM          ΓöéMOTIF       Γöé
  3163. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3164. ΓöéYes         ΓöéYes         Γöé
  3165. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3166.  
  3167.  
  3168. ΓòÉΓòÉΓòÉ 1.9.18. ICurrentThread::suspend ΓòÉΓòÉΓòÉ
  3169.  
  3170. Suspends the current thread of execution only if the graphical user interface 
  3171. (GUI) is not initialized for the thread.  Suspending a GUI-initialized thread 
  3172. causes your application to hang. 
  3173.  
  3174. public:
  3175. virtual void suspend();
  3176.  
  3177. Platform Support 
  3178.  
  3179. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3180. ΓöéPM          ΓöéMOTIF       Γöé
  3181. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3182. ΓöéYes         ΓöéIgnored     Γöé
  3183. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3184.  
  3185. Motif: You cannot suspend or resume AIX threads because the AIX release of the 
  3186. User Interface Class Library has a single-thread limitation. 
  3187.  
  3188. Exceptions 
  3189.  
  3190. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3191. ΓöéIInvalidRequest     ΓöéThe current thread was not suspended.  AΓöé
  3192. Γöé                    ΓöéGUI thread cannot be suspended, or the  Γöé
  3193. Γöé                    Γöéapplication will hang.                  Γöé
  3194. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3195.  
  3196.  
  3197. ΓòÉΓòÉΓòÉ 1.9.19. ICurrentThread::terminateGUI ΓòÉΓòÉΓòÉ
  3198.  
  3199. Terminates the graphical user interface (GUI) environment. If you start a 
  3200. thread with IThread::autoInitGUI and the function returns true, this function 
  3201. is called automatically by the User Interface Class Library once IThreadFn::run 
  3202. completes. If you do the following, the User Interface Class Library does not 
  3203. call this function automatically, and it is your responsibility to do so: 
  3204.  
  3205.      Start the thread with IThread::autoInitGUI and the function returns false 
  3206.      Stop the thread using IThread::stop 
  3207.      Stop the thread using ICurrentThread::exit 
  3208.  
  3209.  Note:  If you do not call this function and it is your responsibility to do 
  3210.         so, you can tie up system resources until your application ends. 
  3211.  
  3212.   public:
  3213.   virtual void terminateGUI();
  3214.  
  3215.  Platform Support 
  3216.  
  3217.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3218.   ΓöéPM          ΓöéMOTIF       Γöé
  3219.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3220.   ΓöéYes         ΓöéYes         Γöé
  3221.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3222.  
  3223.  Presentation Manager: Before calling WinTerminate, the application must 
  3224.  destroy all windows and the message queue.  This function destroys the message 
  3225.  queue, but it is still the application's responsibility to destroy (that is, 
  3226.  delete) all of the window objects for the thread. If it does not, the return 
  3227.  value of WinTerminate and any subsequent calls is indeterminate. 
  3228.  
  3229.  
  3230. ΓòÉΓòÉΓòÉ 1.9.20. ICurrentThread::waitFor ΓòÉΓòÉΓòÉ
  3231.  
  3232. Allows the current thread to wait for a specified thread to end. 
  3233.  
  3234. public:
  3235. virtual ICurrentThread&
  3236.   waitFor( const IThread& anotherThread);
  3237.  
  3238.  anotherThread Reference to an IThread object that represents the specified 
  3239.            thread. 
  3240.  
  3241.  Platform Support 
  3242.  
  3243.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3244.   ΓöéPM          ΓöéMOTIF       Γöé
  3245.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3246.   ΓöéYes         ΓöéIgnored     Γöé
  3247.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3248.  
  3249.  Motif: The AIX release of the User Interface Class Library supports a 
  3250.  single-threaded environment; therefore, there are no other threads to wait 
  3251.  for. This function immediately returns a reference to the ICurrentThread 
  3252.  object. 
  3253.  
  3254.  Exceptions 
  3255.  
  3256.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3257.   ΓöéIInvalidParameter   ΓöéThe current thread did not wait for the Γöé
  3258.   Γöé                    Γöéspecified thread to end. The specified  Γöé
  3259.   Γöé                    Γöéthread is the current thread, which     Γöé
  3260.   Γöé                    Γöécannot wait on itself.                  Γöé
  3261.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3262.   ΓöéIAccessError        ΓöéThe current thread did not wait for the Γöé
  3263.   Γöé                    Γöéspecified thread to end. The specified  Γöé
  3264.   Γöé                    Γöéthread may have been invalid or an      Γöé
  3265.   Γöé                    Γöéinterrupt may have occurred.            Γöé
  3266.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3267.  
  3268.  
  3269. ΓòÉΓòÉΓòÉ 1.9.21. ICurrentThread::waitForAllThreads ΓòÉΓòÉΓòÉ
  3270.  
  3271. Allows the current thread to wait for all secondary threads to end. 
  3272.  
  3273. public:
  3274. virtual ICurrentThread& waitForAllThreads();
  3275.  
  3276. Platform Support 
  3277.  
  3278. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3279. ΓöéPM          ΓöéMOTIF       Γöé
  3280. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3281. ΓöéYes         ΓöéIgnored     Γöé
  3282. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3283.  
  3284. Motif: The AIX release of the User Interface Class Library supports a 
  3285. single-threaded environment; therefore, there are no other threads to wait for. 
  3286. This function immediately returns a reference to the ICurrentThread object. 
  3287.  
  3288. Exceptions 
  3289.  
  3290. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3291. ΓöéIInvalidParameter   ΓöéThe current thread did not wait for all Γöé
  3292. Γöé                    Γöésecondary threads to end. The current   Γöé
  3293. Γöé                    Γöéthread is not the primary thread.       Γöé
  3294. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3295.  
  3296.  
  3297. ΓòÉΓòÉΓòÉ 1.9.22. ICurrentThread::waitForAnyThread ΓòÉΓòÉΓòÉ
  3298.  
  3299. Allows the current thread to wait for the first termination to occur of any 
  3300. other threads in the current process. The terminated thread's identifier (ID) 
  3301. is returned. 
  3302.  
  3303. public:
  3304. virtual IThreadId waitForAnyThread();
  3305.  
  3306. Platform Support 
  3307.  
  3308. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3309. ΓöéPM          ΓöéMOTIF       Γöé
  3310. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3311. ΓöéYes         ΓöéIgnored     Γöé
  3312. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3313.  
  3314. Motif: The AIX release of the User Interface Class Library supports a 
  3315. single-threaded environment; therefore, there are no other threads to wait for. 
  3316. This function immediately returns a reference to the ICurrentThread object. 
  3317.  
  3318. Exceptions 
  3319.  
  3320. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3321. ΓöéIAccessError        ΓöéThe current thread did not wait for the Γöé
  3322. Γöé                    Γöénext thread in the process to terminate.Γöé
  3323. Γöé                    ΓöéNo thread terminated or an interrupt mayΓöé
  3324. Γöé                    Γöéhave occurred.                          Γöé
  3325. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3326.  
  3327.  
  3328. ΓòÉΓòÉΓòÉ 1.9.23. ICurrentThread::XerrorCode ΓòÉΓòÉΓòÉ
  3329.  
  3330. Returns the X library error code set by the member function 
  3331. ICurrentThread::setXerrorCode. You can retrieve the error code until a new X 
  3332. library error code is set by ICurrentThread::setXerrorCode, but the flag 
  3333. indicating that an error code is available is reset on the first invocation. 
  3334. The class IXLibErrorInfo uses this function to obtain information about the 
  3335. last X library error code detected. 
  3336.  
  3337. Note:  A user of the User Interface Class Library should never call this member 
  3338.        function. 
  3339.  
  3340.   public:
  3341.   virtual int XerrorCode() const;
  3342.  
  3343.  Platform Support 
  3344.  
  3345.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3346.   ΓöéPM          ΓöéMOTIF       Γöé
  3347.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3348.   ΓöéNo          ΓöéYes         Γöé
  3349.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3350.  
  3351.  
  3352. ΓòÉΓòÉΓòÉ 1.10. IDynamicLinkLibrary ΓòÉΓòÉΓòÉ
  3353.  
  3354. Description 
  3355.  
  3356. Derivation 
  3357.  
  3358. Constructors 
  3359.  
  3360. Public Functions 
  3361.  
  3362. Protected Data 
  3363.  
  3364. To close all the panels in a chapter, double click on this panel's system menu. 
  3365.  
  3366.  
  3367. ΓòÉΓòÉΓòÉ <hidden> Derivation - IDynamicLinkLibrary ΓòÉΓòÉΓòÉ
  3368.  
  3369. IBase
  3370.   Γöé
  3371. IVBase
  3372.   Γöé
  3373. IResourceLibrary
  3374.   Γöé
  3375. IDynamicLinkLibrary
  3376.  
  3377. Inherited by none. 
  3378.  
  3379.  
  3380. ΓòÉΓòÉΓòÉ <hidden> Class Description - IDynamicLinkLibrary ΓòÉΓòÉΓòÉ
  3381.  
  3382. ireslib.hpp 
  3383.  
  3384. The IDynamicLinkLibrary class supports the loading of resources from a dynamic 
  3385. link library (DLL). 
  3386.  
  3387. Motif Information 
  3388.  
  3389. The AIX release of the User Interface Class Library does not support this 
  3390. class. 
  3391.  
  3392.  
  3393. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IDynamicLinkLibrary ΓòÉΓòÉΓòÉ
  3394.  
  3395. Constructors
  3396. IDynamicLinkLibrary
  3397. operator =
  3398. ~IDynamicLinkLibrary
  3399.  
  3400. Diagnostics
  3401. asDebugInfo
  3402. asString
  3403.  
  3404. Dynamic Link Library Information
  3405. fileName
  3406. handle
  3407. isOpen
  3408.  
  3409. Opening and Closing
  3410. close
  3411. open
  3412.  
  3413. Procedure Address Loading
  3414. isEntryPoint32Bit
  3415. procAddress
  3416.  
  3417. Inherited Members
  3418. IResourceLibrary
  3419. asDebugInfo
  3420. asString
  3421. fileName
  3422. handle
  3423. isOpen
  3424. loadAccelTable
  3425. loadBitmap
  3426. loadDialog
  3427. loadHelpTable
  3428. loadIcon
  3429. loadMenu
  3430. loadMessage
  3431. loadPointer
  3432. loadString
  3433. operator =
  3434. sizeBitmapTo
  3435. tryToLoadBitmap
  3436. tryToLoadIcon
  3437. tryToLoadMessage
  3438. tryToLoadString
  3439.  
  3440. IVBase
  3441. asDebugInfo
  3442. asString
  3443.  
  3444. IBase
  3445. asDebugInfo
  3446. asString
  3447. messageFile
  3448. messageText
  3449. setMessageFile
  3450. version
  3451.  
  3452.  
  3453. ΓòÉΓòÉΓòÉ <hidden> IDynamicLinkLibrary - Constructors ΓòÉΓòÉΓòÉ
  3454.  
  3455. Use these members to construct, copy, assign, and destruct objects of this 
  3456. class.  You can construct objects of this class using either a dynamic link 
  3457. library name, module handle, or a reference to an existing object of this 
  3458. class. 
  3459.  
  3460.  
  3461. ΓòÉΓòÉΓòÉ <hidden> IDynamicLinkLibrary - Diagnostics ΓòÉΓòÉΓòÉ
  3462.  
  3463. Use these members for diagnostic purposes.  They return an IString 
  3464. representation of an object of this class. 
  3465.  
  3466.  
  3467. ΓòÉΓòÉΓòÉ <hidden> IDynamicLinkLibrary - Dynamic Link Library Information ΓòÉΓòÉΓòÉ
  3468.  
  3469. Use these members to query general dynamic link library information. 
  3470.  
  3471.  
  3472. ΓòÉΓòÉΓòÉ <hidden> IDynamicLinkLibrary - Opening and Closing ΓòÉΓòÉΓòÉ
  3473.  
  3474. Use these members to open or close a dynamic link library (DLL). 
  3475.  
  3476. Note:  DLL objects are reference-counted.  When a DLL is opened, the reference 
  3477.        count is incremented, and when it is closed, the reference count is 
  3478.        decremented.  When the reference count reaches 0, the DLL is unloaded 
  3479.        from memory. 
  3480.  
  3481.  
  3482. ΓòÉΓòÉΓòÉ <hidden> IDynamicLinkLibrary - Procedure Address Loading ΓòÉΓòÉΓòÉ
  3483.  
  3484. Use these members to get a procedure address from a dynamic link library or to 
  3485. test the memory model of an entry point. 
  3486.  
  3487.  
  3488. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IDynamicLinkLibrary ΓòÉΓòÉΓòÉ
  3489.  
  3490. Inherited Members
  3491. IBase
  3492. recoverable
  3493. unrecoverable
  3494.  
  3495.  
  3496. ΓòÉΓòÉΓòÉ 1.10.1. IDynamicLinkLibrary::asDebugInfo ΓòÉΓòÉΓòÉ
  3497.  
  3498. Provides textual information about the class object. It returns a string that 
  3499. contains the file name of the dynamic link library. 
  3500.  
  3501. public:
  3502. virtual IString asDebugInfo() const;
  3503.  
  3504. Platform Support 
  3505.  
  3506. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3507. ΓöéPM          ΓöéMOTIF       Γöé
  3508. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3509. ΓöéYes         ΓöéNo          Γöé
  3510. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3511.  
  3512.  
  3513. ΓòÉΓòÉΓòÉ 1.10.2. IDynamicLinkLibrary::asString ΓòÉΓòÉΓòÉ
  3514.  
  3515. Provides textual information about the class object. It returns a string that 
  3516. contains the file name of the dynamic link library. 
  3517.  
  3518. public:
  3519. virtual IString asString() const;
  3520.  
  3521. Platform Support 
  3522.  
  3523. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3524. ΓöéPM          ΓöéMOTIF       Γöé
  3525. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3526. ΓöéYes         ΓöéNo          Γöé
  3527. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3528.  
  3529.  
  3530. ΓòÉΓòÉΓòÉ 1.10.3. IDynamicLinkLibrary::close ΓòÉΓòÉΓòÉ
  3531.  
  3532. Closes a dynamic link library and decrements the reference count. 
  3533.  
  3534. public:
  3535. virtual IDynamicLinkLibrary& close();
  3536.  
  3537. Platform Support 
  3538.  
  3539. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3540. ΓöéPM          ΓöéMOTIF       Γöé
  3541. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3542. ΓöéYes         ΓöéNo          Γöé
  3543. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3544.  
  3545.  
  3546. ΓòÉΓòÉΓòÉ 1.10.4. IDynamicLinkLibrary::fileName ΓòÉΓòÉΓòÉ
  3547.  
  3548. Returns the fully qualified file name of the dynamic link library. 
  3549.  
  3550. public:
  3551. virtual IString fileName() const;
  3552.  
  3553. Platform Support 
  3554.  
  3555. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3556. ΓöéPM          ΓöéMOTIF       Γöé
  3557. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3558. ΓöéYes         ΓöéNo          Γöé
  3559. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3560.  
  3561. Exceptions 
  3562.  
  3563. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3564. ΓöéIAccessError        ΓöéThe file name was not returned.  The    Γöé
  3565. Γöé                    Γöémodule handle may be invalid.           Γöé
  3566. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3567.  
  3568.  
  3569. ΓòÉΓòÉΓòÉ 1.10.5. IDynamicLinkLibrary::handle ΓòÉΓòÉΓòÉ
  3570.  
  3571. Returns the module handle of the dynamic link library. 
  3572.  
  3573. public:
  3574. virtual IModuleHandle handle() const;
  3575.  
  3576. Platform Support 
  3577.  
  3578. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3579. ΓöéPM          ΓöéMOTIF       Γöé
  3580. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3581. ΓöéYes         ΓöéNo          Γöé
  3582. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3583.  
  3584.  
  3585. ΓòÉΓòÉΓòÉ 1.10.6. IDynamicLinkLibrary::IDynamicLinkLibrary ΓòÉΓòÉΓòÉ
  3586.  
  3587. Use these members to construct, copy, assign, and destruct objects of this 
  3588. class.  You can construct objects of this class using either a dynamic link 
  3589. library name, module handle, or a reference to an existing object of this 
  3590. class. 
  3591.  
  3592. Overload 1 
  3593.  
  3594. public:
  3595. IDynamicLinkLibrary(const IModuleHandle& moduleHandle);
  3596.  
  3597.  moduleHandle Reference to a module handle of a DLL that has been loaded 
  3598.            explicitly. 
  3599.  
  3600.  Use this version of the constructor if you have an IModuleHandle obtained by 
  3601.  loading the dynamic link library (DLL) explicitly. 
  3602.  
  3603.  Platform Support 
  3604.  
  3605.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3606.   ΓöéPM          ΓöéMOTIF       Γöé
  3607.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3608.   ΓöéYes         ΓöéNo          Γöé
  3609.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3610.  
  3611.  Exceptions 
  3612.  
  3613.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3614.   ΓöéIAccessError        ΓöéThe dynamic link library object was not Γöé
  3615.   Γöé                    Γöécreated.  The module handle may be      Γöé
  3616.   Γöé                    Γöéinvalid.                                Γöé
  3617.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3618.  
  3619.  Overload 2 
  3620.  
  3621.   public:
  3622.   IDynamicLinkLibrary(const char* resourceFileName);
  3623.  
  3624.  resourceFileName Pointer to the dynamic link library name. 
  3625.  
  3626.  Use this version of the constructor if you know the name of the dynamic link 
  3627.  library (DLL).  If you want to search the LIBPATH for the DLL, specify 
  3628.  resourceFileName without the path or extension. 
  3629.  
  3630.  Platform Support 
  3631.  
  3632.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3633.   ΓöéPM          ΓöéMOTIF       Γöé
  3634.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3635.   ΓöéYes         ΓöéNo          Γöé
  3636.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3637.  
  3638.  Overload 3 
  3639.  
  3640.   public:
  3641.   IDynamicLinkLibrary(const IDynamicLinkLibrary& dllLibrary);
  3642.  
  3643.  dllLibrary Reference to an existing dynamic link library object. 
  3644.  
  3645.  Creates a dynamic link library object using a reference to an existing dynamic 
  3646.  link library object.  This is commonly know as a copy constructor. 
  3647.  
  3648.  Platform Support 
  3649.  
  3650.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3651.   ΓöéPM          ΓöéMOTIF       Γöé
  3652.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3653.   ΓöéYes         ΓöéNo          Γöé
  3654.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3655.  
  3656.  
  3657. ΓòÉΓòÉΓòÉ 1.10.7. IDynamicLinkLibrary::isEntryPoint32Bit ΓòÉΓòÉΓòÉ
  3658.  
  3659. If the entry point is a 32-bit function, returns true. 
  3660.  
  3661. Overload 1 
  3662.  
  3663. public:
  3664. Boolean
  3665.   isEntryPoint32Bit( unsigned long procedureOrdinal) const;
  3666.  
  3667.  procedureOrdinal Unsigned long value that represents the procedure ordinal. 
  3668.  
  3669.  Use this version of the function if you know the entry point's ordinal. 
  3670.  
  3671.  Platform Support 
  3672.  
  3673.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3674.   ΓöéPM          ΓöéMOTIF       Γöé
  3675.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3676.   ΓöéYes         ΓöéNo          Γöé
  3677.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3678.  
  3679.  Exceptions 
  3680.  
  3681.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3682.   ΓöéIAccessError        ΓöéThe entry point was not queried.  The   Γöé
  3683.   Γöé                    Γöéprocedure ordinal may be invalid.       Γöé
  3684.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3685.  
  3686.  Overload 2 
  3687.  
  3688.   public:
  3689.   Boolean isEntryPoint32Bit(const char* procedureName) const;
  3690.  
  3691.  procedureName Pointer to the procedure name. 
  3692.  
  3693.  Use this version of the function if you know the entry point's name. 
  3694.  
  3695.  Platform Support 
  3696.  
  3697.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3698.   ΓöéPM          ΓöéMOTIF       Γöé
  3699.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3700.   ΓöéYes         ΓöéNo          Γöé
  3701.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3702.  
  3703.  Exceptions 
  3704.  
  3705.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3706.   ΓöéIAccessError        ΓöéThe entry point was not queried.  The   Γöé
  3707.   Γöé                    Γöéprocedure name may be invalid.          Γöé
  3708.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3709.  
  3710.  
  3711. ΓòÉΓòÉΓòÉ 1.10.8. IDynamicLinkLibrary::isOpen ΓòÉΓòÉΓòÉ
  3712.  
  3713. Returns true if the dynamic link library is open. 
  3714.  
  3715. public:
  3716. virtual Boolean isOpen() const;
  3717.  
  3718. Platform Support 
  3719.  
  3720. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3721. ΓöéPM          ΓöéMOTIF       Γöé
  3722. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3723. ΓöéYes         ΓöéNo          Γöé
  3724. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3725.  
  3726.  
  3727. ΓòÉΓòÉΓòÉ 1.10.9. IDynamicLinkLibrary::open ΓòÉΓòÉΓòÉ
  3728.  
  3729. Opens a dynamic link library and increments the reference count. 
  3730.  
  3731. public:
  3732. virtual IDynamicLinkLibrary& open();
  3733.  
  3734. Platform Support 
  3735.  
  3736. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3737. ΓöéPM          ΓöéMOTIF       Γöé
  3738. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3739. ΓöéYes         ΓöéNo          Γöé
  3740. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3741.  
  3742.  
  3743. ΓòÉΓòÉΓòÉ 1.10.10. IDynamicLinkLibrary::operator = ΓòÉΓòÉΓòÉ
  3744.  
  3745. Assigns the member data of an object of this class to another object of this 
  3746. class. 
  3747.  
  3748. public:
  3749. IDynamicLinkLibrary&
  3750.   operator =( const IDynamicLinkLibrary& dllLibrary);
  3751.  
  3752.  dllLibrary Reference to an existing dynamic link library object. 
  3753.  
  3754.  Platform Support 
  3755.  
  3756.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3757.   ΓöéPM          ΓöéMOTIF       Γöé
  3758.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3759.   ΓöéYes         ΓöéNo          Γöé
  3760.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3761.  
  3762.  
  3763. ΓòÉΓòÉΓòÉ 1.10.11. IDynamicLinkLibrary::procAddress ΓòÉΓòÉΓòÉ
  3764.  
  3765. Loads the specified procedure address from a dynamic link library. 
  3766.  
  3767. Overload 1 
  3768.  
  3769. public:
  3770. void* procAddress(unsigned long procedureOrdinal) const;
  3771.  
  3772.  procedureOrdinal Unsigned long value that represents the procedure ordinal. 
  3773.  
  3774.  Use this version of the function if you know the procedure ordinal. 
  3775.  
  3776.  Platform Support 
  3777.  
  3778.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3779.   ΓöéPM          ΓöéMOTIF       Γöé
  3780.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3781.   ΓöéYes         ΓöéNo          Γöé
  3782.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3783.  
  3784.  Exceptions 
  3785.  
  3786.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3787.   ΓöéIAccessError        ΓöéThe procedure address was not loaded.   Γöé
  3788.   Γöé                    ΓöéThe procedure ordinal may be invalid.   Γöé
  3789.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3790.  
  3791.  Overload 2 
  3792.  
  3793.   public:
  3794.   void* procAddress(const char* procedureName) const;
  3795.  
  3796.  procedureName Pointer to the procedure name. 
  3797.  
  3798.  Use this version of the function if you know the procedure name. 
  3799.  
  3800.  Platform Support 
  3801.  
  3802.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3803.   ΓöéPM          ΓöéMOTIF       Γöé
  3804.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3805.   ΓöéYes         ΓöéNo          Γöé
  3806.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3807.  
  3808.  Exceptions 
  3809.  
  3810.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3811.   ΓöéIAccessError        ΓöéThe procedure address was not loaded.   Γöé
  3812.   Γöé                    ΓöéThe procedure name may be invalid.      Γöé
  3813.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3814.  
  3815.  
  3816. ΓòÉΓòÉΓòÉ 1.10.12. IDynamicLinkLibrary::~IDynamicLinkLibrary ΓòÉΓòÉΓòÉ
  3817.  
  3818. The dynamic link library is unloaded from memory if it is no longer being 
  3819. referenced. 
  3820.  
  3821. public:
  3822. virtual  ~IDynamicLinkLibrary();
  3823.  
  3824. Platform Support 
  3825.  
  3826. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3827. ΓöéPM          ΓöéMOTIF       Γöé
  3828. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3829. ΓöéYes         ΓöéNo          Γöé
  3830. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3831.  
  3832.  
  3833. ΓòÉΓòÉΓòÉ 1.11. IPrivateResource ΓòÉΓòÉΓòÉ
  3834.  
  3835. Description 
  3836.  
  3837. Derivation 
  3838.  
  3839. Constructors 
  3840.  
  3841. Public Functions 
  3842.  
  3843. Protected Functions 
  3844.  
  3845. Protected Data 
  3846.  
  3847. To close all the panels in a chapter, double click on this panel's system menu. 
  3848.  
  3849.  
  3850. ΓòÉΓòÉΓòÉ <hidden> Derivation - IPrivateResource ΓòÉΓòÉΓòÉ
  3851.  
  3852. IBase
  3853.   Γöé
  3854. IVBase
  3855.   Γöé
  3856. IResource
  3857.   Γöé
  3858. IPrivateResource
  3859.  
  3860. Inherited by none. 
  3861.  
  3862.  
  3863. ΓòÉΓòÉΓòÉ <hidden> Class Description - IPrivateResource ΓòÉΓòÉΓòÉ
  3864.  
  3865. ireslock.hpp 
  3866.  
  3867. The IPrivateResource class defines a resource that is used within a single 
  3868. process. 
  3869.  
  3870. IResource, and its inherited classes represent resources in the user's problem 
  3871. domain.  Objects of these classes name a particular resource.  For example, a 
  3872. user wants to serialize access to the data in a window list collection.  The 
  3873. user creates an IResource inherited class to represent the window list and then 
  3874. uses IResourceLock (preferred) or a function of IResource itself to lock and 
  3875. unlock the resource to serialize the access. You can use this class either 
  3876. alone (lock and unlock) or in combination with an IResourceLock, whose 
  3877. constructor locks the resource and whose destructor unlocks the resource. If 
  3878. you need the lock only for a block of code, use IResourceLock.  Use static 
  3879. objects because you only need a single object of a particular IResource. 
  3880.  
  3881. The static object pointer discussions exist because there is no 
  3882. language-defined way to ensure that static objects are constructed when needed. 
  3883. Also, they are always constructed even if they are never needed.  Combining a 
  3884. static pointer to an object with a static function to reference the object and 
  3885. then creating the object, if necessary, defers creating the object until it is 
  3886. needed. 
  3887.  
  3888. Use this class for resources that are limited to the same process (as opposed 
  3889. to a public resource that is used by more than one process via its name). 
  3890.  
  3891. You can use this class as a static key to serialize access to a private 
  3892. resource. You can also use this class as a mechanism to ensure that the static 
  3893. resource is constructed prior to being used. 
  3894.  
  3895. Some basic guidelines include the following: 
  3896.  
  3897.      Use a static pointer to the resource rather than a static object. 
  3898.  
  3899.      Always access the resource using a static function rather than accessing 
  3900.       it directly with the static pointer. 
  3901.  
  3902.      When the resource is accessed through the static function, allocate it if 
  3903.       the static pointer is 0. 
  3904.  
  3905.      Provide a new class that represents the static pointers for a particular 
  3906.       class or component.  This new class does not require a constructor, but 
  3907.       it does require a destructor that destroys the static objects used by the 
  3908.       component. 
  3909.  
  3910.  
  3911. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IPrivateResource ΓòÉΓòÉΓòÉ
  3912.  
  3913. Constructors
  3914. IPrivateResource
  3915. ~IPrivateResource
  3916.  
  3917. Inherited Members
  3918. IResource
  3919. lock
  3920. unlock
  3921.  
  3922. IVBase
  3923. asDebugInfo
  3924. asString
  3925.  
  3926. IBase
  3927. asDebugInfo
  3928. asString
  3929. messageFile
  3930. messageText
  3931. setMessageFile
  3932. version
  3933.  
  3934.  
  3935. ΓòÉΓòÉΓòÉ <hidden> IPrivateResource - Constructors ΓòÉΓòÉΓòÉ
  3936.  
  3937. Use these members to construct and destruct objects of this class. 
  3938.  
  3939.  
  3940. ΓòÉΓòÉΓòÉ <hidden> IPrivateResource - Hidden Members ΓòÉΓòÉΓòÉ
  3941.  
  3942. You cannot access these functions. 
  3943.  
  3944.  
  3945. ΓòÉΓòÉΓòÉ <hidden> IPrivateResource - Resource Handle ΓòÉΓòÉΓòÉ
  3946.  
  3947. Use these members to obtain a handle to the private resource. 
  3948.  
  3949.  
  3950. ΓòÉΓòÉΓòÉ <hidden> Protected Functions - IPrivateResource ΓòÉΓòÉΓòÉ
  3951.  
  3952. Resource Handle
  3953. handle
  3954.  
  3955. Inherited Members
  3956. IResource
  3957. handle
  3958.  
  3959.  
  3960. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IPrivateResource ΓòÉΓòÉΓòÉ
  3961.  
  3962. Inherited Members
  3963. IBase
  3964. recoverable
  3965. unrecoverable
  3966.  
  3967.  
  3968. ΓòÉΓòÉΓòÉ 1.11.1. IPrivateResource::handle ΓòÉΓòÉΓòÉ
  3969.  
  3970. Returns the handle for the private resource. 
  3971.  
  3972. protected:
  3973. ISemaphoreHandle& handle();
  3974.  
  3975. Platform Support 
  3976.  
  3977. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3978. ΓöéPM          ΓöéMOTIF       Γöé
  3979. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3980. ΓöéYes         ΓöéYes         Γöé
  3981. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3982.  
  3983.  
  3984. ΓòÉΓòÉΓòÉ 1.11.2. IPrivateResource::IPrivateResource ΓòÉΓòÉΓòÉ
  3985.  
  3986. The only way to construct objects of this class is with this, the default 
  3987. constructor, which does not accept any parameters. 
  3988.  
  3989. public:
  3990. IPrivateResource();
  3991.  
  3992. Platform Support 
  3993.  
  3994. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  3995. ΓöéPM          ΓöéMOTIF       Γöé
  3996. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  3997. ΓöéYes         ΓöéYes         Γöé
  3998. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  3999.  
  4000. Exceptions 
  4001.  
  4002. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4003. ΓöéIAccessError        ΓöéThe private resource object was not     Γöé
  4004. Γöé                    Γöécreated.  The memory may be exhausted orΓöé
  4005. Γöé                    Γöéthe semaphore handle limit on your      Γöé
  4006. Γöé                    Γöéplatform may be exceeded.               Γöé
  4007. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4008.  
  4009.  
  4010. ΓòÉΓòÉΓòÉ 1.11.3. IPrivateResource::~IPrivateResource ΓòÉΓòÉΓòÉ
  4011.  
  4012. public:
  4013. virtual  ~IPrivateResource();
  4014.  
  4015. Platform Support 
  4016.  
  4017. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4018. ΓöéPM          ΓöéMOTIF       Γöé
  4019. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4020. ΓöéYes         ΓöéYes         Γöé
  4021. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4022.  
  4023. Exceptions 
  4024.  
  4025. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4026. ΓöéIAccessError        ΓöéThe private resource object was not     Γöé
  4027. Γöé                    Γöédeleted.  The semaphore handle may be   Γöé
  4028. Γöé                    Γöéinvalid.                                Γöé
  4029. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4030.  
  4031.  
  4032. ΓòÉΓòÉΓòÉ 1.12. IProcedureAddress ΓòÉΓòÉΓòÉ
  4033.  
  4034. Description 
  4035.  
  4036. Derivation 
  4037.  
  4038. Constructors 
  4039.  
  4040. Public Functions 
  4041.  
  4042. Protected Data 
  4043.  
  4044. To close all the panels in a chapter, double click on this panel's system menu. 
  4045.  
  4046.  
  4047. ΓòÉΓòÉΓòÉ <hidden> Derivation - IProcedureAddress ΓòÉΓòÉΓòÉ
  4048.  
  4049. IBase
  4050.   Γöé
  4051. IProcedureAddress
  4052.  
  4053. Inherited by none. 
  4054.  
  4055.  
  4056. ΓòÉΓòÉΓòÉ <hidden> Class Description - IProcedureAddress ΓòÉΓòÉΓòÉ
  4057.  
  4058. iprocadr.hpp 
  4059.  
  4060. The IProcedureAddress class is a wrapper for dynamic link library (DLL) entry 
  4061. points. This User Interface Class Library uses an operating system function to 
  4062. do a runtime link to the DLL, and it uses another operating system function to 
  4063. acquire the runtime address of a specified function in the DLL. When the link 
  4064. is established and the address is acquired, you can call code that was not 
  4065. accessible to the linker when the executable module was built. 
  4066.  
  4067. This class provides for the following: 
  4068.  
  4069.      Constructing objects from entry point names (or ordinal entry point 
  4070.       numbers) and DLL objects (or DLL names) 
  4071.  
  4072.      Calling the entry point without having to cast the generic function type 
  4073.       supported by the operating system function that is used to acquire the 
  4074.       runtime address 
  4075.  
  4076.      Managing, along with DynamicLinkLibrary, the loading and freeing of the 
  4077.       associated DLL module. 
  4078.  
  4079.  Presentation Manager Information 
  4080.  
  4081.  Customization (Template Argument) 
  4082.  
  4083.  IProcedureAddress is a template class.  Construct objects of this class with 
  4084.  the following template argument: 
  4085.  
  4086.  PtrToFnType 
  4087.       Type of the entry point to load or call; this must be a 
  4088.       pointer-to-function type. 
  4089.  
  4090.  Motif Information 
  4091.  
  4092.  AIX does not support this class or dynamic link libraries. 
  4093.  
  4094.  
  4095. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IProcedureAddress ΓòÉΓòÉΓòÉ
  4096.  
  4097. Constructors
  4098. IProcedureAddress
  4099. ~IProcedureAddress
  4100.  
  4101. Memory Model
  4102. is32Bit
  4103.  
  4104. Pointers to Functions
  4105. operator PtrToFnType
  4106.  
  4107. Inherited Members
  4108. IBase
  4109. asDebugInfo
  4110. asString
  4111. messageFile
  4112. messageText
  4113. setMessageFile
  4114. version
  4115.  
  4116.  
  4117. ΓòÉΓòÉΓòÉ <hidden> IProcedureAddress - Constructors ΓòÉΓòÉΓòÉ
  4118.  
  4119. You must provide the following two pieces of information to construct objects 
  4120. of this template class: 
  4121.  
  4122.      The entry point.  You can specify either an entry point name (const char 
  4123.       *) or entry point ordinal (unsigned). 
  4124.  
  4125.      The dynamic link library (DLL) from which to load the entry point. You 
  4126.       can specify the DLL either as a reference to an existing 
  4127.       IDynamicLinkLibrary object or by the DLL name. 
  4128.  
  4129.  You can also destruct objects of this class. 
  4130.  
  4131.  
  4132. ΓòÉΓòÉΓòÉ <hidden> IProcedureAddress - Memory Model ΓòÉΓòÉΓòÉ
  4133.  
  4134. These members help you determine if you are using a 32-Bit or a 16-Bit memory 
  4135. model. 
  4136.  
  4137.  
  4138. ΓòÉΓòÉΓòÉ <hidden> IProcedureAddress - Pointers to Functions ΓòÉΓòÉΓòÉ
  4139.  
  4140. These operators permit objects of this class to be used as regular function 
  4141. names. 
  4142.  
  4143.  
  4144. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IProcedureAddress ΓòÉΓòÉΓòÉ
  4145.  
  4146. Inherited Members
  4147. IBase
  4148. recoverable
  4149. unrecoverable
  4150.  
  4151.  
  4152. ΓòÉΓòÉΓòÉ 1.12.1. IProcedureAddress::IProcedureAddress ΓòÉΓòÉΓòÉ
  4153.  
  4154. You must provide the following two pieces of information to construct objects 
  4155. of this template class: 
  4156.  
  4157.      The entry point.  You can specify either an entry point name (const char 
  4158.       *) or entry point ordinal (unsigned). 
  4159.  
  4160.      The dynamic link library (DLL) from which to load the entry point. You 
  4161.       can specify the DLL either as a reference to an existing 
  4162.       IDynamicLinkLibrary object or by the DLL name. 
  4163.  
  4164.  You can also destruct objects of this class. 
  4165.  
  4166.  Overload 1 
  4167.  
  4168.   public:
  4169.   IProcedureAddress( const char* entryPoint,
  4170.                      const char* dllName);
  4171.  
  4172.  entryPoint Pointer that identifies the name of the entry point within the DLL. 
  4173.  
  4174.  dllName   Pointer that identifies the DLL name. 
  4175.  
  4176.  Create an object to dynamically load an entry point using the specified entry 
  4177.  point name and DLL name.  If you know the name of the entry point and have not 
  4178.  already loaded the DLL, use this constructor. 
  4179.  
  4180.  Platform Support 
  4181.  
  4182.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4183.   ΓöéPM          ΓöéMOTIF       Γöé
  4184.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4185.   ΓöéYes         ΓöéNo          Γöé
  4186.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4187.  
  4188.  Overload 2 
  4189.  
  4190.   public:
  4191.   IProcedureAddress( const char* entryPoint,
  4192.                      IDynamicLinkLibrary& aDLL);
  4193.  
  4194.  entryPoint Pointer that identifies the name of the entry point within the DLL. 
  4195.  
  4196.  aDLL      Reference to an IDynamicLinkLibrary object that wrappers the DLL. 
  4197.  
  4198.  Create an object to dynamically load an entry point using the specified entry 
  4199.  point name and a reference to an existing IDynamicLinkLibrary object.  If you 
  4200.  know the name of the entry point and have already loaded the DLL, use this 
  4201.  constructor. 
  4202.  
  4203.  Platform Support 
  4204.  
  4205.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4206.   ΓöéPM          ΓöéMOTIF       Γöé
  4207.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4208.   ΓöéYes         ΓöéNo          Γöé
  4209.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4210.  
  4211.  Overload 3 
  4212.  
  4213.   public:
  4214.   IProcedureAddress( unsigned long ordinal,
  4215.                      const char* dllName);
  4216.  
  4217.  ordinal   Unsigned long value that represents the entry point within the DLL. 
  4218.  
  4219.  dllName   Pointer that identifies the DLL name. 
  4220.  
  4221.  Create an object to dynamically load an entry point using the specified entry 
  4222.  point ordinal and DLL name.  If you know the ordinal of the entry point and 
  4223.  have not already loaded the DLL, use this constructor. 
  4224.  
  4225.  Platform Support 
  4226.  
  4227.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4228.   ΓöéPM          ΓöéMOTIF       Γöé
  4229.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4230.   ΓöéYes         ΓöéNo          Γöé
  4231.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4232.  
  4233.  Overload 4 
  4234.  
  4235.   public:
  4236.   IProcedureAddress( unsigned long ordinal,
  4237.                      IDynamicLinkLibrary& aDLL);
  4238.  
  4239.  ordinal   Unsigned long value that represents the entry point within the DLL. 
  4240.  
  4241.  aDLL      Reference to an IDynamicLinkLibrary object that wrappers the DLL. 
  4242.  
  4243.  Create an object to dynamically load an entry point using the specified entry 
  4244.  point ordinal and a reference to an existing IDynamicLinkLibrary object.  If 
  4245.  you know the ordinal of the entry point and have already loaded the dynamic 
  4246.  link library, use this constructor. 
  4247.  
  4248.  Platform Support 
  4249.  
  4250.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4251.   ΓöéPM          ΓöéMOTIF       Γöé
  4252.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4253.   ΓöéYes         ΓöéNo          Γöé
  4254.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4255.  
  4256.  
  4257. ΓòÉΓòÉΓòÉ 1.12.2. IProcedureAddress::is32Bit ΓòÉΓòÉΓòÉ
  4258.  
  4259. Determines the memory model that the entry point resides within.  If the entry 
  4260. point is 32-bit, this function returns true, and if the entry point is 16-bit, 
  4261. it returns false. 
  4262.  
  4263. public:
  4264. Boolean is32Bit() const;
  4265.  
  4266. Platform Support 
  4267.  
  4268. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4269. ΓöéPM          ΓöéMOTIF       Γöé
  4270. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4271. ΓöéYes         ΓöéNo          Γöé
  4272. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4273.  
  4274.  
  4275. ΓòÉΓòÉΓòÉ 1.12.3. IProcedureAddress::operator PtrToFnType ΓòÉΓòÉΓòÉ
  4276.  
  4277. Permits objects of this template class to be used in the same way as pointers 
  4278. to functions, which are like regular function names. 
  4279.  
  4280. public:
  4281. operator PtrToFnType() const;
  4282.  
  4283. Platform Support 
  4284.  
  4285. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4286. ΓöéPM          ΓöéMOTIF       Γöé
  4287. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4288. ΓöéYes         ΓöéNo          Γöé
  4289. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4290.  
  4291.  
  4292. ΓòÉΓòÉΓòÉ 1.12.4. IProcedureAddress::~IProcedureAddress ΓòÉΓòÉΓòÉ
  4293.  
  4294. This destructor frees the IDynamicLinkLibrary object that this class creates 
  4295. during construction.  If you need to use the dynamic link library after the 
  4296. IDynamicLinkLibrary object is freed, construct an object of this class using an 
  4297. explicitly created IDynamicLinkLibrary object instead of the dynamic link 
  4298. library name. 
  4299.  
  4300. public:
  4301. ~IProcedureAddress();
  4302.  
  4303. Platform Support 
  4304.  
  4305. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4306. ΓöéPM          ΓöéMOTIF       Γöé
  4307. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4308. ΓöéYes         ΓöéNo          Γöé
  4309. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4310.  
  4311.  
  4312. ΓòÉΓòÉΓòÉ 1.13. IProcessId ΓòÉΓòÉΓòÉ
  4313.  
  4314. Description 
  4315.  
  4316. Derivation 
  4317.  
  4318. Constructors 
  4319.  
  4320. Public Functions 
  4321.  
  4322. Protected Data 
  4323.  
  4324. To close all the panels in a chapter, double click on this panel's system menu. 
  4325.  
  4326.  
  4327. ΓòÉΓòÉΓòÉ <hidden> Derivation - IProcessId ΓòÉΓòÉΓòÉ
  4328.  
  4329. IBase
  4330.   Γöé
  4331. IHandle
  4332.   Γöé
  4333. IProcessId
  4334.  
  4335. Inherited by none. 
  4336.  
  4337.  
  4338. ΓòÉΓòÉΓòÉ <hidden> Class Description - IProcessId ΓòÉΓòÉΓòÉ
  4339.  
  4340. ihandle.hpp 
  4341.  
  4342. Objects of the IProcessId class access numeric identifiers for processes. 
  4343.  
  4344. Presentation Manager Information 
  4345.  
  4346. IProcessId is an alias for the OS/2 Programmer's Toolkit type PID. 
  4347.  
  4348. Motif Information 
  4349.  
  4350. IProcessId is an alias for the system type pid_t. 
  4351.  
  4352.  
  4353. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IProcessId ΓòÉΓòÉΓòÉ
  4354.  
  4355. Constructors
  4356. IProcessId
  4357.  
  4358. Inherited Members
  4359. IHandle
  4360. asDebugInfo
  4361. asString
  4362. asUnsigned
  4363. operator Value
  4364.  
  4365. IBase
  4366. asDebugInfo
  4367. asString
  4368. messageFile
  4369. messageText
  4370. setMessageFile
  4371. version
  4372.  
  4373.  
  4374. ΓòÉΓòÉΓòÉ <hidden> IProcessId - Constructors ΓòÉΓòÉΓòÉ
  4375.  
  4376. You  can construct objects of this class. 
  4377.  
  4378.  
  4379. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IProcessId ΓòÉΓòÉΓòÉ
  4380.  
  4381. Inherited Members
  4382. IHandle
  4383. handle
  4384.  
  4385. IBase
  4386. recoverable
  4387. unrecoverable
  4388.  
  4389.  
  4390. ΓòÉΓòÉΓòÉ 1.13.1. IProcessId::IProcessId ΓòÉΓòÉΓòÉ
  4391.  
  4392. You can construct objects of this class from a process ID (a value of type 
  4393. IHandle::Value), which defaults to 0. 
  4394.  
  4395. public:
  4396. IProcessId(Value pid = 0);
  4397.  
  4398. Platform Support 
  4399.  
  4400. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4401. ΓöéPM          ΓöéMOTIF       Γöé
  4402. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4403. ΓöéYes         ΓöéYes         Γöé
  4404. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4405.  
  4406.  
  4407. ΓòÉΓòÉΓòÉ 1.14. IProfile ΓòÉΓòÉΓòÉ
  4408.  
  4409. Description 
  4410.  
  4411. Derivation 
  4412.  
  4413. Constructors 
  4414.  
  4415. Public Functions 
  4416.  
  4417. Protected Data 
  4418.  
  4419. Nested Types 
  4420.  
  4421. To close all the panels in a chapter, double click on this panel's system menu. 
  4422.  
  4423.  
  4424. ΓòÉΓòÉΓòÉ <hidden> Derivation - IProfile ΓòÉΓòÉΓòÉ
  4425.  
  4426. IBase
  4427.   Γöé
  4428. IVBase
  4429.   Γöé
  4430. IProfile
  4431.  
  4432. Inherited by none. 
  4433.  
  4434.  
  4435. ΓòÉΓòÉΓòÉ <hidden> Class Description - IProfile ΓòÉΓòÉΓòÉ
  4436.  
  4437. iprofile.hpp 
  4438.  
  4439. The IProfile class represents profile data sets. This class provides functions 
  4440. to query and set persistent application data based on application-defined keys. 
  4441.  
  4442. The profile data set stores information using the following two keys: 
  4443.  
  4444.      Application name, which is stored as a string 
  4445.      Key name, which is stored as either a string or an integer 
  4446.  Profile data can be stored in text, binary, or integer format. 
  4447.  
  4448.  Presentation Manager Information 
  4449.  
  4450.  The objects representing profile data sets are .ini files. 
  4451.  
  4452.  Note:  The number of .ini files that OS/2 Presentation Manager lets you open 
  4453.         at one time varies depending on system limitations. 
  4454.  
  4455.  Motif Information 
  4456.  
  4457.  The objects representing profile data sets are Xrm database files. 
  4458.  
  4459.  The profile data set stores information using the following two keys: 
  4460.  
  4461.      Application name, which is stored as a string 
  4462.      Key name, which is stored as a string 
  4463.  Both of these names must be stored as strings with no imbedded spaces. You 
  4464.  cannot store key names as integers. You can store the profile data itself as 
  4465.  text and integer values using the keys. 
  4466.  
  4467.  
  4468. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IProfile ΓòÉΓòÉΓòÉ
  4469.  
  4470. Constructors
  4471. IProfile
  4472. operator =
  4473. ~IProfile
  4474.  
  4475. Default Application Name
  4476. defaultApplicationName
  4477. setDefaultApplicationName
  4478.  
  4479. Profile Information
  4480. applicationOrKeyAt
  4481. handle
  4482. name
  4483. numberOfApplications
  4484. numberOfKeys
  4485.  
  4486. Reading and Writing Data
  4487. addOrReplaceElementWithKey
  4488. deleteElementWithApplication
  4489. deleteElementWithKey
  4490. elementWithKey
  4491. integerWithKey
  4492.  
  4493. Special Profiles
  4494. systemProfile
  4495. userProfile
  4496.  
  4497. Testing
  4498. containsApplication
  4499. containsKeyName
  4500.  
  4501. Inherited Members
  4502. IVBase
  4503. asDebugInfo
  4504. asString
  4505.  
  4506. IBase
  4507. asDebugInfo
  4508. asString
  4509. messageFile
  4510. messageText
  4511. setMessageFile
  4512. version
  4513.  
  4514.  
  4515. ΓòÉΓòÉΓòÉ <hidden> IProfile - Constructors ΓòÉΓòÉΓòÉ
  4516.  
  4517. Use these members to construct, copy, assign, and destruct objects of this 
  4518. class.  You can construct objects of this class by using the name of the 
  4519. profile data set or by using the copy constructor to copy one profile to 
  4520. another. 
  4521.  
  4522.  
  4523. ΓòÉΓòÉΓòÉ <hidden> IProfile - Default Application Name ΓòÉΓòÉΓòÉ
  4524.  
  4525. Use these members to get or set the default application name.  The default 
  4526. application name is a component of the keys that are used to access the 
  4527. profile.  This name is used by default for all reads and writes to the profile. 
  4528.  
  4529.  
  4530. ΓòÉΓòÉΓòÉ <hidden> IProfile - Hidden Members ΓòÉΓòÉΓòÉ
  4531.  
  4532. You cannot access these members. 
  4533.  
  4534.  
  4535. ΓòÉΓòÉΓòÉ <hidden> IProfile - Profile Information ΓòÉΓòÉΓòÉ
  4536.  
  4537. Use these members to access general profile information. 
  4538.  
  4539.  
  4540. ΓòÉΓòÉΓòÉ <hidden> IProfile - Reading and Writing Data ΓòÉΓòÉΓòÉ
  4541.  
  4542. Use these members to read or write application data for an application. 
  4543.  
  4544.  
  4545. ΓòÉΓòÉΓòÉ <hidden> IProfile - Special Profiles ΓòÉΓòÉΓòÉ
  4546.  
  4547. Use these members to return the special objects of this class that correspond 
  4548. to the system and user profiles. 
  4549.  
  4550.  
  4551. ΓòÉΓòÉΓòÉ <hidden> IProfile - Testing ΓòÉΓòÉΓòÉ
  4552.  
  4553. Use these members to test a profile for an application name or an application 
  4554. and key name pair. 
  4555.  
  4556.  
  4557. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IProfile ΓòÉΓòÉΓòÉ
  4558.  
  4559. Inherited Members
  4560. IBase
  4561. recoverable
  4562. unrecoverable
  4563.  
  4564.  
  4565. ΓòÉΓòÉΓòÉ 1.14.1. IProfile::addOrReplaceElementWithKey ΓòÉΓòÉΓòÉ
  4566.  
  4567. Writes the specified numeric, text, or binary data. You must specify text and 
  4568. binary data as an IString. 
  4569.  
  4570. Overload 1 
  4571.  
  4572. public:
  4573. virtual IProfile&
  4574.   addOrReplaceElementWithKey( const char* key,
  4575.                               long data,
  4576.                               const char* applName = 0);
  4577.  
  4578.  key            Pointer to a key name. 
  4579.  
  4580.  data           Long integer numeric to use for a write. 
  4581.  
  4582.  applName       Pointer to an application name.  If you do not supply a name, 
  4583.                 the default application name is used. 
  4584.  
  4585.  Use this version of the function if your data is numeric. 
  4586.  
  4587.  Platform Support 
  4588.  
  4589.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4590.   ΓöéPM          ΓöéMOTIF       Γöé
  4591.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4592.   ΓöéYes         ΓöéYes         Γöé
  4593.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4594.  
  4595.  Motif: AIX does not support the writing of binary data. 
  4596.  
  4597.  Exceptions 
  4598.  
  4599.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4600.   ΓöéIInvalidParameter   ΓöéThe application data was not written.   Γöé
  4601.   Γöé                    ΓöéThe key name is missing.                Γöé
  4602.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4603.   ΓöéIInvalidParameter   ΓöéThe application data was not written.   Γöé
  4604.   Γöé                    ΓöéThe application name is missing and a   Γöé
  4605.   Γöé                    Γöédefault has not been specified.         Γöé
  4606.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4607.   ΓöéIAccessError        ΓöéThe application data was not written.   Γöé
  4608.   Γöé                    ΓöéThe application name or key may be      Γöé
  4609.   Γöé                    Γöéinvalid.                                Γöé
  4610.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4611.  
  4612.  Used in sample:   Hello World Sample - Version 6: ahellow6.cpp 
  4613.  
  4614.  Overload 2 
  4615.  
  4616.   public:
  4617.   virtual IProfile&
  4618.     addOrReplaceElementWithKey( const char* key,
  4619.                                 const IString& data,
  4620.                                 const char* applName = 0);
  4621.  
  4622.  key            Pointer to a key name. 
  4623.  
  4624.  data           Reference to an IString that contains text or binary data to 
  4625.                 use for a write. 
  4626.  
  4627.  applName       Pointer to an application name.  If you do not supply a name, 
  4628.                 the default application name is used. 
  4629.  
  4630.  Use this version of the function if your data is in a text or binary format. 
  4631.  
  4632.  Platform Support 
  4633.  
  4634.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4635.   ΓöéPM          ΓöéMOTIF       Γöé
  4636.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4637.   ΓöéYes         ΓöéYes         Γöé
  4638.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4639.  
  4640.  Motif: AIX does not support the writing of binary data. 
  4641.  
  4642.  Exceptions 
  4643.  
  4644.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4645.   ΓöéIInvalidParameter   ΓöéThe application data was not written.   Γöé
  4646.   Γöé                    ΓöéThe key name is missing.                Γöé
  4647.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4648.   ΓöéIInvalidParameter   ΓöéThe application data was not written.   Γöé
  4649.   Γöé                    ΓöéThe application name is missing and a   Γöé
  4650.   Γöé                    Γöédefault has not been specified.         Γöé
  4651.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4652.   ΓöéIAccessError        ΓöéThe application data was not written.   Γöé
  4653.   Γöé                    ΓöéThe application name or key may be      Γöé
  4654.   Γöé                    Γöéinvalid.                                Γöé
  4655.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4656.  
  4657.  
  4658. ΓòÉΓòÉΓòÉ 1.14.2. IProfile::applicationOrKeyAt ΓòÉΓòÉΓòÉ
  4659.  
  4660. Returns the application name or key at the specified cursor. 
  4661.  
  4662. public:
  4663. virtual IString
  4664.   applicationOrKeyAt( const Cursor& cursor) const;
  4665.  
  4666.  cursor    Reference to a nested cursor that has been defined for this class. 
  4667.  
  4668.  Platform Support 
  4669.  
  4670.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4671.   ΓöéPM          ΓöéMOTIF       Γöé
  4672.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4673.   ΓöéYes         ΓöéYes         Γöé
  4674.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4675.  
  4676.  Exceptions 
  4677.  
  4678.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4679.   ΓöéIInvalidParameter   ΓöéThe application name or key was not     Γöé
  4680.   Γöé                    Γöéreturned.  The cursor is invalid.       Γöé
  4681.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4682.  
  4683.  
  4684. ΓòÉΓòÉΓòÉ 1.14.3. IProfile::containsApplication ΓòÉΓòÉΓòÉ
  4685.  
  4686. If the profile contains data for the specified application name, returns true. 
  4687.  
  4688. public:
  4689. virtual Boolean
  4690.   containsApplication( const char* applName) const;
  4691.  
  4692.  applName  Pointer to an application name. 
  4693.  
  4694.  Platform Support 
  4695.  
  4696.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4697.   ΓöéPM          ΓöéMOTIF       Γöé
  4698.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4699.   ΓöéYes         ΓöéYes         Γöé
  4700.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4701.  
  4702.  Exceptions 
  4703.  
  4704.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4705.   ΓöéIInvalidParameter   ΓöéThe profile query was not returned.  TheΓöé
  4706.   Γöé                    Γöéapplication name is missing.            Γöé
  4707.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4708.  
  4709.  
  4710. ΓòÉΓòÉΓòÉ 1.14.4. IProfile::containsKeyName ΓòÉΓòÉΓòÉ
  4711.  
  4712. If the profile contains data for the specified application and key pair, 
  4713. returns true. 
  4714.  
  4715. public:
  4716. virtual Boolean
  4717.   containsKeyName( const char* key,
  4718.                    const char* applName = 0) const;
  4719.  
  4720.  key       Pointer to a key name. 
  4721.  
  4722.  applName  Pointer to an application name.  If you do not supply a name, the 
  4723.            default application name is used. 
  4724.  
  4725.  Platform Support 
  4726.  
  4727.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4728.   ΓöéPM          ΓöéMOTIF       Γöé
  4729.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4730.   ΓöéYes         ΓöéYes         Γöé
  4731.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4732.  
  4733.  
  4734. ΓòÉΓòÉΓòÉ 1.14.5. IProfile::defaultApplicationName ΓòÉΓòÉΓòÉ
  4735.  
  4736. Returns the default application name. 
  4737.  
  4738. public:
  4739. virtual IString defaultApplicationName() const;
  4740.  
  4741. Platform Support 
  4742.  
  4743. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4744. ΓöéPM          ΓöéMOTIF       Γöé
  4745. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4746. ΓöéYes         ΓöéYes         Γöé
  4747. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4748.  
  4749.  
  4750. ΓòÉΓòÉΓòÉ 1.14.6. IProfile::deleteElementWithApplication ΓòÉΓòÉΓòÉ
  4751.  
  4752. Removes the data for all keys for the specified application name. 
  4753.  
  4754. public:
  4755. virtual IProfile&
  4756.   deleteElementWithApplication( const char* applName = 0);
  4757.  
  4758.  applName  Pointer to an application name.  If you do not supply a name, the 
  4759.            default application name is used. 
  4760.  
  4761.  Platform Support 
  4762.  
  4763.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4764.   ΓöéPM          ΓöéMOTIF       Γöé
  4765.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4766.   ΓöéYes         ΓöéYes         Γöé
  4767.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4768.  
  4769.  Exceptions 
  4770.  
  4771.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4772.   ΓöéIInvalidParameter   ΓöéThe application data was not removed.   Γöé
  4773.   Γöé                    ΓöéThe application name is missing and a   Γöé
  4774.   Γöé                    Γöédefault has not been specified.         Γöé
  4775.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4776.   ΓöéIAccessError        ΓöéThe application data was not removed.   Γöé
  4777.   Γöé                    ΓöéThe application name may be invalid.    Γöé
  4778.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4779.  
  4780.  
  4781. ΓòÉΓòÉΓòÉ 1.14.7. IProfile::deleteElementWithKey ΓòÉΓòÉΓòÉ
  4782.  
  4783. Removes the data at the specified application and key name pair. 
  4784.  
  4785. public:
  4786. virtual IProfile&
  4787.   deleteElementWithKey( const char* key,
  4788.                         const char* applName = 0);
  4789.  
  4790.  key       Pointer to a key name. 
  4791.  
  4792.  applName  Pointer to an application name.  If you do not supply a name, the 
  4793.            default application name is used. 
  4794.  
  4795.  Platform Support 
  4796.  
  4797.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4798.   ΓöéPM          ΓöéMOTIF       Γöé
  4799.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4800.   ΓöéYes         ΓöéYes         Γöé
  4801.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4802.  
  4803.  Exceptions 
  4804.  
  4805.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4806.   ΓöéIInvalidParameter   ΓöéThe application data was not removed.   Γöé
  4807.   Γöé                    ΓöéThe key name is missing.                Γöé
  4808.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4809.   ΓöéIInvalidParameter   ΓöéThe application data was not removed.   Γöé
  4810.   Γöé                    ΓöéThe application name is missing and a   Γöé
  4811.   Γöé                    Γöédefault has not been specified.         Γöé
  4812.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4813.   ΓöéIAccessError        ΓöéThe application data was not removed.   Γöé
  4814.   Γöé                    ΓöéThe application name or key may be      Γöé
  4815.   Γöé                    Γöéinvalid.                                Γöé
  4816.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4817.  
  4818.  
  4819. ΓòÉΓòÉΓòÉ 1.14.8. IProfile::elementWithKey ΓòÉΓòÉΓòÉ
  4820.  
  4821. Reads the application data and returns it as an IString. 
  4822.  
  4823. public:
  4824. virtual IString
  4825.   elementWithKey( const char* key,
  4826.                   const char* applName = 0) const;
  4827.  
  4828.  key       Pointer to a key name. 
  4829.  
  4830.  applName  Pointer to an application name.  If you do not supply a name, the 
  4831.            default application name is used. 
  4832.  
  4833.  Platform Support 
  4834.  
  4835.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4836.   ΓöéPM          ΓöéMOTIF       Γöé
  4837.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4838.   ΓöéYes         ΓöéYes         Γöé
  4839.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4840.  
  4841.  Exceptions 
  4842.  
  4843.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4844.   ΓöéIInvalidParameter   ΓöéThe application data was not read.  The Γöé
  4845.   Γöé                    Γöékey name is missing.                    Γöé
  4846.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4847.   ΓöéIInvalidParameter   ΓöéThe application data was not read.  The Γöé
  4848.   Γöé                    Γöéapplication name is missing and a       Γöé
  4849.   Γöé                    Γöédefault has not been specified.         Γöé
  4850.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4851.   ΓöéIAccessError        ΓöéThe application data was not read.  The Γöé
  4852.   Γöé                    Γöéapplication name or key may be invalid. Γöé
  4853.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4854.   ΓöéIInvalidRequest     ΓöéThe application data was not read.  The Γöé
  4855.   Γöé                    Γöéapplication name or key may be invalid. Γöé
  4856.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4857.  
  4858.  Used in sample:   Hello World Sample - Version 6: ahellow6.cpp 
  4859.  
  4860.  
  4861. ΓòÉΓòÉΓòÉ 1.14.9. IProfile::handle ΓòÉΓòÉΓòÉ
  4862.  
  4863. Returns the profile handle. 
  4864.  
  4865. public:
  4866. virtual IProfileHandle handle() const;
  4867.  
  4868. Platform Support 
  4869.  
  4870. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4871. ΓöéPM          ΓöéMOTIF       Γöé
  4872. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4873. ΓöéYes         ΓöéYes         Γöé
  4874. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4875.  
  4876.  
  4877. ΓòÉΓòÉΓòÉ 1.14.10. IProfile::integerWithKey ΓòÉΓòÉΓòÉ
  4878.  
  4879. Reads the application data and returns it as a long integer. 
  4880.  
  4881. public:
  4882. virtual long
  4883.   integerWithKey( const char* key,
  4884.                   const char* applName = 0) const;
  4885.  
  4886.  key       Pointer to a key name. 
  4887.  
  4888.  applName  Pointer to an application name.  If you do not supply a name, the 
  4889.            default application name is used. 
  4890.  
  4891.  Platform Support 
  4892.  
  4893.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4894.   ΓöéPM          ΓöéMOTIF       Γöé
  4895.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4896.   ΓöéYes         ΓöéYes         Γöé
  4897.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4898.  
  4899.  Exceptions 
  4900.  
  4901.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4902.   ΓöéIInvalidParameter   ΓöéThe application data was not read.  The Γöé
  4903.   Γöé                    Γöékey name is missing.                    Γöé
  4904.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4905.   ΓöéIInvalidParameter   ΓöéThe application data was not read.  The Γöé
  4906.   Γöé                    Γöéapplication name is missing and a       Γöé
  4907.   Γöé                    Γöédefault has not been specified.         Γöé
  4908.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4909.   ΓöéIAccessError        ΓöéThe application data was not read.  The Γöé
  4910.   Γöé                    Γöéapplication name or key may be invalid. Γöé
  4911.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4912.  
  4913.  Used in sample:   Hello World Sample - Version 6: ahellow6.cpp 
  4914.  
  4915.  
  4916. ΓòÉΓòÉΓòÉ 1.14.11. IProfile::IProfile ΓòÉΓòÉΓòÉ
  4917.  
  4918. Use these members to construct, copy, assign, and destruct objects of this 
  4919. class.  You can construct objects of this class by using the name of the 
  4920. profile data set or by using the copy constructor to copy one profile to 
  4921. another. 
  4922.  
  4923. Overload 1 
  4924.  
  4925. public:
  4926. IProfile(const char* profileName);
  4927.  
  4928.  profileName Pointer to the profile name. 
  4929.  
  4930.  Create a profile object with the specified profile name. 
  4931.  
  4932.  Platform Support 
  4933.  
  4934.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4935.   ΓöéPM          ΓöéMOTIF       Γöé
  4936.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4937.   ΓöéYes         ΓöéYes         Γöé
  4938.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4939.  
  4940.  Exceptions 
  4941.  
  4942.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4943.   ΓöéIInvalidParameter   ΓöéThe IProfile object was not constructed.Γöé
  4944.   Γöé                    ΓöéThe profile name is missing.            Γöé
  4945.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4946.   ΓöéIAccessError        ΓöéThe IProfile object was not constructed.Γöé
  4947.   Γöé                    ΓöéThe profile name may be invalid.        Γöé
  4948.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4949.  
  4950.  Used in samples: 
  4951.  
  4952.       Hello World Sample - Version 6: ahellow6.cpp 
  4953.       Lancelot - A Valiant Example: lancelot.cpp 
  4954.  
  4955.  Overload 2 
  4956.  
  4957.   public:
  4958.   IProfile(const IProfile& aProfile);
  4959.  
  4960.  aProfile  Reference to an existing profile object. 
  4961.  
  4962.  Create a profile object using a reference to an existing profile object.  Use 
  4963.  this constructor if you want to make a copy of an existing profile object. 
  4964.  
  4965.  Platform Support 
  4966.  
  4967.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4968.   ΓöéPM          ΓöéMOTIF       Γöé
  4969.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4970.   ΓöéYes         ΓöéYes         Γöé
  4971.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4972.  
  4973.  Exceptions 
  4974.  
  4975.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4976.   ΓöéIAccessError        ΓöéThe IProfile object was not constructed.Γöé
  4977.   Γöé                    ΓöéThe profile name may be invalid.        Γöé
  4978.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4979.  
  4980.  
  4981. ΓòÉΓòÉΓòÉ 1.14.12. IProfile::name ΓòÉΓòÉΓòÉ
  4982.  
  4983. Returns the profile's file name. 
  4984.  
  4985. public:
  4986. virtual IString name() const;
  4987.  
  4988. Platform Support 
  4989.  
  4990. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  4991. ΓöéPM          ΓöéMOTIF       Γöé
  4992. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  4993. ΓöéYes         ΓöéYes         Γöé
  4994. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  4995.  
  4996.  
  4997. ΓòÉΓòÉΓòÉ 1.14.13. IProfile::numberOfApplications ΓòÉΓòÉΓòÉ
  4998.  
  4999. Returns the number of application names in the profile. 
  5000.  
  5001. public:
  5002. virtual unsigned long numberOfApplications() const;
  5003.  
  5004. Platform Support 
  5005.  
  5006. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5007. ΓöéPM          ΓöéMOTIF       Γöé
  5008. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5009. ΓöéYes         ΓöéIgnored     Γöé
  5010. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5011.  
  5012.  
  5013. ΓòÉΓòÉΓòÉ 1.14.14. IProfile::numberOfKeys ΓòÉΓòÉΓòÉ
  5014.  
  5015. Returns the number of keys for the application name. 
  5016.  
  5017. public:
  5018. virtual unsigned long
  5019.   numberOfKeys( const char* applName = 0) const;
  5020.  
  5021.  applName  Pointer to an application name.  If you do not supply a name, the 
  5022.            default application name is used. 
  5023.  
  5024.  Platform Support 
  5025.  
  5026.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5027.   ΓöéPM          ΓöéMOTIF       Γöé
  5028.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5029.   ΓöéYes         ΓöéYes         Γöé
  5030.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5031.  
  5032.  Exceptions 
  5033.  
  5034.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5035.   ΓöéIInvalidParameter   ΓöéThe number of keys was not returned.    Γöé
  5036.   Γöé                    ΓöéThe application name is missing and a   Γöé
  5037.   Γöé                    Γöédefault has not been specified.         Γöé
  5038.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5039.  
  5040.  
  5041. ΓòÉΓòÉΓòÉ 1.14.15. IProfile::operator = ΓòÉΓòÉΓòÉ
  5042.  
  5043. Assigns the member data of an object of this class to another object of this 
  5044. class. 
  5045.  
  5046. public:
  5047. IProfile& operator =(const IProfile& aProfile);
  5048.  
  5049.  aProfile  Reference to an existing profile object. 
  5050.  
  5051.  Platform Support 
  5052.  
  5053.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5054.   ΓöéPM          ΓöéMOTIF       Γöé
  5055.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5056.   ΓöéYes         ΓöéYes         Γöé
  5057.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5058.  
  5059.  Exceptions 
  5060.  
  5061.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5062.   ΓöéIAccessError        ΓöéThe IProfile object was not assigned.   Γöé
  5063.   Γöé                    ΓöéThe profile name may be invalid.        Γöé
  5064.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5065.  
  5066.  
  5067. ΓòÉΓòÉΓòÉ 1.14.16. IProfile::setDefaultApplicationName ΓòÉΓòÉΓòÉ
  5068.  
  5069. Sets the default application name. All subsequent calls that do not supply an 
  5070. application name to functions of this class use this default name. 
  5071.  
  5072. public:
  5073. virtual IProfile&
  5074.   setDefaultApplicationName( const char* applName);
  5075.  
  5076.  applName  Pointer to an application name. 
  5077.  
  5078.  Platform Support 
  5079.  
  5080.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5081.   ΓöéPM          ΓöéMOTIF       Γöé
  5082.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5083.   ΓöéYes         ΓöéYes         Γöé
  5084.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5085.  
  5086.  Used in sample:   Hello World Sample - Version 6: ahellow6.cpp 
  5087.  
  5088.  
  5089. ΓòÉΓòÉΓòÉ 1.14.17. IProfile::systemProfile ΓòÉΓòÉΓòÉ
  5090.  
  5091. Returns the system profile. 
  5092.  
  5093. public:
  5094. static IProfile systemProfile();
  5095.  
  5096. Platform Support 
  5097.  
  5098. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5099. ΓöéPM          ΓöéMOTIF       Γöé
  5100. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5101. ΓöéYes         ΓöéNo          Γöé
  5102. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5103.  
  5104.  
  5105. ΓòÉΓòÉΓòÉ 1.14.18. IProfile::userProfile ΓòÉΓòÉΓòÉ
  5106.  
  5107. Returns the user profile. 
  5108.  
  5109. public:
  5110. static IProfile userProfile();
  5111.  
  5112. Platform Support 
  5113.  
  5114. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5115. ΓöéPM          ΓöéMOTIF       Γöé
  5116. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5117. ΓöéYes         ΓöéNo          Γöé
  5118. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5119.  
  5120.  
  5121. ΓòÉΓòÉΓòÉ 1.14.19. IProfile::~IProfile ΓòÉΓòÉΓòÉ
  5122.  
  5123. This destructor closes the profile data set. 
  5124.  
  5125. public:
  5126. virtual  ~IProfile();
  5127.  
  5128. Platform Support 
  5129.  
  5130. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5131. ΓöéPM          ΓöéMOTIF       Γöé
  5132. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5133. ΓöéYes         ΓöéYes         Γöé
  5134. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5135.  
  5136.  
  5137. ΓòÉΓòÉΓòÉ <hidden> Nested Types - IProfile ΓòÉΓòÉΓòÉ
  5138.  
  5139. Classes 
  5140.  
  5141.        IProfile::Cursor 
  5142.  
  5143.  
  5144. ΓòÉΓòÉΓòÉ 1.15. IProfile::Cursor ΓòÉΓòÉΓòÉ
  5145.  
  5146. Description 
  5147.  
  5148. Derivation 
  5149.  
  5150. Constructors 
  5151.  
  5152. Public Functions 
  5153.  
  5154. Protected Data 
  5155.  
  5156. To close all the panels in a chapter, double click on this panel's system menu. 
  5157.  
  5158.  
  5159. ΓòÉΓòÉΓòÉ <hidden> Derivation - IProfile::Cursor ΓòÉΓòÉΓòÉ
  5160.  
  5161. IBase
  5162.   Γöé
  5163. IVBase
  5164.   Γöé
  5165. IProfile::Cursor
  5166.  
  5167. Inherited by none. 
  5168.  
  5169.  
  5170. ΓòÉΓòÉΓòÉ <hidden> Class Description - IProfile::Cursor ΓòÉΓòÉΓòÉ
  5171.  
  5172. iprofile.hpp 
  5173.  
  5174. The IProfile::Cursor class creates and manages the cursor for an IProfile 
  5175. object. IProfile uses this cursor to iterate through the application names or 
  5176. keys in a profile. In the same way that you can use a cursor to iterate through 
  5177. the objects in a collection, you can use this cursor to iterate through a 
  5178. profile one item at a time. 
  5179.  
  5180.  
  5181. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IProfile::Cursor ΓòÉΓòÉΓòÉ
  5182.  
  5183. Constructors
  5184. Cursor
  5185. ~Cursor
  5186.  
  5187. Profile Iteration
  5188. invalidate
  5189. isValid
  5190. setToFirst
  5191. setToLast
  5192. setToNext
  5193. setToPrevious
  5194.  
  5195. Inherited Members
  5196. IVBase
  5197. asDebugInfo
  5198. asString
  5199.  
  5200. IBase
  5201. asDebugInfo
  5202. asString
  5203. messageFile
  5204. messageText
  5205. setMessageFile
  5206. version
  5207.  
  5208.  
  5209. ΓòÉΓòÉΓòÉ <hidden> IProfile::Cursor - Constructors ΓòÉΓòÉΓòÉ
  5210.  
  5211. Use these members to construct and destruct objects of this nested class. You 
  5212. can construct objects of this class by using a reference to the profile, or a 
  5213. reference to the profile data and an application name. 
  5214.  
  5215.  
  5216. ΓòÉΓòÉΓòÉ <hidden> IProfile::Cursor - Profile Iteration ΓòÉΓòÉΓòÉ
  5217.  
  5218. Use these members to iterate through the application names or keys in a 
  5219. profile. 
  5220.  
  5221.  
  5222. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IProfile::Cursor ΓòÉΓòÉΓòÉ
  5223.  
  5224. Inherited Members
  5225. IBase
  5226. recoverable
  5227. unrecoverable
  5228.  
  5229.  
  5230. ΓòÉΓòÉΓòÉ 1.15.1. IProfile::Cursor::Cursor ΓòÉΓòÉΓòÉ
  5231.  
  5232. Note:  The cursor object is invalidated for the current state of application 
  5233.        names or key names in the profile data set. 
  5234.  
  5235.  Overload 1 
  5236.  
  5237.   public:
  5238.   Cursor(IProfile& profile);
  5239.  
  5240.  profile   Reference to the profile object. 
  5241.  
  5242.  You can construct an object of this class by using a reference to the profile. 
  5243.  Use this constructor to create a cursor to iterate through the application 
  5244.  names. 
  5245.  
  5246.  Platform Support 
  5247.  
  5248.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5249.   ΓöéPM          ΓöéMOTIF       Γöé
  5250.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5251.   ΓöéYes         ΓöéYes         Γöé
  5252.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5253.  
  5254.  Overload 2 
  5255.  
  5256.   public:
  5257.   Cursor(IProfile& profile, const char* applName);
  5258.  
  5259.  profile   Reference to the profile object. 
  5260.  
  5261.  applName  Pointer to an application name. 
  5262.  
  5263.  You can construct an object of this class by using a reference to the profile 
  5264.  and an application name.  Use this constructor to create a cursor to iterate 
  5265.  through the keys. 
  5266.  
  5267.  Platform Support 
  5268.  
  5269.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5270.   ΓöéPM          ΓöéMOTIF       Γöé
  5271.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5272.   ΓöéYes         ΓöéYes         Γöé
  5273.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5274.  
  5275.  
  5276. ΓòÉΓòÉΓòÉ 1.15.2. IProfile::Cursor::invalidate ΓòÉΓòÉΓòÉ
  5277.  
  5278. Marks the cursor as invalid. 
  5279.  
  5280. public:
  5281. virtual void invalidate();
  5282.  
  5283. Platform Support 
  5284.  
  5285. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5286. ΓöéPM          ΓöéMOTIF       Γöé
  5287. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5288. ΓöéYes         ΓöéYes         Γöé
  5289. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5290.  
  5291.  
  5292. ΓòÉΓòÉΓòÉ 1.15.3. IProfile::Cursor::isValid ΓòÉΓòÉΓòÉ
  5293.  
  5294. Determines if the cursor is still valid. If the cursor is valid, returns true. 
  5295. If the parameter, checkFile, is set to true, this function checks to see if the 
  5296. data set's application and key information has been changed by another 
  5297. application while your application still has the data set open. 
  5298.  
  5299. public:
  5300. virtual Boolean isValid(Boolean checkFile = false) const;
  5301.  
  5302.  checkFile Boolean flag to query if another application has changed the 
  5303.            application and key information, thus rendering the cursor invalid. 
  5304.  
  5305.  Platform Support 
  5306.  
  5307.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5308.   ΓöéPM          ΓöéMOTIF       Γöé
  5309.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5310.   ΓöéYes         ΓöéYes         Γöé
  5311.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5312.  
  5313.  Presentation Manager: If checkFile is set to true, this function determines 
  5314.  whether the file application and key information have been changed by another 
  5315.  application while your application still has them open. 
  5316.  
  5317.  Motif: AIX does not support checkFile. 
  5318.  
  5319.  
  5320. ΓòÉΓòÉΓòÉ 1.15.4. IProfile::Cursor::setToFirst ΓòÉΓòÉΓòÉ
  5321.  
  5322. Sets the cursor's position to the first application or key. 
  5323.  
  5324. public:
  5325. virtual Boolean setToFirst();
  5326.  
  5327. Platform Support 
  5328.  
  5329. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5330. ΓöéPM          ΓöéMOTIF       Γöé
  5331. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5332. ΓöéYes         ΓöéYes         Γöé
  5333. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5334.  
  5335.  
  5336. ΓòÉΓòÉΓòÉ 1.15.5. IProfile::Cursor::setToLast ΓòÉΓòÉΓòÉ
  5337.  
  5338. Sets the cursor's position to the last application or key. 
  5339.  
  5340. public:
  5341. virtual Boolean setToLast();
  5342.  
  5343. Platform Support 
  5344.  
  5345. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5346. ΓöéPM          ΓöéMOTIF       Γöé
  5347. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5348. ΓöéYes         ΓöéYes         Γöé
  5349. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5350.  
  5351.  
  5352. ΓòÉΓòÉΓòÉ 1.15.6. IProfile::Cursor::setToNext ΓòÉΓòÉΓòÉ
  5353.  
  5354. Sets the cursor's position to the next application or key. 
  5355.  
  5356. public:
  5357. virtual Boolean setToNext();
  5358.  
  5359. Platform Support 
  5360.  
  5361. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5362. ΓöéPM          ΓöéMOTIF       Γöé
  5363. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5364. ΓöéYes         ΓöéYes         Γöé
  5365. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5366.  
  5367.  
  5368. ΓòÉΓòÉΓòÉ 1.15.7. IProfile::Cursor::setToPrevious ΓòÉΓòÉΓòÉ
  5369.  
  5370. Set the cursor's position to the previous application or key. 
  5371.  
  5372. public:
  5373. virtual Boolean setToPrevious();
  5374.  
  5375. Platform Support 
  5376.  
  5377. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5378. ΓöéPM          ΓöéMOTIF       Γöé
  5379. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5380. ΓöéYes         ΓöéYes         Γöé
  5381. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5382.  
  5383.  
  5384. ΓòÉΓòÉΓòÉ 1.15.8. IProfile::Cursor::~Cursor ΓòÉΓòÉΓòÉ
  5385.  
  5386. public:
  5387. virtual  ~Cursor();
  5388.  
  5389. Platform Support 
  5390.  
  5391. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5392. ΓöéPM          ΓöéMOTIF       Γöé
  5393. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5394. ΓöéYes         ΓöéYes         Γöé
  5395. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5396.  
  5397.  
  5398. ΓòÉΓòÉΓòÉ 1.16. IProfileHandle ΓòÉΓòÉΓòÉ
  5399.  
  5400. Description 
  5401.  
  5402. Derivation 
  5403.  
  5404. Constructors 
  5405.  
  5406. Public Functions 
  5407.  
  5408. Protected Data 
  5409.  
  5410. To close all the panels in a chapter, double click on this panel's system menu. 
  5411.  
  5412.  
  5413. ΓòÉΓòÉΓòÉ <hidden> Derivation - IProfileHandle ΓòÉΓòÉΓòÉ
  5414.  
  5415. IBase
  5416.   Γöé
  5417. IHandle
  5418.   Γöé
  5419. IProfileHandle
  5420.  
  5421. Inherited by none. 
  5422.  
  5423.  
  5424. ΓòÉΓòÉΓòÉ <hidden> Class Description - IProfileHandle ΓòÉΓòÉΓòÉ
  5425.  
  5426. ihandle.hpp 
  5427.  
  5428. Objects of the IProfileHandle class access profiles. 
  5429.  
  5430. Presentation Manager Information 
  5431.  
  5432. IProfileHandle is an alias for the OS/2 Programmer's Toolkit type HINI. 
  5433.  
  5434. Motif Information 
  5435.  
  5436. IProfileHandle is an alias for the X/Motif types XrmHashBucket and XrmDatabase. 
  5437.  
  5438.  
  5439. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IProfileHandle ΓòÉΓòÉΓòÉ
  5440.  
  5441. Constructors
  5442. IProfileHandle
  5443.  
  5444. Operators
  5445. operator _XrmHashBucketRec *
  5446.  
  5447. Inherited Members
  5448. IHandle
  5449. asDebugInfo
  5450. asString
  5451. asUnsigned
  5452. operator Value
  5453.  
  5454. IBase
  5455. asDebugInfo
  5456. asString
  5457. messageFile
  5458. messageText
  5459. setMessageFile
  5460. version
  5461.  
  5462.  
  5463. ΓòÉΓòÉΓòÉ <hidden> IProfileHandle - Constructors ΓòÉΓòÉΓòÉ
  5464.  
  5465. You can construct objects of this class. 
  5466.  
  5467.  
  5468. ΓòÉΓòÉΓòÉ <hidden> IProfileHandle - Operators ΓòÉΓòÉΓòÉ
  5469.  
  5470. These members are the operators for this class. 
  5471.  
  5472.  
  5473. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IProfileHandle ΓòÉΓòÉΓòÉ
  5474.  
  5475. Inherited Members
  5476. IHandle
  5477. handle
  5478.  
  5479. IBase
  5480. recoverable
  5481. unrecoverable
  5482.  
  5483.  
  5484. ΓòÉΓòÉΓòÉ 1.16.1. IProfileHandle::IProfileHandle ΓòÉΓòÉΓòÉ
  5485.  
  5486. You can construct objects of this class. 
  5487.  
  5488. Overload 1 
  5489.  
  5490. public:
  5491. IProfileHandle(Value hini = 0);
  5492.  
  5493. You can construct objects of this class from a profile handle (a value of type 
  5494. IHandle::Value), which defaults to 0. 
  5495.  
  5496. Platform Support 
  5497.  
  5498. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5499. ΓöéPM          ΓöéMOTIF       Γöé
  5500. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5501. ΓöéYes         ΓöéYes         Γöé
  5502. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5503.  
  5504. Overload 2 
  5505.  
  5506. public:
  5507. IProfileHandle(_XrmHashBucketRec* hini);
  5508.  
  5509. You can construct objects of this class from a profile handle. 
  5510.  
  5511. Platform Support 
  5512.  
  5513. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5514. ΓöéPM          ΓöéMOTIF       Γöé
  5515. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5516. ΓöéNo          ΓöéYes         Γöé
  5517. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5518.  
  5519. Overload 3 
  5520.  
  5521. public:
  5522. IProfileHandle(int hini);
  5523.  
  5524. You can construct objects of this class from a profile handle. 
  5525.  
  5526. Platform Support 
  5527.  
  5528. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5529. ΓöéPM          ΓöéMOTIF       Γöé
  5530. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5531. ΓöéNo          ΓöéYes         Γöé
  5532. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5533.  
  5534.  
  5535. ΓòÉΓòÉΓòÉ 1.16.2. IProfileHandle::operator _XrmHashBucketRec * ΓòÉΓòÉΓòÉ
  5536.  
  5537. Returns the handle value as a native X-Toolkit handle object. 
  5538.  
  5539. public:
  5540. operator _XrmHashBucketRec *() const;
  5541.  
  5542. Platform Support 
  5543.  
  5544. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5545. ΓöéPM          ΓöéMOTIF       Γöé
  5546. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5547. ΓöéNo          ΓöéYes         Γöé
  5548. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5549.  
  5550.  
  5551. ΓòÉΓòÉΓòÉ 1.17. IResource ΓòÉΓòÉΓòÉ
  5552.  
  5553. Description 
  5554.  
  5555. Derivation 
  5556.  
  5557. Constructors 
  5558.  
  5559. Public Functions 
  5560.  
  5561. Protected Functions 
  5562.  
  5563. Protected Data 
  5564.  
  5565. To close all the panels in a chapter, double click on this panel's system menu. 
  5566.  
  5567.  
  5568. ΓòÉΓòÉΓòÉ <hidden> Derivation - IResource ΓòÉΓòÉΓòÉ
  5569.  
  5570. IBase
  5571.   Γöé
  5572. IVBase
  5573.   Γöé
  5574. IResource
  5575.  
  5576. Inherited by: 
  5577.  
  5578.       IPrivateResource 
  5579.       ISharedResource 
  5580.  
  5581.  
  5582. ΓòÉΓòÉΓòÉ <hidden> Class Description - IResource ΓòÉΓòÉΓòÉ
  5583.  
  5584. ireslock.hpp 
  5585.  
  5586. The IResource class is the virtual base resource class.  Use a derived class to 
  5587. identify a serially reusable resource.  These resources can be limited to the 
  5588. current process, as described by the IPrivateResource class, or they can be 
  5589. shared across multiple processes, as described by ISharedResource class. 
  5590.  
  5591.  
  5592. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IResource ΓòÉΓòÉΓòÉ
  5593.  
  5594. Constructors
  5595. IResource
  5596. ~IResource
  5597.  
  5598. Resource Locking
  5599. lock
  5600. unlock
  5601.  
  5602. Inherited Members
  5603. IVBase
  5604. asDebugInfo
  5605. asString
  5606.  
  5607. IBase
  5608. asDebugInfo
  5609. asString
  5610. messageFile
  5611. messageText
  5612. setMessageFile
  5613. version
  5614.  
  5615.  
  5616. ΓòÉΓòÉΓòÉ <hidden> IResource - Constructors ΓòÉΓòÉΓòÉ
  5617.  
  5618. You cannot construct or destruct objects of this class.  Derive a new class 
  5619. from this class to identify a serially reusable resource if the derived User 
  5620. Interface Class Library classes do not meet your needs. 
  5621.  
  5622.  
  5623. ΓòÉΓòÉΓòÉ <hidden> IResource - Hidden Members ΓòÉΓòÉΓòÉ
  5624.  
  5625. You cannot access these members. 
  5626.  
  5627.  
  5628. ΓòÉΓòÉΓòÉ <hidden> IResource - Resource Handle ΓòÉΓòÉΓòÉ
  5629.  
  5630. Use these members to obtain a handle to the resource. 
  5631.  
  5632.  
  5633. ΓòÉΓòÉΓòÉ <hidden> IResource - Resource Locking ΓòÉΓòÉΓòÉ
  5634.  
  5635. Use resource locking members to acquire or release a serialized access to this 
  5636. resource. 
  5637.  
  5638.  
  5639. ΓòÉΓòÉΓòÉ <hidden> Protected Functions - IResource ΓòÉΓòÉΓòÉ
  5640.  
  5641. Resource Handle
  5642. handle
  5643.  
  5644.  
  5645. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IResource ΓòÉΓòÉΓòÉ
  5646.  
  5647. Inherited Members
  5648. IBase
  5649. recoverable
  5650. unrecoverable
  5651.  
  5652.  
  5653. ΓòÉΓòÉΓòÉ 1.17.1. IResource::handle ΓòÉΓòÉΓòÉ
  5654.  
  5655. Returns the handle for the resource. 
  5656.  
  5657. protected:
  5658. virtual ISemaphoreHandle& handle() = 0;
  5659.  
  5660. Platform Support 
  5661.  
  5662. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5663. ΓöéPM          ΓöéMOTIF       Γöé
  5664. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5665. ΓöéYes         ΓöéYes         Γöé
  5666. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5667.  
  5668.  
  5669. ΓòÉΓòÉΓòÉ 1.17.2. IResource::IResource ΓòÉΓòÉΓòÉ
  5670.  
  5671. This function is the default constructor for this class. 
  5672.  
  5673. public:
  5674. IResource();
  5675.  
  5676. Platform Support 
  5677.  
  5678. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5679. ΓöéPM          ΓöéMOTIF       Γöé
  5680. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5681. ΓöéYes         ΓöéYes         Γöé
  5682. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5683.  
  5684.  
  5685. ΓòÉΓòÉΓòÉ 1.17.3. IResource::lock ΓòÉΓòÉΓòÉ
  5686.  
  5687. Acquires serialized access to the resource, preventing other threads of 
  5688. execution from accessing it. You can specify the value for timeout in 
  5689. milliseconds with -1 indicating an indefinite wait and 0 requesting an 
  5690. immediate return. 
  5691.  
  5692. public:
  5693. virtual IResource& lock(long timeOut = - 1);
  5694.  
  5695.  timeOut   Long value that represents in milliseconds how long to wait for this 
  5696.            resource.  The default value is an indefinite wait. 
  5697.  
  5698.  Platform Support 
  5699.  
  5700.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5701.   ΓöéPM          ΓöéMOTIF       Γöé
  5702.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5703.   ΓöéYes         ΓöéYes         Γöé
  5704.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5705.  
  5706.  Motif: The X timer services used to implement the resource lock timeout have a 
  5707.  resolution of one second.  The lock function rounds up the specified timeout 
  5708.  value to the next one-second interval. 
  5709.  
  5710.  
  5711. ΓòÉΓòÉΓòÉ 1.17.4. IResource::unlock ΓòÉΓòÉΓòÉ
  5712.  
  5713. Releases access to the resource, allowing other threads of execution to access 
  5714. it. 
  5715.  
  5716. public:
  5717. virtual IResource& unlock();
  5718.  
  5719. Platform Support 
  5720.  
  5721. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5722. ΓöéPM          ΓöéMOTIF       Γöé
  5723. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5724. ΓöéYes         ΓöéYes         Γöé
  5725. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5726.  
  5727.  
  5728. ΓòÉΓòÉΓòÉ 1.17.5. IResource::~IResource ΓòÉΓòÉΓòÉ
  5729.  
  5730. public:
  5731. virtual  ~IResource();
  5732.  
  5733. Platform Support 
  5734.  
  5735. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5736. ΓöéPM          ΓöéMOTIF       Γöé
  5737. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5738. ΓöéYes         ΓöéYes         Γöé
  5739. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5740.  
  5741.  
  5742. ΓòÉΓòÉΓòÉ 1.18. IResourceId ΓòÉΓòÉΓòÉ
  5743.  
  5744. Description 
  5745.  
  5746. Derivation 
  5747.  
  5748. Constructors 
  5749.  
  5750. Public Functions 
  5751.  
  5752. Protected Data 
  5753.  
  5754. To close all the panels in a chapter, double click on this panel's system menu. 
  5755.  
  5756.  
  5757. ΓòÉΓòÉΓòÉ <hidden> Derivation - IResourceId ΓòÉΓòÉΓòÉ
  5758.  
  5759. IBase
  5760.   Γöé
  5761. IResourceId
  5762.  
  5763. Inherited by none. 
  5764.  
  5765.  
  5766. ΓòÉΓòÉΓòÉ <hidden> Class Description - IResourceId ΓòÉΓòÉΓòÉ
  5767.  
  5768. ireslib.hpp 
  5769.  
  5770. The IResourceId class is a wrapper class for a resource identifier. You can use 
  5771. the information contained in this class to determine the location of the 
  5772. resources, if the resources reside in either an IResourceLibrary or an 
  5773. IDynamicLinkLibrary. Most classes in the User Interface Class Library typically 
  5774. accept an IResourceId as input to describe resources and to provide the 
  5775. resource loading themselves. 
  5776.  
  5777.  
  5778. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IResourceId ΓòÉΓòÉΓòÉ
  5779.  
  5780. Constructors
  5781. IResourceId
  5782.  
  5783. Diagnostics
  5784. asDebugInfo
  5785. asString
  5786.  
  5787. Resources
  5788. id
  5789. operator unsigned long
  5790. resourceLibrary
  5791.  
  5792. Inherited Members
  5793. IBase
  5794. asDebugInfo
  5795. asString
  5796. messageFile
  5797. messageText
  5798. setMessageFile
  5799. version
  5800.  
  5801.  
  5802. ΓòÉΓòÉΓòÉ <hidden> IResourceId - Constructors ΓòÉΓòÉΓòÉ
  5803.  
  5804. You can construct objects of this class by providing a resource identifier, a 
  5805. resource identifier and a reference to an IResourceLibrary, or a resource 
  5806. identifier and a reference to an IDynamicLinkLibrary. You can also construct or 
  5807. initialize an object of this class from another IResourceId object. 
  5808.  
  5809.  
  5810. ΓòÉΓòÉΓòÉ <hidden> IResourceId - Diagnostics ΓòÉΓòÉΓòÉ
  5811.  
  5812. Use these members for diagnostic purposes.  They return an IString 
  5813. representation of an object of this class. 
  5814.  
  5815.  
  5816. ΓòÉΓòÉΓòÉ <hidden> IResourceId - Hidden Members ΓòÉΓòÉΓòÉ
  5817.  
  5818. These members are hidden to prevent you from using them. 
  5819.  
  5820.  
  5821. ΓòÉΓòÉΓòÉ <hidden> IResourceId - Resources ΓòÉΓòÉΓòÉ
  5822.  
  5823. Use these members to get the resource identifier or a reference to the resource 
  5824. library object for this class. 
  5825.  
  5826.  
  5827. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IResourceId ΓòÉΓòÉΓòÉ
  5828.  
  5829. Inherited Members
  5830. IBase
  5831. recoverable
  5832. unrecoverable
  5833.  
  5834.  
  5835. ΓòÉΓòÉΓòÉ 1.18.1. IResourceId::asDebugInfo ΓòÉΓòÉΓòÉ
  5836.  
  5837. Provides debugging information about the class object. It returns a string that 
  5838. contains the resource identifier as well as the results of a call to 
  5839. IResourceLibrary::asDebugInfo for its resource library. 
  5840.  
  5841. public:
  5842. IString asDebugInfo() const;
  5843.  
  5844. Platform Support 
  5845.  
  5846. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5847. ΓöéPM          ΓöéMOTIF       Γöé
  5848. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5849. ΓöéYes         ΓöéYes         Γöé
  5850. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5851.  
  5852.  
  5853. ΓòÉΓòÉΓòÉ 1.18.2. IResourceId::asString ΓòÉΓòÉΓòÉ
  5854.  
  5855. Provides textual information about the class object. It returns the resource 
  5856. identifier. 
  5857.  
  5858. public:
  5859. IString asString() const;
  5860.  
  5861. Platform Support 
  5862.  
  5863. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5864. ΓöéPM          ΓöéMOTIF       Γöé
  5865. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5866. ΓöéYes         ΓöéYes         Γöé
  5867. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5868.  
  5869.  
  5870. ΓòÉΓòÉΓòÉ 1.18.3. IResourceId::id ΓòÉΓòÉΓòÉ
  5871.  
  5872. Returns the identifier used for the resource. 
  5873.  
  5874. public:
  5875. unsigned long id() const;
  5876.  
  5877. Platform Support 
  5878.  
  5879. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5880. ΓöéPM          ΓöéMOTIF       Γöé
  5881. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5882. ΓöéYes         ΓöéYes         Γöé
  5883. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5884.  
  5885. Used in sample:   Lancelot - A Valiant Example: lmainwin.cpp 
  5886.  
  5887.  
  5888. ΓòÉΓòÉΓòÉ 1.18.4. IResourceId::IResourceId ΓòÉΓòÉΓòÉ
  5889.  
  5890. You can construct objects of this class by providing a resource identifier, a 
  5891. resource identifier and a reference to an IResourceLibrary, or a resource 
  5892. identifier and a reference to an IDynamicLinkLibrary. You can also construct or 
  5893. initialize an object of this class from another IResourceId object. 
  5894.  
  5895. Overload 1 
  5896.  
  5897. public:
  5898. IResourceId( unsigned long resourceId,
  5899.              const IDynamicLinkLibrary& dllLibrary);
  5900.  
  5901.  resourceId Unsigned long value that represents the resource identifier. 
  5902.  
  5903.  dllLibrary Reference to the dynamic link library where the resource resides. 
  5904.  
  5905.  Create an object to load the resource using the resource identifier and a 
  5906.  reference to an IDynamicLinkLibrary. If have already loaded the dynamic link 
  5907.  library that contains the resource, use this constructor. 
  5908.  
  5909.  Platform Support 
  5910.  
  5911.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5912.   ΓöéPM          ΓöéMOTIF       Γöé
  5913.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5914.   ΓöéYes         ΓöéNo          Γöé
  5915.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5916.  
  5917.  Overload 2 
  5918.  
  5919.   public:
  5920.   IResourceId( unsigned long resourceId,
  5921.                const IResourceLibrary& resourceLibrary);
  5922.  
  5923.  resourceId Unsigned long value that represents the resource identifier. 
  5924.  
  5925.  resourceLibrary Reference to the resource library where the resource resides. 
  5926.  
  5927.  Create an object to load the resource using the resource identifier and a 
  5928.  reference to an IResourceLibrary. If you have already loaded the resource 
  5929.  library that contains the resource, use this constructor. 
  5930.  
  5931.  Platform Support 
  5932.  
  5933.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5934.   ΓöéPM          ΓöéMOTIF       Γöé
  5935.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5936.   ΓöéYes         ΓöéYes         Γöé
  5937.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5938.  
  5939.  Overload 3 
  5940.  
  5941.   public:
  5942.   IResourceId(unsigned long resourceId);
  5943.  
  5944.  resourceId Unsigned long value that represents the resource identifier. 
  5945.  
  5946.  Create an object to load the resource using only the resource identifier.  The 
  5947.  constructor uses the resource library returned by a call to 
  5948.  ICurrentApplication::userResourceLibrary . This is the recommended use of the 
  5949.  class. 
  5950.  
  5951.  Platform Support 
  5952.  
  5953.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5954.   ΓöéPM          ΓöéMOTIF       Γöé
  5955.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5956.   ΓöéYes         ΓöéYes         Γöé
  5957.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5958.  
  5959.  Used in samples: 
  5960.  
  5961.       Hello World Sample - Version 4: adialog4.cpp 
  5962.       Hello World Sample - Version 5: adialog5.cpp 
  5963.       Hello World Sample - Version 6: ahellow6.cpp 
  5964.       Multi-Line Entry Field Sample: amle.cpp 
  5965.       Message Box Sample: msgbox.cpp 
  5966.  
  5967.  
  5968. ΓòÉΓòÉΓòÉ 1.18.5. IResourceId::operator unsigned long ΓòÉΓòÉΓòÉ
  5969.  
  5970. Returns the identifier used for the resource. Using this operator is the same 
  5971. as calling IResourceId::id. 
  5972.  
  5973. public:
  5974. operator unsigned long() const;
  5975.  
  5976. Platform Support 
  5977.  
  5978. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5979. ΓöéPM          ΓöéMOTIF       Γöé
  5980. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5981. ΓöéYes         ΓöéYes         Γöé
  5982. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5983.  
  5984.  
  5985. ΓòÉΓòÉΓòÉ 1.18.6. IResourceId::resourceLibrary ΓòÉΓòÉΓòÉ
  5986.  
  5987. Returns a const reference to the resource library. 
  5988.  
  5989. public:
  5990. const IResourceLibrary& resourceLibrary() const;
  5991.  
  5992. Platform Support 
  5993.  
  5994. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  5995. ΓöéPM          ΓöéMOTIF       Γöé
  5996. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  5997. ΓöéYes         ΓöéYes         Γöé
  5998. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  5999.  
  6000.  
  6001. ΓòÉΓòÉΓòÉ 1.19. IResourceLibrary ΓòÉΓòÉΓòÉ
  6002.  
  6003. Description 
  6004.  
  6005. Derivation 
  6006.  
  6007. Constructors 
  6008.  
  6009. Public Functions 
  6010.  
  6011. Protected Data 
  6012.  
  6013. To close all the panels in a chapter, double click on this panel's system menu. 
  6014.  
  6015.  
  6016. ΓòÉΓòÉΓòÉ <hidden> Derivation - IResourceLibrary ΓòÉΓòÉΓòÉ
  6017.  
  6018. IBase
  6019.   Γöé
  6020. IVBase
  6021.   Γöé
  6022. IResourceLibrary
  6023.  
  6024. Inherited by: 
  6025.  
  6026.       IDynamicLinkLibrary 
  6027.  
  6028.  
  6029. ΓòÉΓòÉΓòÉ <hidden> Class Description - IResourceLibrary ΓòÉΓòÉΓòÉ
  6030.  
  6031. ireslib.hpp 
  6032.  
  6033. The IResourceLibrary class loads most of the system resources.  The default 
  6034. location for the resources is the executable file.  Use the IDynamicLinkLibrary 
  6035. class to load resources that are stored in a dynamic link library. 
  6036.  
  6037. Typically, you only need to use this class when constructing objects of the 
  6038. IResourceId class.  You can also use it to obtain either the User Interface 
  6039. Class Library's resource library or the default user resource library using 
  6040. ICurrentApplication::resourceLibrary or 
  6041. ICurrentApplication::userResourceLibrary respectively. 
  6042.  
  6043.  
  6044. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IResourceLibrary ΓòÉΓòÉΓòÉ
  6045.  
  6046. Constructors
  6047. IResourceLibrary
  6048. operator =
  6049. ~IResourceLibrary
  6050.  
  6051. Diagnostics
  6052. asDebugInfo
  6053. asString
  6054.  
  6055. Resource Information
  6056. fileName
  6057. handle
  6058. isOpen
  6059.  
  6060. Resource Loading
  6061. loadAccelTable
  6062. loadBitmap
  6063. loadDialog
  6064. loadHelpTable
  6065. loadIcon
  6066. loadMenu
  6067. loadMessage
  6068. loadPointer
  6069. loadString
  6070. sizeBitmapTo
  6071. tryToLoadBitmap
  6072. tryToLoadIcon
  6073. tryToLoadMessage
  6074. tryToLoadString
  6075.  
  6076. Inherited Members
  6077. IVBase
  6078. asDebugInfo
  6079. asString
  6080.  
  6081. IBase
  6082. asDebugInfo
  6083. asString
  6084. messageFile
  6085. messageText
  6086. setMessageFile
  6087. version
  6088.  
  6089.  
  6090. ΓòÉΓòÉΓòÉ <hidden> IResourceLibrary - Constructors ΓòÉΓòÉΓòÉ
  6091.  
  6092. Use these members to construct, copy, assign, and destruct objects of this 
  6093. class.  You can construct objects of this class by using the default 
  6094. constructor, which does not accept any parameters, or by using the copy 
  6095. constructor to copy one resource library to another. 
  6096.  
  6097.  
  6098. ΓòÉΓòÉΓòÉ <hidden> IResourceLibrary - Diagnostics ΓòÉΓòÉΓòÉ
  6099.  
  6100. Use these members for diagnostic purposes.  They return an IString 
  6101. representation of an object of this class. 
  6102.  
  6103.  
  6104. ΓòÉΓòÉΓòÉ <hidden> IResourceLibrary - Resource Information ΓòÉΓòÉΓòÉ
  6105.  
  6106. Use these members to query general resource information. 
  6107.  
  6108.  
  6109. ΓòÉΓòÉΓòÉ <hidden> IResourceLibrary - Resource Loading ΓòÉΓòÉΓòÉ
  6110.  
  6111. Use these members to load specific resources from a resource file. 
  6112.  
  6113.  
  6114. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IResourceLibrary ΓòÉΓòÉΓòÉ
  6115.  
  6116. Inherited Members
  6117. IBase
  6118. recoverable
  6119. unrecoverable
  6120.  
  6121.  
  6122. ΓòÉΓòÉΓòÉ 1.19.1. IResourceLibrary::asDebugInfo ΓòÉΓòÉΓòÉ
  6123.  
  6124. Provides debugging information about the class object. It returns a string that 
  6125. contains the file name of the resource library. 
  6126.  
  6127. public:
  6128. virtual IString asDebugInfo() const;
  6129.  
  6130. Platform Support 
  6131.  
  6132. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6133. ΓöéPM          ΓöéMOTIF       Γöé
  6134. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6135. ΓöéYes         ΓöéYes         Γöé
  6136. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6137.  
  6138.  
  6139. ΓòÉΓòÉΓòÉ 1.19.2. IResourceLibrary::asString ΓòÉΓòÉΓòÉ
  6140.  
  6141. Provides textual information about the class object. It returns a string that 
  6142. contains the file name of the resource library. 
  6143.  
  6144. public:
  6145. virtual IString asString() const;
  6146.  
  6147. Platform Support 
  6148.  
  6149. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6150. ΓöéPM          ΓöéMOTIF       Γöé
  6151. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6152. ΓöéYes         ΓöéYes         Γöé
  6153. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6154.  
  6155.  
  6156. ΓòÉΓòÉΓòÉ 1.19.3. IResourceLibrary::fileName ΓòÉΓòÉΓòÉ
  6157.  
  6158. Returns the fully qualified file name of the resource library. 
  6159.  
  6160. public:
  6161. virtual IString fileName() const;
  6162.  
  6163. Platform Support 
  6164.  
  6165. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6166. ΓöéPM          ΓöéMOTIF       Γöé
  6167. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6168. ΓöéYes         ΓöéYes         Γöé
  6169. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6170.  
  6171.  
  6172. ΓòÉΓòÉΓòÉ 1.19.4. IResourceLibrary::handle ΓòÉΓòÉΓòÉ
  6173.  
  6174. Returns the handle used to load resources. 
  6175.  
  6176. public:
  6177. virtual IModuleHandle handle() const;
  6178.  
  6179. Platform Support 
  6180.  
  6181. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6182. ΓöéPM          ΓöéMOTIF       Γöé
  6183. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6184. ΓöéYes         ΓöéYes         Γöé
  6185. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6186.  
  6187. Presentation Manager: This is always 0 for an IResourceLibrary. 
  6188.  
  6189.  
  6190. ΓòÉΓòÉΓòÉ 1.19.5. IResourceLibrary::IResourceLibrary ΓòÉΓòÉΓòÉ
  6191.  
  6192. Use these members to construct, copy, assign, and destruct objects of this 
  6193. class.  You can construct objects of this class by using the default 
  6194. constructor, which does not accept any parameters, or by using the copy 
  6195. constructor to copy one resource library to another. 
  6196.  
  6197. Overload 1 
  6198.  
  6199. public:
  6200. IResourceLibrary();
  6201.  
  6202. Creates a resource library object using this, the default constructor. 
  6203.  
  6204. Platform Support 
  6205.  
  6206. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6207. ΓöéPM          ΓöéMOTIF       Γöé
  6208. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6209. ΓöéYes         ΓöéYes         Γöé
  6210. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6211.  
  6212. Used in sample:   2D Graphics Sample: 2d-draw.cpp 
  6213.  
  6214. Overload 2 
  6215.  
  6216. public:
  6217. IResourceLibrary(const IResourceLibrary& resLibrary);
  6218.  
  6219.  resourceLibrary Reference to an existing resource library object. 
  6220.  
  6221.  Creates a resource library object using a reference to an existing resource 
  6222.  library object.  This is commonly known as a copy constructor. 
  6223.  
  6224.  Platform Support 
  6225.  
  6226.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6227.   ΓöéPM          ΓöéMOTIF       Γöé
  6228.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6229.   ΓöéYes         ΓöéYes         Γöé
  6230.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6231.  
  6232.  
  6233. ΓòÉΓòÉΓòÉ 1.19.6. IResourceLibrary::isOpen ΓòÉΓòÉΓòÉ
  6234.  
  6235. Returns the open state of the resource file. 
  6236.  
  6237. Note:  True is always returned for an object of this class. 
  6238.  
  6239.   public:
  6240.   virtual Boolean isOpen() const;
  6241.  
  6242.  Platform Support 
  6243.  
  6244.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6245.   ΓöéPM          ΓöéMOTIF       Γöé
  6246.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6247.   ΓöéYes         ΓöéYes         Γöé
  6248.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6249.  
  6250.  
  6251. ΓòÉΓòÉΓòÉ 1.19.7. IResourceLibrary::loadAccelTable ΓòÉΓòÉΓòÉ
  6252.  
  6253. Loads an accelerator table from a resource file. 
  6254.  
  6255. Overload 1 
  6256.  
  6257. public:
  6258. virtual IAccelTblHandle
  6259.   loadAccelTable( unsigned long accelTableId) const;
  6260.  
  6261.  accelTableId Unsigned long value that represents the accelerator table 
  6262.            identifier. 
  6263.  
  6264.  Platform Support 
  6265.  
  6266.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6267.   ΓöéPM          ΓöéMOTIF       Γöé
  6268.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6269.   ΓöéYes         ΓöéNo          Γöé
  6270.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6271.  
  6272.  Exceptions 
  6273.  
  6274.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6275.   ΓöéIAccessError        ΓöéThe accelerator table was not loaded.   Γöé
  6276.   Γöé                    ΓöéThe accelerator table identifier may be Γöé
  6277.   Γöé                    Γöéinvalid.                                Γöé
  6278.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6279.  
  6280.  Overload 2 
  6281.  
  6282.   public:
  6283.   virtual void
  6284.     loadAccelTable( unsigned long accelTableId,
  6285.                     const IWindowHandle& menu) const;
  6286.  
  6287.  accelTableId Unsigned long value that represents the accelerator table 
  6288.            identifier. 
  6289.  
  6290.  menu      Reference to the handle of the window where the menu exists. 
  6291.  
  6292.  Platform Support 
  6293.  
  6294.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6295.   ΓöéPM          ΓöéMOTIF       Γöé
  6296.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6297.   ΓöéNo          ΓöéYes         Γöé
  6298.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6299.  
  6300.  
  6301. ΓòÉΓòÉΓòÉ 1.19.8. IResourceLibrary::loadBitmap ΓòÉΓòÉΓòÉ
  6302.  
  6303. Loads a bitmap from a resource file. 
  6304.  
  6305. If the cached argument is true, the bitmap is reference counted. Therefore, if 
  6306. multiple requests are made for the bitmap, the reference count is incremented, 
  6307. and the same copy of the bitmap is used.  When all of the references to the 
  6308. bitmap are deleted, the User Interface Class Library deletes the bitmap. 
  6309.  
  6310. If you set the cached argument to false, you create a new copy of the bitmap 
  6311. that is never deleted. 
  6312.  
  6313. Overload 1 
  6314.  
  6315. public:
  6316. virtual IBitmapHandle
  6317.   loadBitmap( unsigned long bitmapId,
  6318.               Boolean cached = true) const;
  6319.  
  6320.  bitmapId  Unsigned long value that represents the bitmap identifier. 
  6321.  
  6322.  cached    Boolean value that determines caching. 
  6323.  
  6324.  Platform Support 
  6325.  
  6326.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6327.   ΓöéPM          ΓöéMOTIF       Γöé
  6328.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6329.   ΓöéYes         ΓöéYes         Γöé
  6330.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6331.  
  6332.  Overload 2 
  6333.  
  6334.   public:
  6335.   virtual IBitmapHandle
  6336.     loadBitmap( unsigned long bitmapId,
  6337.                 const ISize& bitmapSize,
  6338.                 Boolean cached = true) const;
  6339.  
  6340.  bitmapId  Unsigned long value that represents the bitmap identifier. 
  6341.  
  6342.  bitmapSize Reference to a size object that determines at which size the bitmap 
  6343.            is loaded. 
  6344.  
  6345.  cached    Boolean value that determines caching. 
  6346.  
  6347.  Use this version of the function if you want to specify the size at which the 
  6348.  bitmap is loaded. 
  6349.  
  6350.  Platform Support 
  6351.  
  6352.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6353.   ΓöéPM          ΓöéMOTIF       Γöé
  6354.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6355.   ΓöéYes         ΓöéYes         Γöé
  6356.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6357.  
  6358.  Exceptions 
  6359.  
  6360.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6361.   ΓöéIAccessError        ΓöéThe bitmap was not loaded.  The bitmap  Γöé
  6362.   Γöé                    Γöéidentifier may be invalid.              Γöé
  6363.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6364.  
  6365.  Used in sample:   Notebook Sample: notebook.cpp 
  6366.  
  6367.  
  6368. ΓòÉΓòÉΓòÉ 1.19.9. IResourceLibrary::loadDialog ΓòÉΓòÉΓòÉ
  6369.  
  6370. Loads a dialog resource, creates a frame window, and sets the dialog as the 
  6371. client of the frame window. 
  6372.  
  6373. public:
  6374. virtual IWindowHandle
  6375.   loadDialog( unsigned long dialogId,
  6376.               IWindow* dialogParent,
  6377.               IWindow* dialogOwner,
  6378.               IWinProc* dialogProcedure,
  6379.               void* dialogCreateParameters) const;
  6380.  
  6381.  dialogId  Unsigned long value that represents the dialog identifier. 
  6382.  
  6383.  dialogParent Pointer to a window object that is the dialog's parent. 
  6384.  
  6385.  dialogOwner Pointer to a window object that is the dialog's owner. 
  6386.  
  6387.  dialogProcedure Pointer to a dialog procedure for the dialog you are loading. 
  6388.  
  6389.  dialogCreateParameters Pointer to an application-defined data area.  The first 
  6390.            2 bytes of the data referenced by the pointer should be the total 
  6391.            size of the data. 
  6392.  
  6393.  Platform Support 
  6394.  
  6395.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6396.   ΓöéPM          ΓöéMOTIF       Γöé
  6397.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6398.   ΓöéYes         ΓöéYes         Γöé
  6399.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6400.  
  6401.  Motif: AIX does not support dialogs. 
  6402.  
  6403.  Exceptions 
  6404.  
  6405.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6406.   ΓöéIAccessError        ΓöéThe dialog was not loaded.  The dialog  Γöé
  6407.   Γöé                    Γöéidentifier, parent, owner, procedure, orΓöé
  6408.   Γöé                    Γöécreate parameters may be invalid.       Γöé
  6409.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6410.  
  6411.  
  6412. ΓòÉΓòÉΓòÉ 1.19.10. IResourceLibrary::loadHelpTable ΓòÉΓòÉΓòÉ
  6413.  
  6414. Loads a help table from a resource file.  The IHelpWindow class provides more 
  6415. information on help windows. 
  6416.  
  6417. public:
  6418. virtual IResourceLibrary&
  6419.   loadHelpTable( IWindow* helpInstance,
  6420.                  unsigned long helpTableId) const;
  6421.  
  6422.  helpInstance Pointer to the window object for the help instance. 
  6423.  
  6424.  helpTableId Unsigned long value that represents the help table identifier. 
  6425.  
  6426.  Platform Support 
  6427.  
  6428.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6429.   ΓöéPM          ΓöéMOTIF       Γöé
  6430.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6431.   ΓöéYes         ΓöéYes         Γöé
  6432.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6433.  
  6434.  Exceptions 
  6435.  
  6436.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6437.   ΓöéIAccessError        ΓöéThe help table was not loaded.  The helpΓöé
  6438.   Γöé                    Γöétable identifier or the help table      Γöé
  6439.   Γöé                    Γöéinstance may be invalid.                Γöé
  6440.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6441.  
  6442.  
  6443. ΓòÉΓòÉΓòÉ 1.19.11. IResourceLibrary::loadIcon ΓòÉΓòÉΓòÉ
  6444.  
  6445. Loads an icon from a resource file. 
  6446.  
  6447. If the cached argument is true, the icon is reference counted. Therefore, if 
  6448. multiple requests are made for the icon, the reference count is incremented, 
  6449. and the same copy of the icon is used. When all of the references to the icon 
  6450. are deleted, the User Interface Class Library deletes the icon. 
  6451.  
  6452. If you set the cached argument to false, you create a new copy of the icon that 
  6453. is never deleted. 
  6454.  
  6455. public:
  6456. virtual IPointerHandle
  6457.   loadIcon( unsigned long iconId,
  6458.             Boolean cached = true) const;
  6459.  
  6460.  iconId    Unsigned long value that represents the icon identifier. 
  6461.  
  6462.  cached    Boolean value that determines caching. 
  6463.  
  6464.  Platform Support 
  6465.  
  6466.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6467.   ΓöéPM          ΓöéMOTIF       Γöé
  6468.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6469.   ΓöéYes         ΓöéYes         Γöé
  6470.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6471.  
  6472.  Exceptions 
  6473.  
  6474.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6475.   ΓöéIAccessError        ΓöéThe icon was not loaded.  The icon      Γöé
  6476.   Γöé                    Γöéidentifier may be invalid.              Γöé
  6477.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6478.  
  6479.  Used in sample:   Container Sample: acnr.cpp 
  6480.  
  6481.  
  6482. ΓòÉΓòÉΓòÉ 1.19.12. IResourceLibrary::loadMenu ΓòÉΓòÉΓòÉ
  6483.  
  6484. Loads a menu resource from a resource file. 
  6485.  
  6486. Overload 1 
  6487.  
  6488. public:
  6489. virtual IWindowHandle
  6490.   loadMenu( unsigned long menuId,
  6491.             IWindow* menuOwner) const;
  6492.  
  6493.  menuId    Unsigned long value that represents the menu identifier. 
  6494.  
  6495.  menuOwner Pointer to a window object that is the menu's owner. 
  6496.  
  6497.  Platform Support 
  6498.  
  6499.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6500.   ΓöéPM          ΓöéMOTIF       Γöé
  6501.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6502.   ΓöéYes         ΓöéNo          Γöé
  6503.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6504.  
  6505.  Exceptions 
  6506.  
  6507.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6508.   ΓöéIAccessError        ΓöéThe menu was not loaded.  The menu      Γöé
  6509.   Γöé                    Γöéidentifier or the menu owner may be     Γöé
  6510.   Γöé                    Γöéinvalid.                                Γöé
  6511.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6512.  
  6513.  Overload 2 
  6514.  
  6515.   public:
  6516.   virtual void
  6517.     loadMenu( unsigned long menuId,
  6518.               const IWindowHandle& menuHandle,
  6519.               IMenu* parentMenu) const;
  6520.  
  6521.  menuId    Unsigned long value that represents the menu identifier. 
  6522.  
  6523.  menuHandle Reference to the handle of the menu owner window. 
  6524.  
  6525.  parentMenu Pointer to a menu object that is the menu's parent. 
  6526.  
  6527.  Platform Support 
  6528.  
  6529.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6530.   ΓöéPM          ΓöéMOTIF       Γöé
  6531.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6532.   ΓöéNo          ΓöéYes         Γöé
  6533.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6534.  
  6535.  Motif: This member function calls a private IMenuBld class to read the menu 
  6536.  resource from the Motif resource database, parses it, and calls the 
  6537.  appropriate IMenu member function to create the menu items under parentMenu. 
  6538.  
  6539.  
  6540. ΓòÉΓòÉΓòÉ 1.19.13. IResourceLibrary::loadMessage ΓòÉΓòÉΓòÉ
  6541.  
  6542. Loads a message resource from a resource file using the specified message 
  6543. identifier. 
  6544.  
  6545. public:
  6546. virtual IString loadMessage(unsigned long messageId) const;
  6547.  
  6548.  messageId Unsigned long value that represents the message identifier. 
  6549.  
  6550.  Platform Support 
  6551.  
  6552.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6553.   ΓöéPM          ΓöéMOTIF       Γöé
  6554.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6555.   ΓöéYes         ΓöéYes         Γöé
  6556.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6557.  
  6558.  
  6559. ΓòÉΓòÉΓòÉ 1.19.14. IResourceLibrary::loadPointer ΓòÉΓòÉΓòÉ
  6560.  
  6561. Loads a pointer from a resource file. 
  6562.  
  6563. If the cached argument is true, the pointer is reference counted. Calling this 
  6564. function is the same as calling IResourceLibrary::loadIcon. 
  6565.  
  6566. public:
  6567. virtual IPointerHandle
  6568.   loadPointer( unsigned long iconId,
  6569.                Boolean cached = true) const;
  6570.  
  6571.  iconId    Unsigned long value that represents the icon identifier. 
  6572.  
  6573.  cached    Boolean value that determines caching. 
  6574.  
  6575.  Platform Support 
  6576.  
  6577.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6578.   ΓöéPM          ΓöéMOTIF       Γöé
  6579.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6580.   ΓöéYes         ΓöéYes         Γöé
  6581.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6582.  
  6583.  Used in sample:   2D Graphics Sample: 2d-draw.cpp 
  6584.  
  6585.  
  6586. ΓòÉΓòÉΓòÉ 1.19.15. IResourceLibrary::loadString ΓòÉΓòÉΓòÉ
  6587.  
  6588. Loads a string resource from a resource file using the specified string 
  6589. identifier. 
  6590.  
  6591. public:
  6592. virtual IString loadString(unsigned long stringId) const;
  6593.  
  6594.  stringId  Unsigned long value that represents the string identifier. 
  6595.  
  6596.  Platform Support 
  6597.  
  6598.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6599.   ΓöéPM          ΓöéMOTIF       Γöé
  6600.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6601.   ΓöéYes         ΓöéYes         Γöé
  6602.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6603.  
  6604.  Used in samples: 
  6605.  
  6606.       List Box Sample: alistbox.cpp 
  6607.       Multi-Line Entry Field Sample: amle.cpp 
  6608.       Multi Cell Canvas Sample: amcelcv.cpp 
  6609.       Lancelot - A Valiant Example: lmainwin.cpp 
  6610.  
  6611.  
  6612. ΓòÉΓòÉΓòÉ 1.19.16. IResourceLibrary::operator = ΓòÉΓòÉΓòÉ
  6613.  
  6614. Use this operator to assign the member data of an object of this class to 
  6615. another object of this class. 
  6616.  
  6617. public:
  6618. IResourceLibrary&
  6619.   operator =( const IResourceLibrary& resLibrary);
  6620.  
  6621.  resLibrary Reference to an existing resource library object. 
  6622.  
  6623.  Platform Support 
  6624.  
  6625.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6626.   ΓöéPM          ΓöéMOTIF       Γöé
  6627.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6628.   ΓöéYes         ΓöéYes         Γöé
  6629.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6630.  
  6631.  
  6632. ΓòÉΓòÉΓòÉ 1.19.17. IResourceLibrary::sizeBitmapTo ΓòÉΓòÉΓòÉ
  6633.  
  6634. Scales the bitmap to the size specified by the newSize parameter. 
  6635.  
  6636. public:
  6637. static IBitmapHandle
  6638.   sizeBitmapTo( const IBitmapHandle& currentHandle,
  6639.                 const ISize& newSize);
  6640.  
  6641.  currentHandle Reference to the handle of the bitmap to resize. 
  6642.  
  6643.  newSize   Reference to a size object that contains the new bitmap size. 
  6644.  
  6645.  Platform Support 
  6646.  
  6647.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6648.   ΓöéPM          ΓöéMOTIF       Γöé
  6649.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6650.   ΓöéNo          ΓöéYes         Γöé
  6651.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6652.  
  6653.  
  6654. ΓòÉΓòÉΓòÉ 1.19.18. IResourceLibrary::tryToLoadBitmap ΓòÉΓòÉΓòÉ
  6655.  
  6656. Attempts to load a bitmap from a resource file. If this function cannot load 
  6657. the bitmap, it returns an IBitmapHandle with a 0 handle value rather than 
  6658. throwing an exception. 
  6659.  
  6660. If the cached argument is true, the bitmap is reference counted. Therefore, if 
  6661. multiple requests are made for the bitmap, the reference count is incremented, 
  6662. and the same copy of the bitmap is used.  When all of the references to the 
  6663. bitmap are deleted, the User Interface Class Library deletes the bitmap. 
  6664.  
  6665. If you set the cached argument to false, you create a new copy of the bitmap 
  6666. that is never deleted. 
  6667.  
  6668. Overload 1 
  6669.  
  6670. public:
  6671. virtual IBitmapHandle
  6672.   tryToLoadBitmap( unsigned long bitmapId,
  6673.                    const ISize& bitmapSize,
  6674.                    Boolean cached = true) const;
  6675.  
  6676.  bitmapId  Unsigned long value that represents the bitmap identifier. 
  6677.  
  6678.  bitmapSize Reference to a size object that determines at which size the bitmap 
  6679.            is loaded. 
  6680.  
  6681.  cached    Boolean value that determines caching. 
  6682.  
  6683.  Use this version of the function if you want to specify the size at which the 
  6684.  bitmap is loaded. 
  6685.  
  6686.  Platform Support 
  6687.  
  6688.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6689.   ΓöéPM          ΓöéMOTIF       Γöé
  6690.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6691.   ΓöéYes         ΓöéYes         Γöé
  6692.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6693.  
  6694.  Overload 2 
  6695.  
  6696.   public:
  6697.   virtual IBitmapHandle
  6698.     tryToLoadBitmap( unsigned long bitmapId,
  6699.                      Boolean cached = true) const;
  6700.  
  6701.  bitmapId  Unsigned long value that represents the bitmap identifier. 
  6702.  
  6703.  cached    Boolean value that determines caching. 
  6704.  
  6705.  Platform Support 
  6706.  
  6707.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6708.   ΓöéPM          ΓöéMOTIF       Γöé
  6709.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6710.   ΓöéYes         ΓöéYes         Γöé
  6711.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6712.  
  6713.  
  6714. ΓòÉΓòÉΓòÉ 1.19.19. IResourceLibrary::tryToLoadIcon ΓòÉΓòÉΓòÉ
  6715.  
  6716. Attempts to load an icon from a resource file. If this function cannot load the 
  6717. icon, it returns an IPointerHandle with a 0 handle value rather than throwing 
  6718. an exception. 
  6719.  
  6720. If the cached argument is true, the icon is reference counted. Therefore, if 
  6721. multiple requests are made for the icon, the reference count is incremented, 
  6722. and the same copy of the icon is used. When all of the references to the icon 
  6723. are deleted, the User Interface Class Library deletes the icon. 
  6724.  
  6725. If you set the cached argument to false, you create a new copy of the icon that 
  6726. is never deleted. 
  6727.  
  6728. public:
  6729. virtual IPointerHandle
  6730.   tryToLoadIcon( unsigned long iconId,
  6731.                  Boolean cached = true) const;
  6732.  
  6733.  iconId    Unsigned long value that represents the icon identifier. 
  6734.  
  6735.  cached    Boolean value that determines caching. 
  6736.  
  6737.  Platform Support 
  6738.  
  6739.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6740.   ΓöéPM          ΓöéMOTIF       Γöé
  6741.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6742.   ΓöéYes         ΓöéYes         Γöé
  6743.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6744.  
  6745.  
  6746. ΓòÉΓòÉΓòÉ 1.19.20. IResourceLibrary::tryToLoadMessage ΓòÉΓòÉΓòÉ
  6747.  
  6748. Attempts to load a message resource from a resource file. If this function 
  6749. cannot load the message, it returns an empty IString rather than throwing an 
  6750. exception. 
  6751.  
  6752. public:
  6753. virtual IString
  6754.   tryToLoadMessage( unsigned long messageId) const;
  6755.  
  6756.  messageId Unsigned long value that represents the message identifier. 
  6757.  
  6758.  Platform Support 
  6759.  
  6760.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6761.   ΓöéPM          ΓöéMOTIF       Γöé
  6762.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6763.   ΓöéYes         ΓöéYes         Γöé
  6764.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6765.  
  6766.  
  6767. ΓòÉΓòÉΓòÉ 1.19.21. IResourceLibrary::tryToLoadString ΓòÉΓòÉΓòÉ
  6768.  
  6769. Attempts to load a string resource from a resource file. If this function 
  6770. cannot load the string, it returns an empty IString rather than throwing an 
  6771. exception. 
  6772.  
  6773. public:
  6774. virtual IString
  6775.   tryToLoadString( unsigned long stringId) const;
  6776.  
  6777.  stringId  Unsigned long value that represents the string identifier. 
  6778.  
  6779.  Platform Support 
  6780.  
  6781.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6782.   ΓöéPM          ΓöéMOTIF       Γöé
  6783.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6784.   ΓöéYes         ΓöéYes         Γöé
  6785.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6786.  
  6787.  
  6788. ΓòÉΓòÉΓòÉ 1.19.22. IResourceLibrary::~IResourceLibrary ΓòÉΓòÉΓòÉ
  6789.  
  6790. public:
  6791. virtual  ~IResourceLibrary();
  6792.  
  6793. Platform Support 
  6794.  
  6795. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6796. ΓöéPM          ΓöéMOTIF       Γöé
  6797. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6798. ΓöéYes         ΓöéYes         Γöé
  6799. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6800.  
  6801.  
  6802. ΓòÉΓòÉΓòÉ 1.20. IResourceLock ΓòÉΓòÉΓòÉ
  6803.  
  6804. Description 
  6805.  
  6806. Derivation 
  6807.  
  6808. Constructors 
  6809.  
  6810. Public Functions 
  6811.  
  6812. Protected Functions 
  6813.  
  6814. Protected Data 
  6815.  
  6816. To close all the panels in a chapter, double click on this panel's system menu. 
  6817.  
  6818.  
  6819. ΓòÉΓòÉΓòÉ <hidden> Derivation - IResourceLock ΓòÉΓòÉΓòÉ
  6820.  
  6821. IBase
  6822.   Γöé
  6823. IVBase
  6824.   Γöé
  6825. IResourceLock
  6826.  
  6827. Inherited by none. 
  6828.  
  6829.  
  6830. ΓòÉΓòÉΓòÉ <hidden> Class Description - IResourceLock ΓòÉΓòÉΓòÉ
  6831.  
  6832. ireslock.hpp 
  6833.  
  6834. The IResourceLock class locks a resource for a specified period of time. 
  6835.  
  6836. A simple yet effective use of this class is to declare a local object of this 
  6837. class that is in scope for the period of time that the resource needs to be 
  6838. locked.  The lock is automatically removed when the block of code is exited, 
  6839. thereby forcing the object out of scope. 
  6840.  
  6841. If the specified period of time is reached before the resource can be acquired, 
  6842. an IResourceExhausted exception is thrown. 
  6843.  
  6844.  
  6845. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IResourceLock ΓòÉΓòÉΓòÉ
  6846.  
  6847. Constructors
  6848. IResourceLock
  6849. ~IResourceLock
  6850.  
  6851. Inherited Members
  6852. IVBase
  6853. asDebugInfo
  6854. asString
  6855.  
  6856. IBase
  6857. asDebugInfo
  6858. asString
  6859. messageFile
  6860. messageText
  6861. setMessageFile
  6862. version
  6863.  
  6864.  
  6865. ΓòÉΓòÉΓòÉ <hidden> IResourceLock - Constructors ΓòÉΓòÉΓòÉ
  6866.  
  6867. Use these members to construct and destruct objects of this class. 
  6868.  
  6869.  
  6870. ΓòÉΓòÉΓòÉ <hidden> IResourceLock - Hidden Members ΓòÉΓòÉΓòÉ
  6871.  
  6872. You cannot access these members. 
  6873.  
  6874.  
  6875. ΓòÉΓòÉΓòÉ <hidden> IResourceLock - Resource Locking ΓòÉΓòÉΓòÉ
  6876.  
  6877. Use these members to acquire or release a lock on the resource. 
  6878.  
  6879.  
  6880. ΓòÉΓòÉΓòÉ <hidden> Protected Functions - IResourceLock ΓòÉΓòÉΓòÉ
  6881.  
  6882. Resource Locking
  6883. clearLock
  6884. setLock
  6885.  
  6886.  
  6887. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IResourceLock ΓòÉΓòÉΓòÉ
  6888.  
  6889. Inherited Members
  6890. IBase
  6891. recoverable
  6892. unrecoverable
  6893.  
  6894.  
  6895. ΓòÉΓòÉΓòÉ 1.20.1. IResourceLock::clearLock ΓòÉΓòÉΓòÉ
  6896.  
  6897. Releases the resource. 
  6898.  
  6899. protected:
  6900. virtual IResourceLock& clearLock();
  6901.  
  6902. Platform Support 
  6903.  
  6904. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6905. ΓöéPM          ΓöéMOTIF       Γöé
  6906. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6907. ΓöéYes         ΓöéYes         Γöé
  6908. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6909.  
  6910. Exceptions 
  6911.  
  6912. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6913. ΓöéIAccessError        ΓöéThe resource object was not released.   Γöé
  6914. Γöé                    ΓöéThe semaphore handle may be invalid,    Γöé
  6915. Γöé                    Γöéthere may be too many release requests, Γöé
  6916. Γöé                    Γöéthe release request was interrupted, or Γöé
  6917. Γöé                    Γöéthe process which owns the semaphore    Γöé
  6918. Γöé                    Γöédied.                                   Γöé
  6919. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6920.  
  6921.  
  6922. ΓòÉΓòÉΓòÉ 1.20.2. IResourceLock::IResourceLock ΓòÉΓòÉΓòÉ
  6923.  
  6924. The only way to construct objects of this class is with this constructor.  You 
  6925. specify a reference to an IResource and an optional value for the timeOut 
  6926. parameter. You can specify timeOut in milliseconds with -1 indicating an 
  6927. indefinite wait and 0 requesting an immediate return. 
  6928.  
  6929. public:
  6930. IResourceLock(IResource& resource, long timeOut = - 1);
  6931.  
  6932.  resource  Reference to the resource being locked. 
  6933.  
  6934.  timeOut   Long value that represents in milliseconds how long to wait for the 
  6935.            lock request.  The default value is an indefinite wait.  Optional. 
  6936.  
  6937.  Platform Support 
  6938.  
  6939.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6940.   ΓöéPM          ΓöéMOTIF       Γöé
  6941.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6942.   ΓöéYes         ΓöéYes         Γöé
  6943.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6944.  
  6945.  Motif: The AIX timer services used to implement the resource lock timeOut have 
  6946.  a resolution of one second.  The timeout values you provide are rounded up to 
  6947.  the next one-second interval. 
  6948.  
  6949.  
  6950. ΓòÉΓòÉΓòÉ 1.20.3. IResourceLock::setLock ΓòÉΓòÉΓòÉ
  6951.  
  6952. Acquires the resource. You can specify the value for timeOut in milliseconds 
  6953. with -1 indicating an indefinite wait and 0 requesting an immediate return. 
  6954.  
  6955. The constructor calls this function to lock the resource; 
  6956. IResourceLock::clearLock can then be called to clear the lock, and this 
  6957. function can be called to reset it.  This is not the normal use of this class. 
  6958. Normally, you use the constructor and scope it to the instruction that requires 
  6959. serialization. 
  6960.  
  6961. protected:
  6962. virtual IResourceLock& setLock(long timeOut = - 1);
  6963.  
  6964.  timeOut   Long value that represents in milliseconds how long to wait for the 
  6965.            lock request.  The default value is an indefinite wait. 
  6966.  
  6967.  Platform Support 
  6968.  
  6969.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6970.   ΓöéPM          ΓöéMOTIF       Γöé
  6971.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6972.   ΓöéYes         ΓöéYes         Γöé
  6973.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6974.  
  6975.  Motif: The AIX timer services used to implement the resource lock timeOut have 
  6976.  a resolution of one second.  This function rounds up the specified timeout 
  6977.  value to the next one-second interval. 
  6978.  
  6979.  Exceptions 
  6980.  
  6981.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  6982.   ΓöéIOutOfSystemResourceΓöéThe resource object was not acquired.   Γöé
  6983.   Γöé                    ΓöéThe available semaphores may be         Γöé
  6984.   Γöé                    Γöéexhausted, because the request for a    Γöé
  6985.   Γöé                    Γöélock timed out.                         Γöé
  6986.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  6987.   ΓöéIAccessError        ΓöéThe resource object was not acquired.   Γöé
  6988.   Γöé                    ΓöéThe semaphore handle may be invalid,    Γöé
  6989.   Γöé                    Γöéthere may be too many lock requests, theΓöé
  6990.   Γöé                    Γöélock request was interrupted, or the    Γöé
  6991.   Γöé                    Γöéprocess which owns the semaphore died.  Γöé
  6992.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  6993.  
  6994.  
  6995. ΓòÉΓòÉΓòÉ 1.20.4. IResourceLock::~IResourceLock ΓòÉΓòÉΓòÉ
  6996.  
  6997. public:
  6998. virtual  ~IResourceLock();
  6999.  
  7000. Platform Support 
  7001.  
  7002. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7003. ΓöéPM          ΓöéMOTIF       Γöé
  7004. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7005. ΓöéYes         ΓöéYes         Γöé
  7006. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7007.  
  7008.  
  7009. ΓòÉΓòÉΓòÉ 1.21. ISemaphoreHandle ΓòÉΓòÉΓòÉ
  7010.  
  7011. Description 
  7012.  
  7013. Derivation 
  7014.  
  7015. Constructors 
  7016.  
  7017. Public Functions 
  7018.  
  7019. Protected Data 
  7020.  
  7021. To close all the panels in a chapter, double click on this panel's system menu. 
  7022.  
  7023.  
  7024. ΓòÉΓòÉΓòÉ <hidden> Derivation - ISemaphoreHandle ΓòÉΓòÉΓòÉ
  7025.  
  7026. IBase
  7027.   Γöé
  7028. IHandle
  7029.   Γöé
  7030. ISemaphoreHandle
  7031.  
  7032. Inherited by none. 
  7033.  
  7034.  
  7035. ΓòÉΓòÉΓòÉ <hidden> Class Description - ISemaphoreHandle ΓòÉΓòÉΓòÉ
  7036.  
  7037. ibhandle.hpp 
  7038.  
  7039. Objects of the ISemaphoreHandle class access semaphores. An example of a 
  7040. semaphore is a flag in a multiple-user application that prevents simultaneous 
  7041. access to a file. 
  7042.  
  7043.  
  7044. ΓòÉΓòÉΓòÉ <hidden> Public Functions - ISemaphoreHandle ΓòÉΓòÉΓòÉ
  7045.  
  7046. Constructors
  7047. ISemaphoreHandle
  7048.  
  7049. Inherited Members
  7050. IHandle
  7051. asDebugInfo
  7052. asString
  7053. asUnsigned
  7054. operator Value
  7055.  
  7056. IBase
  7057. asDebugInfo
  7058. asString
  7059. messageFile
  7060. messageText
  7061. setMessageFile
  7062. version
  7063.  
  7064.  
  7065. ΓòÉΓòÉΓòÉ <hidden> ISemaphoreHandle - Constructors ΓòÉΓòÉΓòÉ
  7066.  
  7067. You can construct objects of this class. 
  7068.  
  7069.  
  7070. ΓòÉΓòÉΓòÉ <hidden> Protected Data - ISemaphoreHandle ΓòÉΓòÉΓòÉ
  7071.  
  7072. Inherited Members
  7073. IHandle
  7074. handle
  7075.  
  7076. IBase
  7077. recoverable
  7078. unrecoverable
  7079.  
  7080.  
  7081. ΓòÉΓòÉΓòÉ 1.21.1. ISemaphoreHandle::ISemaphoreHandle ΓòÉΓòÉΓòÉ
  7082.  
  7083. You can construct objects of this class from a semaphore handle (a value of 
  7084. type IHandle::Value), which defaults to 0. 
  7085.  
  7086. public:
  7087. ISemaphoreHandle(Value hsem = 0);
  7088.  
  7089. Platform Support 
  7090.  
  7091. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7092. ΓöéPM          ΓöéMOTIF       Γöé
  7093. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7094. ΓöéYes         ΓöéYes         Γöé
  7095. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7096.  
  7097.  
  7098. ΓòÉΓòÉΓòÉ 1.22. ISharedResource ΓòÉΓòÉΓòÉ
  7099.  
  7100. Description 
  7101.  
  7102. Derivation 
  7103.  
  7104. Constructors 
  7105.  
  7106. Public Functions 
  7107.  
  7108. Protected Functions 
  7109.  
  7110. Protected Data 
  7111.  
  7112. To close all the panels in a chapter, double click on this panel's system menu. 
  7113.  
  7114.  
  7115. ΓòÉΓòÉΓòÉ <hidden> Derivation - ISharedResource ΓòÉΓòÉΓòÉ
  7116.  
  7117. IBase
  7118.   Γöé
  7119. IVBase
  7120.   Γöé
  7121. IResource
  7122.   Γöé
  7123. ISharedResource
  7124.  
  7125. Inherited by none. 
  7126.  
  7127.  
  7128. ΓòÉΓòÉΓòÉ <hidden> Class Description - ISharedResource ΓòÉΓòÉΓòÉ
  7129.  
  7130. ireslock.hpp 
  7131.  
  7132. The ISharedResource class defines a resource that can be shared across multiple 
  7133. processes. Use the name you provide on construction to distinguish between 
  7134. shared resources. 
  7135.  
  7136. Portability Considerations Use a keyName value that is a valid file name in all 
  7137. of the target environments. 
  7138.  
  7139. Motif Information 
  7140.  
  7141. You might use ISharedResource objects to serialize resource access with 
  7142. applications that were not written using the User Interface Class Library.  To 
  7143. make this work correctly, your non-User Interface Class Library application 
  7144. needs to use the AIX semaphore object in a manner consistent with the User 
  7145. Interface Class Library. To help you understand how the semaphore object is 
  7146. used by the User Interface Class Library, the basic interaction with the 
  7147. system's subroutines is described below. 
  7148.  
  7149. The AIX semop subroutine is used for the semaphore lock and release operations. 
  7150. The ISharedResource constructor uses the semget subroutine to allocate a set 
  7151. containing two semaphores.  The first semaphore in this set represents the 
  7152. state of the lock.  The constructor initializes the semval field to free (value 
  7153. of 0). A lock operation increments the value, while an unlock operation 
  7154. decrements the value.  Recursive lock operations by the same process are 
  7155. allowed.  In this case, the resource remains owned by the process until an 
  7156. equal number of unlock operations are done or the object is deleted. The second 
  7157. semaphore in the set is used as a reference counter to indicate the number of 
  7158. ISharedResource objects that are referencing this semaphore set.  The 
  7159. constructor increments this counter and the destructor decrements it. When the 
  7160. counter reaches 0, the destructor calls the semctl subroutine to delete the 
  7161. semaphore set. 
  7162.  
  7163. The constructor determines the semaphore identifier to use in the semget 
  7164. subroutine by using the ftok system subroutine.  If the parameter provided on 
  7165. the constructor begins with a slash (/) or is an existing file, the parameter 
  7166. is used as a file name for the ftok call and is the basis of the semaphore 
  7167. identifier token.  If the parameter is not the name of an existing file,  the 
  7168. constructor interprets the string as the name of a file in the /tmp directory. 
  7169. If this file does not exist, it is created.  You can use keyName to obtain the 
  7170. file name used on the ftok subroutine call.  The constructor always uses a 
  7171. value of 1 for the second parameter of ftok. 
  7172.  
  7173.  
  7174. ΓòÉΓòÉΓòÉ <hidden> Public Functions - ISharedResource ΓòÉΓòÉΓòÉ
  7175.  
  7176. Constructors
  7177. ISharedResource
  7178. ~ISharedResource
  7179.  
  7180. Resource Information
  7181. keyName
  7182.  
  7183. Inherited Members
  7184. IResource
  7185. lock
  7186. unlock
  7187.  
  7188. IVBase
  7189. asDebugInfo
  7190. asString
  7191.  
  7192. IBase
  7193. asDebugInfo
  7194. asString
  7195. messageFile
  7196. messageText
  7197. setMessageFile
  7198. version
  7199.  
  7200.  
  7201. ΓòÉΓòÉΓòÉ <hidden> ISharedResource - Constructors ΓòÉΓòÉΓòÉ
  7202.  
  7203. Use these members to construct and destruct objects of this class. 
  7204.  
  7205.  
  7206. ΓòÉΓòÉΓòÉ <hidden> ISharedResource - Hidden Members ΓòÉΓòÉΓòÉ
  7207.  
  7208. You cannot access these members. 
  7209.  
  7210.  
  7211. ΓòÉΓòÉΓòÉ <hidden> ISharedResource - Resource Handle ΓòÉΓòÉΓòÉ
  7212.  
  7213. Use these members to obtain a handle to the shared resource. 
  7214.  
  7215.  
  7216. ΓòÉΓòÉΓòÉ <hidden> ISharedResource - Resource Information ΓòÉΓòÉΓòÉ
  7217.  
  7218. Use these members to access shared resource information. 
  7219.  
  7220.  
  7221. ΓòÉΓòÉΓòÉ <hidden> Protected Functions - ISharedResource ΓòÉΓòÉΓòÉ
  7222.  
  7223. Resource Handle
  7224. handle
  7225.  
  7226. Inherited Members
  7227. IResource
  7228. handle
  7229.  
  7230.  
  7231. ΓòÉΓòÉΓòÉ <hidden> Protected Data - ISharedResource ΓòÉΓòÉΓòÉ
  7232.  
  7233. Inherited Members
  7234. IBase
  7235. recoverable
  7236. unrecoverable
  7237.  
  7238.  
  7239. ΓòÉΓòÉΓòÉ 1.22.1. ISharedResource::handle ΓòÉΓòÉΓòÉ
  7240.  
  7241. Returns the handle for the shared resource. 
  7242.  
  7243. protected:
  7244. ISemaphoreHandle& handle();
  7245.  
  7246. Platform Support 
  7247.  
  7248. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7249. ΓöéPM          ΓöéMOTIF       Γöé
  7250. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7251. ΓöéYes         ΓöéYes         Γöé
  7252. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7253.  
  7254.  
  7255. ΓòÉΓòÉΓòÉ 1.22.2. ISharedResource::ISharedResource ΓòÉΓòÉΓòÉ
  7256.  
  7257. You can only construct objects of this class by providing a name that uniquely 
  7258. identifies the resource to be shared. 
  7259.  
  7260. public:
  7261. ISharedResource(const char* keyName);
  7262.  
  7263.  keyName   Pointer to the name that uniquely identifies the resource. 
  7264.  
  7265.  Platform Support 
  7266.  
  7267.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7268.   ΓöéPM          ΓöéMOTIF       Γöé
  7269.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7270.   ΓöéYes         ΓöéYes         Γöé
  7271.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7272.  
  7273.  Exceptions 
  7274.  
  7275.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7276.   ΓöéIAccessError        ΓöéThe shared resource object was not      Γöé
  7277.   Γöé                    Γöécreated.  The memory may be exhausted,  Γöé
  7278.   Γöé                    Γöéthe handle limit on your platform may beΓöé
  7279.   Γöé                    Γöéexceeded, or the keyName may be invalid.Γöé
  7280.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7281.  
  7282.  
  7283. ΓòÉΓòÉΓòÉ 1.22.3. ISharedResource::keyName ΓòÉΓòÉΓòÉ
  7284.  
  7285. Returns the name used to identify this shared resource. 
  7286.  
  7287. public:
  7288. IString keyName() const;
  7289.  
  7290. Platform Support 
  7291.  
  7292. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7293. ΓöéPM          ΓöéMOTIF       Γöé
  7294. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7295. ΓöéYes         ΓöéYes         Γöé
  7296. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7297.  
  7298.  
  7299. ΓòÉΓòÉΓòÉ 1.22.4. ISharedResource::~ISharedResource ΓòÉΓòÉΓòÉ
  7300.  
  7301. public:
  7302. virtual  ~ISharedResource();
  7303.  
  7304. Platform Support 
  7305.  
  7306. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7307. ΓöéPM          ΓöéMOTIF       Γöé
  7308. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7309. ΓöéYes         ΓöéYes         Γöé
  7310. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7311.  
  7312. Exceptions 
  7313.  
  7314. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7315. ΓöéIAccessError        ΓöéThe shared resource object was not      Γöé
  7316. Γöé                    Γöédeleted.  The semaphore handle may be   Γöé
  7317. Γöé                    Γöéinvalid.                                Γöé
  7318. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7319.  
  7320.  
  7321. ΓòÉΓòÉΓòÉ 1.23. IThread ΓòÉΓòÉΓòÉ
  7322.  
  7323. Description 
  7324.  
  7325. Derivation 
  7326.  
  7327. Constructors 
  7328.  
  7329. Public Functions 
  7330.  
  7331. Protected Functions 
  7332.  
  7333. Protected Data 
  7334.  
  7335. Nested Types 
  7336.  
  7337. To close all the panels in a chapter, double click on this panel's system menu. 
  7338.  
  7339.  
  7340. ΓòÉΓòÉΓòÉ <hidden> Derivation - IThread ΓòÉΓòÉΓòÉ
  7341.  
  7342. IBase
  7343.   Γöé
  7344. IVBase
  7345.   Γöé
  7346. IThread
  7347.  
  7348. Inherited by: 
  7349.  
  7350.       ICurrentThread 
  7351.  
  7352.  
  7353. ΓòÉΓòÉΓòÉ <hidden> Class Description - IThread ΓòÉΓòÉΓòÉ
  7354.  
  7355. ithread.hpp 
  7356.  
  7357. The IThread class represents threads of execution within the current program. 
  7358. You can use this class to implement multithreaded applications. Objects of this 
  7359. class give you access to all of the tasking APIs of the operating system. In 
  7360. addition, these objects serve as the anchor for thread-specific information. 
  7361.  
  7362. Generally, you use objects of this class in one of the following ways: 
  7363.  
  7364.      To apply thread functions to the current thread. In most cases, these 
  7365.       functions are applied to the IThread object reference returned by the 
  7366.       static member function IThread::current. 
  7367.  
  7368.      To create additional threads of execution by creating new objects of this 
  7369.       class and starting them. 
  7370.  
  7371.      To manipulate threads of execution initiated using alternate means, and 
  7372.       for which only the thread's identifier is known. 
  7373.  
  7374.  Portability Considerations The AIX release of the User Interface Class Library 
  7375.  does not presently support multiple threads per process. Portable applications 
  7376.  must be limited to a single thread. 
  7377.  
  7378.  The OS/2 version of IThread has functions to control the size of the message 
  7379.  queue and the stack size associated with a thread. These functions are not 
  7380.  needed in the AIX environment and have no affect on the execution of a thread. 
  7381.  You can call these functions in the AIX environment with no adverse side 
  7382.  effects. Therefore, they have been left in the interface for ease of porting 
  7383.  applications to multiple platforms. 
  7384.  
  7385.  Presentation Manager Information 
  7386.  
  7387.  Compile multithreaded programs (those that call the IThread::start member 
  7388.  function) with /Gm+ to avoid unresolved externals at link time. 
  7389.  
  7390.  Motif Information 
  7391.  
  7392.  The AIX release of the User Interface Class Library does not support 
  7393.  multithreading. The only access that an AIX application should need to IThread 
  7394.  is exported through the class IApplication with the call to 
  7395.  IApplication::current().run(). This call starts the processing of messages for 
  7396.  the application. 
  7397.  
  7398.  You cannot control the priority of the AIX thread. The main thread of 
  7399.  execution is a process. The only control that a user has over the priority of 
  7400.  a process is using the nice values, which are not supported at this time. 
  7401.  
  7402.  
  7403. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IThread ΓòÉΓòÉΓòÉ
  7404.  
  7405. Constructors
  7406. IThread
  7407. ~IThread
  7408.  
  7409. Diagnostics
  7410. asDebugInfo
  7411. asString
  7412.  
  7413. Graphical User Interface (GUI) Support
  7414. autoInitGUI
  7415. defaultAutoInitGUI
  7416. setAutoInitGUI
  7417. setDefaultAutoInitGUI
  7418. stopProcessingMsgs
  7419.  
  7420. Implementation
  7421. relatedHandlesList
  7422. setRelatedHandlesList
  7423. setWindowList
  7424. windowList
  7425.  
  7426. Message Queue
  7427. defaultQueueSize
  7428. messageQueue
  7429. queueSize
  7430. setDefaultQueueSize
  7431. setQueueSize
  7432.  
  7433. Stack Size
  7434. defaultStackSize
  7435. setDefaultStackSize
  7436. setStackSize
  7437. stackSize
  7438.  
  7439. Starting and Stopping Threads
  7440. resume
  7441. start
  7442. stop
  7443. suspend
  7444.  
  7445. Thread Information
  7446. current
  7447. currentId
  7448. id
  7449. isStarted
  7450. setVariable
  7451. variable
  7452.  
  7453. Thread Priority
  7454. adjustPriority
  7455. priorityClass
  7456. priorityLevel
  7457. setPriority
  7458.  
  7459. Inherited Members
  7460. IVBase
  7461. asDebugInfo
  7462. asString
  7463.  
  7464. IBase
  7465. asDebugInfo
  7466. asString
  7467. messageFile
  7468. messageText
  7469. setMessageFile
  7470. version
  7471.  
  7472.  
  7473. ΓòÉΓòÉΓòÉ <hidden> IThread - Constructors ΓòÉΓòÉΓòÉ
  7474.  
  7475. You can construct, copy, assign, and destruct objects of this class. 
  7476.  
  7477.  
  7478. ΓòÉΓòÉΓòÉ <hidden> IThread - Diagnostics ΓòÉΓòÉΓòÉ
  7479.  
  7480. Use these members for diagnostic purposes.  They return an IString 
  7481. representation of an object of this class. 
  7482.  
  7483.  
  7484. ΓòÉΓòÉΓòÉ <hidden> IThread - Function Types ΓòÉΓòÉΓòÉ
  7485.  
  7486. These typedefs define the two types of (non-member) functions that can be 
  7487. dispatched on a separate thread. 
  7488.  
  7489.  
  7490. ΓòÉΓòÉΓòÉ <hidden> IThread - Graphical User Interface (GUI) Support ΓòÉΓòÉΓòÉ
  7491.  
  7492. Use these members to query and set the basic GUI support for threads. 
  7493.  
  7494.  
  7495. ΓòÉΓòÉΓòÉ <hidden> IThread - Hidden Members ΓòÉΓòÉΓòÉ
  7496.  
  7497. You cannot access these members. 
  7498.  
  7499.  
  7500. ΓòÉΓòÉΓòÉ <hidden> IThread - Implementation ΓòÉΓòÉΓòÉ
  7501.  
  7502. These members provide utilities used to implement this class.  They are used by 
  7503. the User Interface Class Library. 
  7504.  
  7505.  
  7506. ΓòÉΓòÉΓòÉ <hidden> IThread - Message Queue ΓòÉΓòÉΓòÉ
  7507.  
  7508. Use these members to query and set message queue information for graphical user 
  7509. interface (GUI) support. 
  7510.  
  7511.  
  7512. ΓòÉΓòÉΓòÉ <hidden> IThread - Obsolete Members ΓòÉΓòÉΓòÉ
  7513.  
  7514. Use these members to provide basic OS/2 Presentation Manager (PM) support for 
  7515. threads. 
  7516.  
  7517. Note:  Please note that these members are obsolete, and have been replaced with 
  7518.        new members due to portability requirements.  These new members are 
  7519.        described in the group, Graphical User Interface (GUI) Support  We 
  7520.        provide you with the name of the new member you should be using in the 
  7521.        documentation for each of the members in this group. 
  7522.  
  7523.  
  7524. ΓòÉΓòÉΓòÉ <hidden> IThread - Stack Size ΓòÉΓòÉΓòÉ
  7525.  
  7526. Use these members to query and set this thread's stack size. 
  7527.  
  7528.  
  7529. ΓòÉΓòÉΓòÉ <hidden> IThread - Starting and Stopping Threads ΓòÉΓòÉΓòÉ
  7530.  
  7531. Use these members to start or stop threads. 
  7532.  
  7533.  
  7534. ΓòÉΓòÉΓòÉ <hidden> IThread - Thread Information ΓòÉΓòÉΓòÉ
  7535.  
  7536. Use these members to query and set general thread information. 
  7537.  
  7538.  
  7539. ΓòÉΓòÉΓòÉ <hidden> IThread - Thread Priority ΓòÉΓòÉΓòÉ
  7540.  
  7541. Use these members to control the thread priority.  You can query or set the 
  7542. priority class and level. 
  7543.  
  7544.  
  7545. ΓòÉΓòÉΓòÉ <hidden> Protected Functions - IThread ΓòÉΓòÉΓòÉ
  7546.  
  7547. Constructors
  7548. operator =
  7549.  
  7550. Implementation
  7551. newStartedThread
  7552. startedThread
  7553.  
  7554.  
  7555. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IThread ΓòÉΓòÉΓòÉ
  7556.  
  7557. Inherited Members
  7558. IBase
  7559. recoverable
  7560. unrecoverable
  7561.  
  7562.  
  7563. ΓòÉΓòÉΓòÉ 1.23.1. IThread::adjustPriority ΓòÉΓòÉΓòÉ
  7564.  
  7565. Changes the thread's priority level by the specified amount. 
  7566.  
  7567. public:
  7568. virtual IThread& adjustPriority(int delta);
  7569.  
  7570.  delta     Integer value that represents the priority level delta.  This value 
  7571.            must be between -31 and 31. 
  7572.  
  7573.  Platform Support 
  7574.  
  7575.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7576.   ΓöéPM          ΓöéMOTIF       Γöé
  7577.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7578.   ΓöéYes         ΓöéIgnored     Γöé
  7579.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7580.  
  7581.  Presentation Manager: The delta value is between -31 and 31. 
  7582.  
  7583.  Motif: You cannot adjust the thread's priority on AIX. 
  7584.  
  7585.  Exceptions 
  7586.  
  7587.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7588.   ΓöéIAccessError        ΓöéThe thread priority was not adjusted.   Γöé
  7589.   Γöé                    ΓöéThe priority delta may be invalid.  The Γöé
  7590.   Γöé                    Γöévalid values are -31 to 31.             Γöé
  7591.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7592.  
  7593.  
  7594. ΓòÉΓòÉΓòÉ 1.23.2. IThread::asDebugInfo ΓòÉΓòÉΓòÉ
  7595.  
  7596. Provides debugging information about the class object. Use it to return general 
  7597. diagnostic information about the thread. 
  7598.  
  7599. public:
  7600. virtual IString asDebugInfo() const;
  7601.  
  7602. Platform Support 
  7603.  
  7604. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7605. ΓöéPM          ΓöéMOTIF       Γöé
  7606. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7607. ΓöéYes         ΓöéYes         Γöé
  7608. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7609.  
  7610.  
  7611. ΓòÉΓòÉΓòÉ 1.23.3. IThread::asString ΓòÉΓòÉΓòÉ
  7612.  
  7613. Provides debugging information about the class object. Use it to return a 
  7614. string of the form "IThread(tid).", where tid represents the thread identifier. 
  7615.  
  7616. public:
  7617. virtual IString asString() const;
  7618.  
  7619. Platform Support 
  7620.  
  7621. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7622. ΓöéPM          ΓöéMOTIF       Γöé
  7623. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7624. ΓöéYes         ΓöéYes         Γöé
  7625. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7626.  
  7627.  
  7628. ΓòÉΓòÉΓòÉ 1.23.4. IThread::autoInitGUI ΓòÉΓòÉΓòÉ
  7629.  
  7630. Determines if this thread's GUI support is automatically initialized. 
  7631.  
  7632. public:
  7633. virtual Boolean autoInitGUI() const;
  7634.  
  7635. Platform Support 
  7636.  
  7637. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7638. ΓöéPM          ΓöéMOTIF       Γöé
  7639. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7640. ΓöéYes         ΓöéYes         Γöé
  7641. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7642.  
  7643. Presentation Manager: Obtains the setting of the flag that automatically 
  7644. initializes Presentation Manager for this thread. 
  7645.  
  7646.  
  7647. ΓòÉΓòÉΓòÉ 1.23.5. IThread::current ΓòÉΓòÉΓòÉ
  7648.  
  7649. Returns a reference to an object of the ICurrentThread class that represents 
  7650. the currently executing thread. 
  7651.  
  7652. public:
  7653. static ICurrentThread& current();
  7654.  
  7655. Platform Support 
  7656.  
  7657. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7658. ΓöéPM          ΓöéMOTIF       Γöé
  7659. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7660. ΓöéYes         ΓöéYes         Γöé
  7661. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7662.  
  7663. Used in samples: 
  7664.  
  7665.       Hello World Sample - Version 6: atimehdr.cpp 
  7666.       Multi-Line Entry Field Sample: amle.cpp 
  7667.  
  7668.  
  7669. ΓòÉΓòÉΓòÉ 1.23.6. IThread::currentId ΓòÉΓòÉΓòÉ
  7670.  
  7671. Obtains the identifier (ID) of the currently executing thread. 
  7672.  
  7673. public:
  7674. static IThreadId currentId();
  7675.  
  7676. Platform Support 
  7677.  
  7678. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7679. ΓöéPM          ΓöéMOTIF       Γöé
  7680. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7681. ΓöéYes         ΓöéYes         Γöé
  7682. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7683.  
  7684. Motif: The AIX release of the User Interface Class Library only supports a 
  7685. single thread. Therefore, the current thread ID is always 1. 
  7686.  
  7687.  
  7688. ΓòÉΓòÉΓòÉ 1.23.7. IThread::defaultAutoInitGUI ΓòÉΓòÉΓòÉ
  7689.  
  7690. Determines the default GUI support for automatic initialization.  Unless the 
  7691. support is explicitly set using IThread::setDefaultAutoInitGUI, this function 
  7692. returns true for threads running in a GUI session and false for threads running 
  7693. in a non-GUI session. 
  7694.  
  7695. public:
  7696. static Boolean defaultAutoInitGUI();
  7697.  
  7698. Platform Support 
  7699.  
  7700. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7701. ΓöéPM          ΓöéMOTIF       Γöé
  7702. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7703. ΓöéYes         ΓöéYes         Γöé
  7704. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7705.  
  7706.  
  7707. ΓòÉΓòÉΓòÉ 1.23.8. IThread::defaultQueueSize ΓòÉΓòÉΓòÉ
  7708.  
  7709. Obtains the default message queue size for the threads.  The User Interface 
  7710. Class Library default queue size is 30. 
  7711.  
  7712. Note:  The User Interface Class Library uses this value by default for new 
  7713.        objects of this class. 
  7714.  
  7715.   public:
  7716.   static long defaultQueueSize();
  7717.  
  7718.  Platform Support 
  7719.  
  7720.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7721.   ΓöéPM          ΓöéMOTIF       Γöé
  7722.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7723.   ΓöéYes         ΓöéIgnored     Γöé
  7724.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7725.  
  7726.  Presentation Manager: Obtains the default Presentation Manager message queue 
  7727.  size to use for new IThreads. 
  7728.  
  7729.  Motif: You cannot adjust the queue size on the X environment. This function 
  7730.  returns the queue size that is set using IThread::setDefaultQueueSize. 
  7731.  Initially, this value is 0. 
  7732.  
  7733.  
  7734. ΓòÉΓòÉΓòÉ 1.23.9. IThread::defaultStackSize ΓòÉΓòÉΓòÉ
  7735.  
  7736. Obtains the default stack size for threads in bytes. 
  7737.  
  7738. Note:  The User Interface Class Library uses this value by default for new 
  7739.        objects of this class. 
  7740.  
  7741.   public:
  7742.   static unsigned long defaultStackSize();
  7743.  
  7744.  Platform Support 
  7745.  
  7746.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7747.   ΓöéPM          ΓöéMOTIF       Γöé
  7748.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7749.   ΓöéYes         ΓöéIgnored     Γöé
  7750.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7751.  
  7752.  Motif: You cannot control the stack size for a thread in the X environment. 
  7753.  This function returns the stack size that is set using 
  7754.  IThread::setDefaultStackSize. Initially, this value is 32768. 
  7755.  
  7756.  
  7757. ΓòÉΓòÉΓòÉ 1.23.10. IThread::id ΓòÉΓòÉΓòÉ
  7758.  
  7759. Obtains the identifier (ID) of the thread.  A return value of 0 indicates that 
  7760. the thread is not started. 
  7761.  
  7762. public:
  7763. virtual IThreadId id() const;
  7764.  
  7765. Platform Support 
  7766.  
  7767. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7768. ΓöéPM          ΓöéMOTIF       Γöé
  7769. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7770. ΓöéYes         ΓöéYes         Γöé
  7771. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7772.  
  7773.  
  7774. ΓòÉΓòÉΓòÉ 1.23.11. IThread::isStarted ΓòÉΓòÉΓòÉ
  7775.  
  7776. Determines if this thread is currently active.  If it is currently active, true 
  7777. is returned. 
  7778.  
  7779. public:
  7780. virtual Boolean isStarted() const;
  7781.  
  7782. Platform Support 
  7783.  
  7784. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7785. ΓöéPM          ΓöéMOTIF       Γöé
  7786. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7787. ΓöéYes         ΓöéYes         Γöé
  7788. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7789.  
  7790.  
  7791. ΓòÉΓòÉΓòÉ 1.23.12. IThread::IThread ΓòÉΓòÉΓòÉ
  7792.  
  7793. You can construct, copy, assign, and destruct objects of this class. 
  7794.  
  7795. Overload 1 
  7796.  
  7797. public:
  7798. IThread( SystemFnPtr function,
  7799.          unsigned long functionArgument,
  7800.          Boolean autoInitGUI = defaultAutoInitGUI ( ));
  7801.  
  7802.  function  Pointer to a function that uses the _System calling convention. 
  7803.  
  7804.  functionArgument Unsigned long parameter that you are passing to the function 
  7805.            pointed to by function. 
  7806.  
  7807.  autoInitGUI Boolean value that you use to specify that the thread is a GUI 
  7808.            thread. 
  7809.  
  7810.  Use this constructor to create an object of this class when you need to 
  7811.  specify a function to run that you have defined using the _System calling 
  7812.  convention.  Such functions are typically started using the thread APIs that 
  7813.  are defined for the operating system. 
  7814.  
  7815.  Use this form of the constructor to create a new object of this class and 
  7816.  immediately dispatch it. This is equivalent to using the default constructor 
  7817.  and then dispatching the thread using IThread::start . 
  7818.  
  7819.  This constructor permits you to specify whether or not the new thread is to be 
  7820.  a GUI thread. If it is, ICurrentThread::initializeGUI is called automatically 
  7821.  after the thread is started. 
  7822.  
  7823.  Platform Support 
  7824.  
  7825.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7826.   ΓöéPM          ΓöéMOTIF       Γöé
  7827.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7828.   ΓöéYes         ΓöéNo          Γöé
  7829.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7830.  
  7831.  Overload 2 
  7832.  
  7833.   public:
  7834.   IThread();
  7835.  
  7836.  Use this, the default constructor, to create an object of this class so that 
  7837.  you can subsequently start using IThread::start. 
  7838.  
  7839.  Platform Support 
  7840.  
  7841.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7842.   ΓöéPM          ΓöéMOTIF       Γöé
  7843.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7844.   ΓöéYes         ΓöéYes         Γöé
  7845.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7846.  
  7847.  Overload 3 
  7848.  
  7849.   public:
  7850.   IThread(const IThread& thread);
  7851.  
  7852.  thread    Reference to an object of this class. 
  7853.  
  7854.  Use this constructor if you would like to make a copy of an existing object of 
  7855.  this class.  This is commonly referred to as a copy constructor. 
  7856.  
  7857.  Platform Support 
  7858.  
  7859.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7860.   ΓöéPM          ΓöéMOTIF       Γöé
  7861.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7862.   ΓöéYes         ΓöéYes         Γöé
  7863.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7864.  
  7865.  Overload 4 
  7866.  
  7867.   public:
  7868.   IThread(const IThreadId& threadID);
  7869.  
  7870.  threadID  Reference to a thread identifier of a previously started thread. 
  7871.  
  7872.  Use this constructor to create an object of this class from the thread 
  7873.  identifier (ID) of a previously started thread. You can use this constructor 
  7874.  to provide this class' functionality to threads created using alternate means 
  7875.  (for example, the native operating system's system calls). 
  7876.  
  7877.  Platform Support 
  7878.  
  7879.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7880.   ΓöéPM          ΓöéMOTIF       Γöé
  7881.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7882.   ΓöéYes         ΓöéYes         Γöé
  7883.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7884.  
  7885.  Overload 5 
  7886.  
  7887.   public:
  7888.   IThread( const IReference< IThreadFn>& threadFunction,
  7889.            Boolean autoInitGUI = defaultAutoInitGUI ( ));
  7890.  
  7891.  threadFunction Reference to an object of the IReference template class that 
  7892.            was created using a derived IThreadFn class. 
  7893.  
  7894.  autoInitGUI Boolean value that you use to specify if the thread is a GUI 
  7895.            thread. 
  7896.  
  7897.  Use this constructor to create an object of this class when you need to 
  7898.  specify a function to run that you have defined by deriving a new class from 
  7899.  the IThreadFn class.  This constructor passes the derived IThreadFn using an 
  7900.  object of the IReference class so that the derived IThreadFn can be deleted 
  7901.  (if necessary) when the thread terminates. 
  7902.  
  7903.  Use this form of the constructor to create a new object of this class and 
  7904.  immediately dispatch it. This is equivalent to using the default constructor 
  7905.  and then dispatching the thread using IThread::start. 
  7906.  
  7907.  This constructor permits you to specify whether or not the new thread is to be 
  7908.  a GUI thread. If it is, ICurrentThread::initializeGUI is called automatically 
  7909.  after the thread is started. 
  7910.  
  7911.  Platform Support 
  7912.  
  7913.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7914.   ΓöéPM          ΓöéMOTIF       Γöé
  7915.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7916.   ΓöéYes         ΓöéNo          Γöé
  7917.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7918.  
  7919.  Overload 6 
  7920.  
  7921.   public:
  7922.   IThread( OptlinkFnPtr function,
  7923.            void* functionArgument,
  7924.            Boolean autoInitGUI = defaultAutoInitGUI ( ));
  7925.  
  7926.  function  Pointer to a function that uses the _Optlink calling convention. 
  7927.  
  7928.  functionArgument Pointer to a parameter that you are passing to the function 
  7929.            pointed to by function. 
  7930.  
  7931.  autoInitGUI Boolean value that you use to specify that the thread is a GUI 
  7932.            thread. 
  7933.  
  7934.  Use this constructor to create an object of this class when you need to 
  7935.  specify a function to run that is defined with the _Optlink calling 
  7936.  convention.  Such functions are typically started using the function 
  7937.  _beginThread. 
  7938.  
  7939.  Use this form of the constructor to create a new object of this class and 
  7940.  immediately dispatch it. This is equivalent to using the default constructor 
  7941.  and then dispatching the thread using IThread::start. 
  7942.  
  7943.  This constructor permits you to specify whether the new thread is to be a GUI 
  7944.  thread. If it is, ICurrentThread::initializeGUI is called automatically after 
  7945.  the thread is started. 
  7946.  
  7947.  Platform Support 
  7948.  
  7949.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7950.   ΓöéPM          ΓöéMOTIF       Γöé
  7951.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7952.   ΓöéYes         ΓöéNo          Γöé
  7953.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7954.  
  7955.  
  7956. ΓòÉΓòÉΓòÉ 1.23.13. IThread::messageQueue ΓòÉΓòÉΓòÉ
  7957.  
  7958. Returns the handle of the message queue.  A 0 is returned if the handle does 
  7959. not exist or is invalid. 
  7960.  
  7961. Overload 1 
  7962.  
  7963. public:
  7964. IMessageQueueHandle messageQueue();
  7965.  
  7966. Use this version of the function if you want to reset an invalid message queue 
  7967. handle to 0.  Do this if the handle is determined to be invalid. 
  7968.  
  7969. Platform Support 
  7970.  
  7971. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7972. ΓöéPM          ΓöéMOTIF       Γöé
  7973. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7974. ΓöéYes         ΓöéNo          Γöé
  7975. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7976.  
  7977. Overload 2 
  7978.  
  7979. public:
  7980. IMessageQueueHandle messageQueue() const;
  7981.  
  7982. Use this version of the function if you want the invalid message queue handle 
  7983. to remain invalid. 
  7984.  
  7985. Platform Support 
  7986.  
  7987. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  7988. ΓöéPM          ΓöéMOTIF       Γöé
  7989. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  7990. ΓöéYes         ΓöéNo          Γöé
  7991. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  7992.  
  7993.  
  7994. ΓòÉΓòÉΓòÉ 1.23.14. IThread::newStartedThread ΓòÉΓòÉΓòÉ
  7995.  
  7996. Creates an object of the IStartedThread class. 
  7997.  
  7998. protected:
  7999. static IStartedThread* newStartedThread();
  8000.  
  8001. Platform Support 
  8002.  
  8003. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8004. ΓöéPM          ΓöéMOTIF       Γöé
  8005. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8006. ΓöéYes         ΓöéYes         Γöé
  8007. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8008.  
  8009.  
  8010. ΓòÉΓòÉΓòÉ 1.23.15. IThread::operator = ΓòÉΓòÉΓòÉ
  8011.  
  8012. Assigns the member data of an object of this class to another object of this 
  8013. class, therefore preserving resource allocation. 
  8014.  
  8015. protected:
  8016. IThread& operator =(const IThread& thread);
  8017.  
  8018.  thread    Reference to an existing thread object. 
  8019.  
  8020.  Platform Support 
  8021.  
  8022.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8023.   ΓöéPM          ΓöéMOTIF       Γöé
  8024.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8025.   ΓöéYes         ΓöéYes         Γöé
  8026.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8027.  
  8028.  
  8029. ΓòÉΓòÉΓòÉ 1.23.16. IThread::priorityClass ΓòÉΓòÉΓòÉ
  8030.  
  8031. Obtains the priority class of this thread. The return value is an enumerator 
  8032. provided by IApplication::PriorityClass . 
  8033.  
  8034. public:
  8035. virtual IApplication::PriorityClass priorityClass() const;
  8036.  
  8037. Platform Support 
  8038.  
  8039. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8040. ΓöéPM          ΓöéMOTIF       Γöé
  8041. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8042. ΓöéYes         ΓöéIgnored     Γöé
  8043. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8044.  
  8045. Motif: The priority class for AIX is always IApplication::regular. 
  8046.  
  8047.  
  8048. ΓòÉΓòÉΓòÉ 1.23.17. IThread::priorityLevel ΓòÉΓòÉΓòÉ
  8049.  
  8050. Obtains the priority level of this thread.  The return value is between 0 and 
  8051. 31. 
  8052.  
  8053. public:
  8054. virtual unsigned priorityLevel() const;
  8055.  
  8056. Platform Support 
  8057.  
  8058. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8059. ΓöéPM          ΓöéMOTIF       Γöé
  8060. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8061. ΓöéYes         ΓöéIgnored     Γöé
  8062. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8063.  
  8064. Presentation Manager: The value of the level is in the range 0-31. 
  8065.  
  8066. Motif: The level for AIX is always 0. 
  8067.  
  8068.  
  8069. ΓòÉΓòÉΓòÉ 1.23.18. IThread::queueSize ΓòÉΓòÉΓòÉ
  8070.  
  8071. Obtains the message queue size for the thread. This is the thread used by the 
  8072. application to receive events from the operating system. 
  8073.  
  8074. public:
  8075. virtual long queueSize() const;
  8076.  
  8077. Platform Support 
  8078.  
  8079. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8080. ΓöéPM          ΓöéMOTIF       Γöé
  8081. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8082. ΓöéYes         ΓöéIgnored     Γöé
  8083. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8084.  
  8085. Motif: You cannot control the size of the message queue in the X environment. 
  8086. This function returns the value set by IThread::setQueueSize. The default value 
  8087. is defaultQueueSize. 
  8088.  
  8089.  
  8090. ΓòÉΓòÉΓòÉ 1.23.19. IThread::relatedHandlesList ΓòÉΓòÉΓòÉ
  8091.  
  8092. Obtains a pointer to the related handles list for this thread. 
  8093.  
  8094. public:
  8095. IRelatedHandlesList* relatedHandlesList() const;
  8096.  
  8097. Platform Support 
  8098.  
  8099. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8100. ΓöéPM          ΓöéMOTIF       Γöé
  8101. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8102. ΓöéNo          ΓöéYes         Γöé
  8103. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8104.  
  8105.  
  8106. ΓòÉΓòÉΓòÉ 1.23.20. IThread::resume ΓòÉΓòÉΓòÉ
  8107.  
  8108. Resumes the thread's execution. 
  8109.  
  8110. public:
  8111. virtual void resume();
  8112.  
  8113. Platform Support 
  8114.  
  8115. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8116. ΓöéPM          ΓöéMOTIF       Γöé
  8117. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8118. ΓöéYes         ΓöéIgnored     Γöé
  8119. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8120.  
  8121. Motif: The AIX release of the User Interface Class Library supports only a 
  8122. single-threaded environment. Therefore, you cannot suspend or resume a thread. 
  8123.  
  8124. Exceptions 
  8125.  
  8126. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8127. ΓöéIAccessError        ΓöéThe thread was not resumed.  The thread Γöé
  8128. Γöé                    Γöéwas not suspended or the thread         Γöé
  8129. Γöé                    Γöéidentifier (ID) is invalid.             Γöé
  8130. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8131.  
  8132.  
  8133. ΓòÉΓòÉΓòÉ 1.23.21. IThread::setAutoInitGUI ΓòÉΓòÉΓòÉ
  8134.  
  8135. Sets the automatic initialization state for this thread.  Set initFlag to true, 
  8136. the default, for GUI-based threads and to false for non-GUI-based threads. 
  8137.  
  8138. public:
  8139. virtual IThread& setAutoInitGUI(Boolean initFlag = true);
  8140.  
  8141.  initFlag  Boolean value that determines if GUI support is automatically 
  8142.            initialized for this thread. 
  8143.  
  8144.  Platform Support 
  8145.  
  8146.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8147.   ΓöéPM          ΓöéMOTIF       Γöé
  8148.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8149.   ΓöéYes         ΓöéYes         Γöé
  8150.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8151.  
  8152.  Motif: Regardless of the value set by this function, the GUI is always 
  8153.  initialized in AIX because of the User Interface Class Library's 
  8154.  single-threaded limitation. 
  8155.  
  8156.  
  8157. ΓòÉΓòÉΓòÉ 1.23.22. IThread::setDefaultAutoInitGUI ΓòÉΓòÉΓòÉ
  8158.  
  8159. Sets the default GUI support for automatic initialization.  Set initFlag to 
  8160. true, the default, for GUI-based threads and to false for non-GUI-based 
  8161. threads. 
  8162.  
  8163. public:
  8164. static void setDefaultAutoInitGUI(Boolean initFlag = true);
  8165.  
  8166.  initFlag  Boolean value that determines if GUI support is automatically 
  8167.            initialized for this thread. 
  8168.  
  8169.  Platform Support 
  8170.  
  8171.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8172.   ΓöéPM          ΓöéMOTIF       Γöé
  8173.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8174.   ΓöéYes         ΓöéYes         Γöé
  8175.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8176.  
  8177.  Motif: Regardless of the value set by this function, the GUI is always 
  8178.  initialized in AIX because of the User Interface Class Library's 
  8179.  single-threaded limitation. 
  8180.  
  8181.  
  8182. ΓòÉΓòÉΓòÉ 1.23.23. IThread::setDefaultQueueSize ΓòÉΓòÉΓòÉ
  8183.  
  8184. Sets the default message queue size for threads.  The User Interface Class 
  8185. Library default queue size is 30. 
  8186.  
  8187. Note:  The User Interface Class Library uses this value by default for new 
  8188.        objects of this class. 
  8189.  
  8190.   public:
  8191.   static void setDefaultQueueSize(long queueSize);
  8192.  
  8193.  aSize     Long value that represents the default message queue size. 
  8194.  
  8195.  Platform Support 
  8196.  
  8197.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8198.   ΓöéPM          ΓöéMOTIF       Γöé
  8199.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8200.   ΓöéYes         ΓöéIgnored     Γöé
  8201.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8202.  
  8203.  Motif: You cannot control the size of the queue in the X environment. This 
  8204.  function has no affect on the message queue size. The value set by this 
  8205.  function is the value returned by IThread::defaultQueueSize. 
  8206.  
  8207.  
  8208. ΓòÉΓòÉΓòÉ 1.23.24. IThread::setDefaultStackSize ΓòÉΓòÉΓòÉ
  8209.  
  8210. Sets the default stack size for threads in bytes. 
  8211.  
  8212. Note:  The User Interface Class Library uses this value by default for new 
  8213.        objects of this class. 
  8214.  
  8215.   public:
  8216.   static void setDefaultStackSize(unsigned long size);
  8217.  
  8218.  size      Unsigned long value that represents the default stack size in bytes. 
  8219.  
  8220.  Platform Support 
  8221.  
  8222.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8223.   ΓöéPM          ΓöéMOTIF       Γöé
  8224.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8225.   ΓöéYes         ΓöéIgnored     Γöé
  8226.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8227.  
  8228.  Motif: You cannot control the size of the stack in the AIX environment. This 
  8229.  function has no affect on the size of the stack. The value set by this 
  8230.  function is the value returned by IThread::defaultStackSize. 
  8231.  
  8232.  
  8233. ΓòÉΓòÉΓòÉ 1.23.25. IThread::setPriority ΓòÉΓòÉΓòÉ
  8234.  
  8235. Sets the priority class and level of this thread. 
  8236.  
  8237. public:
  8238. virtual IThread&
  8239.   setPriority( IApplication::PriorityClass priority,
  8240.                unsigned level);
  8241.  
  8242.  priority  IApplication::PriorityClass enumerator that identifies the priority 
  8243.            class. 
  8244.  
  8245.  level     Unsigned value that represents the priority level. 
  8246.  
  8247.  Platform Support 
  8248.  
  8249.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8250.   ΓöéPM          ΓöéMOTIF       Γöé
  8251.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8252.   ΓöéYes         ΓöéIgnored     Γöé
  8253.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8254.  
  8255.  Motif: You cannot control the priority of a thread in the AIX environment. 
  8256.  This function has no effect on the priority of an executing thread. 
  8257.  
  8258.  Exceptions 
  8259.  
  8260.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8261.   ΓöéIAccessError        ΓöéThe thread priority was not set.  The   Γöé
  8262.   Γöé                    Γöépriority class or level may be invalid. Γöé
  8263.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8264.  
  8265.  
  8266. ΓòÉΓòÉΓòÉ 1.23.26. IThread::setQueueSize ΓòÉΓòÉΓòÉ
  8267.  
  8268. Sets the GUI message queue size for this thread. 
  8269.  
  8270. public:
  8271. virtual IThread& setQueueSize(long queueSize);
  8272.  
  8273.  queueSize Long value that represents the new message queue size. 
  8274.  
  8275.  Platform Support 
  8276.  
  8277.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8278.   ΓöéPM          ΓöéMOTIF       Γöé
  8279.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8280.   ΓöéYes         ΓöéIgnored     Γöé
  8281.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8282.  
  8283.  Motif: You cannot control the message queue size for X. This function has no 
  8284.  affect on the size of the message queue. The value set by this function is the 
  8285.  value returned by IThread::queueSize. 
  8286.  
  8287.  
  8288. ΓòÉΓòÉΓòÉ 1.23.27. IThread::setRelatedHandlesList ΓòÉΓòÉΓòÉ
  8289.  
  8290. Sets a pointer to the related handles list for this thread. 
  8291.  
  8292. public:
  8293. IThread& setRelatedHandlesList(IRelatedHandlesList* list);
  8294.  
  8295.  list      Pointer to an IRelatedHandlesList object to set for this thread. 
  8296.  
  8297.  Platform Support 
  8298.  
  8299.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8300.   ΓöéPM          ΓöéMOTIF       Γöé
  8301.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8302.   ΓöéNo          ΓöéYes         Γöé
  8303.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8304.  
  8305.  
  8306. ΓòÉΓòÉΓòÉ 1.23.28. IThread::setStackSize ΓòÉΓòÉΓòÉ
  8307.  
  8308. Sets this thread's stack size in bytes. If you have already started the thread, 
  8309. this value takes effect only when the thread is stopped and restarted. 
  8310.  
  8311. public:
  8312. virtual IThread& setStackSize(unsigned long size);
  8313.  
  8314.  size      Unsigned long value that represents the stack size in bytes. 
  8315.  
  8316.  Platform Support 
  8317.  
  8318.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8319.   ΓöéPM          ΓöéMOTIF       Γöé
  8320.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8321.   ΓöéYes         ΓöéIgnored     Γöé
  8322.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8323.  
  8324.  Motif: You cannot control the stack size in AIX. This function has no affect 
  8325.  on the size of the stack used. The value set by this function is the value 
  8326.  returned by IThread::stackSize. 
  8327.  
  8328.  
  8329. ΓòÉΓòÉΓòÉ 1.23.29. IThread::setVariable ΓòÉΓòÉΓòÉ
  8330.  
  8331. Stores data and an associated key, on a per thread instance. You can later 
  8332. retrieve this data using IThread::variable. You can store up to 16 keys and 
  8333. their associated data per thread. 
  8334.  
  8335. public:
  8336. IThread&
  8337.   setVariable( const IString&key,
  8338.                const IString&value);
  8339.  
  8340.  key       Reference to an IString object that represents the search key that 
  8341.            is associated with the stored data. 
  8342.  
  8343.  value     Reference to an IString object that contains the data to be stored. 
  8344.  
  8345.  Platform Support 
  8346.  
  8347.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8348.   ΓöéPM          ΓöéMOTIF       Γöé
  8349.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8350.   ΓöéYes         ΓöéYes         Γöé
  8351.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8352.  
  8353.  Exceptions 
  8354.  
  8355.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8356.   ΓöéIInvalidRequest     ΓöéThe keyed variable could not be set     Γöé
  8357.   Γöé                    Γöébecause the limit has been reached.     Γöé
  8358.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8359.  
  8360.  
  8361. ΓòÉΓòÉΓòÉ 1.23.30. IThread::setWindowList ΓòÉΓòÉΓòÉ
  8362.  
  8363. Sets a pointer to the window information list for this thread. 
  8364.  
  8365. public:
  8366. IThread& setWindowList(IWindowList* list);
  8367.  
  8368.  list      Pointer to an IWindowList object to set for this thread. 
  8369.  
  8370.  Platform Support 
  8371.  
  8372.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8373.   ΓöéPM          ΓöéMOTIF       Γöé
  8374.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8375.   ΓöéYes         ΓöéYes         Γöé
  8376.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8377.  
  8378.  
  8379. ΓòÉΓòÉΓòÉ 1.23.31. IThread::stackSize ΓòÉΓòÉΓòÉ
  8380.  
  8381. Obtains this thread's stack size in bytes. 
  8382.  
  8383. public:
  8384. virtual unsigned long stackSize() const;
  8385.  
  8386. Platform Support 
  8387.  
  8388. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8389. ΓöéPM          ΓöéMOTIF       Γöé
  8390. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8391. ΓöéYes         ΓöéIgnored     Γöé
  8392. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8393.  
  8394. Motif: Returns the value of the stack size that was set with the function 
  8395. setStackSize.  You cannot control the size of the stack in AIX; therefore, this 
  8396. is not actually the size of the stack. The default value is defaultStackSize. 
  8397.  
  8398.  
  8399. ΓòÉΓòÉΓòÉ 1.23.32. IThread::start ΓòÉΓòÉΓòÉ
  8400.  
  8401. Starts an asynchronous thread. 
  8402.  
  8403. Overload 1 
  8404.  
  8405. public:
  8406. void
  8407.   start( const IReference< IThreadFn>& threadFunction,
  8408.          Boolean autoInitGUI = defaultAutoInitGUI ( ));
  8409.  
  8410.  threadFunction Reference to an object of the IReference template class that 
  8411.            was created using a derived IThreadFn class. 
  8412.  
  8413.  autoInitGUI Boolean value that you use to specify if the thread is a GUI 
  8414.            thread. 
  8415.  
  8416.  You can start threads with a derived IThreadFn class.  This function passes 
  8417.  the derived IThreadFn using an object of the IReference class so that the 
  8418.  derived IThreadFn can be deleted (if necessary) when the thread terminates. 
  8419.  
  8420.  This function permits you to specify whether the thread is started as a GUI 
  8421.  thread.  If it is, ICurrentThread::initializeGUI is called automatically after 
  8422.  the thread is started. 
  8423.  
  8424.  Platform Support 
  8425.  
  8426.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8427.   ΓöéPM          ΓöéMOTIF       Γöé
  8428.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8429.   ΓöéYes         ΓöéNo          Γöé
  8430.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8431.  
  8432.  Presentation Manager: The OS/2 version also allows threads to be started via 
  8433.  the following means: 
  8434.  
  8435.      With an IThread::OptlinkFnPtr type and void* parameter. This is to 
  8436.       provide support for functions otherwise started using _beginthread. 
  8437.  
  8438.      With an IThread::SystemFnPtr type and unsigned long parameter.  This is 
  8439.       to provide support for functions otherwise started using DosCreateThread. 
  8440.  
  8441.  Motif: Because the User Interface Class Library supports only single 
  8442.  threading, there is no need to call this function. 
  8443.  
  8444.  Overload 2 
  8445.  
  8446.   public:
  8447.   void
  8448.     start( OptlinkFnPtr function,
  8449.            void* functionArgument,
  8450.            Boolean autoInitGUI = defaultAutoInitGUI ( ));
  8451.  
  8452.  function  Pointer to a function which uses the _Optlink calling convention. 
  8453.  
  8454.  functionArgument Pointer to a parameter that you are passing to the function 
  8455.            pointed to by pfn. 
  8456.  
  8457.  autoInitGUI Boolean value that you use to specify if the thread is a GUI 
  8458.            thread. 
  8459.  
  8460.  You can start threads with a function that is defined using the _Optlink 
  8461.  calling convention.  Such functions are typically started using the function, 
  8462.  _beginThread.  This function gives you the same capability. 
  8463.  
  8464.  This constructor permits you to specify whether the new thread is to be a GUI 
  8465.  thread. If it is, ICurrentThread::initializeGUI is called automatically after 
  8466.  the thread is started. 
  8467.  
  8468.  Platform Support 
  8469.  
  8470.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8471.   ΓöéPM          ΓöéMOTIF       Γöé
  8472.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8473.   ΓöéYes         ΓöéNo          Γöé
  8474.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8475.  
  8476.  Overload 3 
  8477.  
  8478.   public:
  8479.   void
  8480.     start( SystemFnPtr function,
  8481.            unsigned long functionArgument,
  8482.            Boolean autoInitGUI = defaultAutoInitGUI ( ));
  8483.  
  8484.  function  Pointer to a function which uses the _System calling convention. 
  8485.  
  8486.  functionArgument Unsigned long parameter that you are passing to the function 
  8487.            pointed to by pfn. 
  8488.  
  8489.  autoInitGUI Boolean value that you use to specify if the thread is a GUI 
  8490.            thread. 
  8491.  
  8492.  You can start threads with a function that is defined using the _System 
  8493.  calling convention.  Such functions are typically started using the thread 
  8494.  APIs that are defined for the operating system. This function gives you the 
  8495.  same capability. 
  8496.  
  8497.  This constructor permits you to specify whether the new thread is to be a GUI 
  8498.  thread.  If it is, ICurrentThread::initializeGUI is called automatically after 
  8499.  the thread is started. 
  8500.  
  8501.  Platform Support 
  8502.  
  8503.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8504.   ΓöéPM          ΓöéMOTIF       Γöé
  8505.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8506.   ΓöéYes         ΓöéNo          Γöé
  8507.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8508.  
  8509.  
  8510. ΓòÉΓòÉΓòÉ 1.23.33. IThread::startedThread ΓòÉΓòÉΓòÉ
  8511.  
  8512. Returns a pointer to the object of the IStartedThread class that corresponds to 
  8513. this thread. 
  8514.  
  8515. protected:
  8516. virtual IStartedThread* startedThread() const;
  8517.  
  8518. Platform Support 
  8519.  
  8520. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8521. ΓöéPM          ΓöéMOTIF       Γöé
  8522. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8523. ΓöéYes         ΓöéYes         Γöé
  8524. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8525.  
  8526.  
  8527. ΓòÉΓòÉΓòÉ 1.23.34. IThread::stop ΓòÉΓòÉΓòÉ
  8528.  
  8529. Stops the thread. 
  8530.  
  8531. public:
  8532. virtual void stop();
  8533.  
  8534. Platform Support 
  8535.  
  8536. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8537. ΓöéPM          ΓöéMOTIF       Γöé
  8538. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8539. ΓöéYes         ΓöéYes         Γöé
  8540. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8541.  
  8542. Exceptions 
  8543.  
  8544. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8545. ΓöéIAccessError        ΓöéThe thread was not stopped.  The thread Γöé
  8546. Γöé                    Γöéwas either busy or the thread identifierΓöé
  8547. Γöé                    Γöé(ID) is invalid.                        Γöé
  8548. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8549.  
  8550.  
  8551. ΓòÉΓòÉΓòÉ 1.23.35. IThread::stopProcessingMsgs ΓòÉΓòÉΓòÉ
  8552.  
  8553. Terminates the processing of window events (messages) initiated by 
  8554. ICurrentThread::processMsgs. 
  8555.  
  8556. public:
  8557. virtual IThread& stopProcessingMsgs();
  8558.  
  8559. Platform Support 
  8560.  
  8561. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8562. ΓöéPM          ΓöéMOTIF       Γöé
  8563. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8564. ΓöéYes         ΓöéYes         Γöé
  8565. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8566.  
  8567. Exceptions 
  8568.  
  8569. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8570. ΓöéIInvalidRequest     ΓöéThe event processing was not terminated.Γöé
  8571. Γöé                    ΓöéThe termination failed because the eventΓöé
  8572. Γöé                    Γöéprocessing was not initiated by         Γöé
  8573. Γöé                    ΓöéICurrentThread::processMsgs.            Γöé
  8574. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8575.  
  8576.  
  8577. ΓòÉΓòÉΓòÉ 1.23.36. IThread::suspend ΓòÉΓòÉΓòÉ
  8578.  
  8579. Suspends the thread's execution. 
  8580.  
  8581. public:
  8582. virtual void suspend();
  8583.  
  8584. Platform Support 
  8585.  
  8586. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8587. ΓöéPM          ΓöéMOTIF       Γöé
  8588. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8589. ΓöéYes         ΓöéIgnored     Γöé
  8590. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8591.  
  8592. Motif: The User Interface Class Library supports only single threading; 
  8593. therefore, suspend and resume have no effect. 
  8594.  
  8595. Exceptions 
  8596.  
  8597. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8598. ΓöéIAccessError        ΓöéThe thread was not suspended.  The      Γöé
  8599. Γöé                    Γöéthread identifier (ID) is invalid.      Γöé
  8600. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8601.  
  8602.  
  8603. ΓòÉΓòÉΓòÉ 1.23.37. IThread::variable ΓòÉΓòÉΓòÉ
  8604.  
  8605. Returns the data associated with the key that was stored using 
  8606. IThread::setVariable. 
  8607.  
  8608. public:
  8609. IString variable(const IString& key) const;
  8610.  
  8611.  key       Reference to an IString object that represents the search key. 
  8612.  
  8613.  Platform Support 
  8614.  
  8615.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8616.   ΓöéPM          ΓöéMOTIF       Γöé
  8617.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8618.   ΓöéYes         ΓöéYes         Γöé
  8619.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8620.  
  8621.  
  8622. ΓòÉΓòÉΓòÉ 1.23.38. IThread::windowList ΓòÉΓòÉΓòÉ
  8623.  
  8624. Obtains a pointer to the window information list for this thread. 
  8625.  
  8626. public:
  8627. IWindowList* windowList() const;
  8628.  
  8629. Platform Support 
  8630.  
  8631. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8632. ΓöéPM          ΓöéMOTIF       Γöé
  8633. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8634. ΓöéYes         ΓöéYes         Γöé
  8635. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8636.  
  8637.  
  8638. ΓòÉΓòÉΓòÉ 1.23.39. IThread::~IThread ΓòÉΓòÉΓòÉ
  8639.  
  8640. This virtual destructor deallocates resources. 
  8641.  
  8642. Note:  When objects of this class are destructed, the thread is not terminated. 
  8643.  
  8644.   public:
  8645.   virtual  ~IThread();
  8646.  
  8647.  Platform Support 
  8648.  
  8649.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8650.   ΓöéPM          ΓöéMOTIF       Γöé
  8651.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8652.   ΓöéYes         ΓöéYes         Γöé
  8653.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8654.  
  8655.  
  8656. ΓòÉΓòÉΓòÉ <hidden> Nested Types - IThread ΓòÉΓòÉΓòÉ
  8657.  
  8658. Classes 
  8659.  
  8660.        IThread::Cursor 
  8661.  
  8662.  Type Definitions 
  8663.  
  8664.        ( unsigned long ) 
  8665.        ( void * ) 
  8666.  
  8667.  
  8668. ΓòÉΓòÉΓòÉ <hidden> Type Definition - IThread::( unsigned long ) ΓòÉΓòÉΓòÉ
  8669.  
  8670. typedef void ( _System * SystemFnPtr ) ( unsigned long );
  8671.  
  8672. This typedef defines a pointer to a function that uses the _System calling 
  8673. convention. 
  8674.  
  8675. Note:  _System is the default calling convention for the OS/2 operating system. 
  8676.  
  8677.  
  8678. ΓòÉΓòÉΓòÉ <hidden> Type Definition - IThread::( void * ) ΓòÉΓòÉΓòÉ
  8679.  
  8680. typedef void ( _Optlink * OptlinkFnPtr ) ( void * );
  8681.  
  8682. This typedef defines a pointer to a function that uses the _Optlink calling 
  8683. convention. 
  8684.  
  8685. Note:  _Optlink is the default calling convention for IBM VisualAge C++. 
  8686.  
  8687.  
  8688. ΓòÉΓòÉΓòÉ 1.24. IThread::Cursor ΓòÉΓòÉΓòÉ
  8689.  
  8690. Description 
  8691.  
  8692. Derivation 
  8693.  
  8694. Constructors 
  8695.  
  8696. Public Functions 
  8697.  
  8698. Protected Data 
  8699.  
  8700. To close all the panels in a chapter, double click on this panel's system menu. 
  8701.  
  8702.  
  8703. ΓòÉΓòÉΓòÉ <hidden> Derivation - IThread::Cursor ΓòÉΓòÉΓòÉ
  8704.  
  8705. IBase
  8706.   Γöé
  8707. IVBase
  8708.   Γöé
  8709. IThread::Cursor
  8710.  
  8711. Inherited by none. 
  8712.  
  8713.  
  8714. ΓòÉΓòÉΓòÉ <hidden> Class Description - IThread::Cursor ΓòÉΓòÉΓòÉ
  8715.  
  8716. ithread.hpp 
  8717.  
  8718. The IThread::Cursor class creates and manages the cursor for an IThread object. 
  8719. This nested class defines objects that you can use to traverse or iterate 
  8720. through a set of active threads. In the same way that you can use a cursor to 
  8721. traverse the objects in a collection, you can use this cursor to traverse a set 
  8722. of threads one at a time. 
  8723.  
  8724. Typically, you traverse a set, or collection, of active threads by doing the 
  8725. following: 
  8726.  
  8727.    1. Calling setToFirst 
  8728.    2. Looping through the threads using setToNext 
  8729.    3. Processing the returned thread IDs from threadId until isValid returns 
  8730.       false 
  8731.  
  8732.  Note:  This class only provides access to threads that an IThread object 
  8733.         represents. 
  8734.  
  8735.  
  8736. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IThread::Cursor ΓòÉΓòÉΓòÉ
  8737.  
  8738. Constructors
  8739. Cursor
  8740. ~Cursor
  8741.  
  8742. Thread Iteration
  8743. invalidate
  8744. isValid
  8745. setToFirst
  8746. setToNext
  8747. threadId
  8748.  
  8749. Inherited Members
  8750. IVBase
  8751. asDebugInfo
  8752. asString
  8753.  
  8754. IBase
  8755. asDebugInfo
  8756. asString
  8757. messageFile
  8758. messageText
  8759. setMessageFile
  8760. version
  8761.  
  8762.  
  8763. ΓòÉΓòÉΓòÉ <hidden> IThread::Cursor - Constructors ΓòÉΓòÉΓòÉ
  8764.  
  8765. Use these members to construct and destruct objects of this nested class. 
  8766.  
  8767.  
  8768. ΓòÉΓòÉΓòÉ <hidden> IThread::Cursor - Hidden Members ΓòÉΓòÉΓòÉ
  8769.  
  8770. You cannot access these members. 
  8771.  
  8772.  
  8773. ΓòÉΓòÉΓòÉ <hidden> IThread::Cursor - Thread Iteration ΓòÉΓòÉΓòÉ
  8774.  
  8775. Use these members to iterate through the set of active threads. 
  8776.  
  8777.  
  8778. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IThread::Cursor ΓòÉΓòÉΓòÉ
  8779.  
  8780. Inherited Members
  8781. IBase
  8782. recoverable
  8783. unrecoverable
  8784.  
  8785.  
  8786. ΓòÉΓòÉΓòÉ 1.24.1. IThread::Cursor::Cursor ΓòÉΓòÉΓòÉ
  8787.  
  8788. You can only use this constructor to create objects of this class. It accepts 
  8789. an optional flag, that indicates how threads are enumerated. 
  8790.  
  8791. public:
  8792. Cursor(Boolean allThreads = true);
  8793.  
  8794.  allThreads Boolean value that determines if all threads are enumerated or only 
  8795.            those that have User Interface Class Library windows.  The default 
  8796.            is for all threads to be enumerated.  Optional. 
  8797.  
  8798.  Platform Support 
  8799.  
  8800.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8801.   ΓöéPM          ΓöéMOTIF       Γöé
  8802.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8803.   ΓöéYes         ΓöéYes         Γöé
  8804.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8805.  
  8806.  
  8807. ΓòÉΓòÉΓòÉ 1.24.2. IThread::Cursor::invalidate ΓòÉΓòÉΓòÉ
  8808.  
  8809. Marks the cursor as invalid. 
  8810.  
  8811. public:
  8812. virtual void invalidate();
  8813.  
  8814. Platform Support 
  8815.  
  8816. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8817. ΓöéPM          ΓöéMOTIF       Γöé
  8818. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8819. ΓöéYes         ΓöéYes         Γöé
  8820. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8821.  
  8822.  
  8823. ΓòÉΓòÉΓòÉ 1.24.3. IThread::Cursor::isValid ΓòÉΓòÉΓòÉ
  8824.  
  8825. Determines if the cursor is valid. If it is valid, true is returned. 
  8826.  
  8827. public:
  8828. Boolean isValid() const;
  8829.  
  8830. Platform Support 
  8831.  
  8832. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8833. ΓöéPM          ΓöéMOTIF       Γöé
  8834. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8835. ΓöéYes         ΓöéYes         Γöé
  8836. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8837.  
  8838.  
  8839. ΓòÉΓòÉΓòÉ 1.24.4. IThread::Cursor::setToFirst ΓòÉΓòÉΓòÉ
  8840.  
  8841. Sets the cursor's position to the first thread. 
  8842.  
  8843. public:
  8844. Boolean setToFirst();
  8845.  
  8846. Platform Support 
  8847.  
  8848. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8849. ΓöéPM          ΓöéMOTIF       Γöé
  8850. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8851. ΓöéYes         ΓöéYes         Γöé
  8852. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8853.  
  8854.  
  8855. ΓòÉΓòÉΓòÉ 1.24.5. IThread::Cursor::setToNext ΓòÉΓòÉΓòÉ
  8856.  
  8857. Advances the cursor's position to the next thread. 
  8858.  
  8859. public:
  8860. Boolean setToNext();
  8861.  
  8862. Platform Support 
  8863.  
  8864. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8865. ΓöéPM          ΓöéMOTIF       Γöé
  8866. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8867. ΓöéYes         ΓöéYes         Γöé
  8868. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8869.  
  8870.  
  8871. ΓòÉΓòÉΓòÉ 1.24.6. IThread::Cursor::threadId ΓòÉΓòÉΓòÉ
  8872.  
  8873. Obtains the identifier (ID) of the thread at the current cursor position. 
  8874.  
  8875. public:
  8876. IThreadId threadId() const;
  8877.  
  8878. Platform Support 
  8879.  
  8880. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8881. ΓöéPM          ΓöéMOTIF       Γöé
  8882. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8883. ΓöéYes         ΓöéYes         Γöé
  8884. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8885.  
  8886. Exceptions 
  8887.  
  8888. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8889. ΓöéIInvalidParameter   ΓöéThe thread identifier (ID) was not      Γöé
  8890. Γöé                    Γöéreturned.  The cursor is not valid.     Γöé
  8891. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8892.  
  8893.  
  8894. ΓòÉΓòÉΓòÉ 1.24.7. IThread::Cursor::~Cursor ΓòÉΓòÉΓòÉ
  8895.  
  8896. public:
  8897. virtual  ~Cursor();
  8898.  
  8899. Platform Support 
  8900.  
  8901. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  8902. ΓöéPM          ΓöéMOTIF       Γöé
  8903. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  8904. ΓöéYes         ΓöéYes         Γöé
  8905. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  8906.  
  8907.  
  8908. ΓòÉΓòÉΓòÉ 1.25. IThreadFn ΓòÉΓòÉΓòÉ
  8909.  
  8910. Description 
  8911.  
  8912. Derivation 
  8913.  
  8914. Constructors 
  8915.  
  8916. Public Functions 
  8917.  
  8918. Protected Data 
  8919.  
  8920. To close all the panels in a chapter, double click on this panel's system menu. 
  8921.  
  8922.  
  8923. ΓòÉΓòÉΓòÉ <hidden> Derivation - IThreadFn ΓòÉΓòÉΓòÉ
  8924.  
  8925. IBase
  8926.   Γöé
  8927. IVBase
  8928.   Γöé
  8929. IRefCounted
  8930.   Γöé
  8931. IThreadFn
  8932.  
  8933. Inherited by: 
  8934.  
  8935.       IThreadMemberFn 
  8936.  
  8937.  
  8938. ΓòÉΓòÉΓòÉ <hidden> Class Description - IThreadFn ΓòÉΓòÉΓòÉ
  8939.  
  8940. ithread.hpp 
  8941.  
  8942. The IThreadFn class represents functions to be dispatched on secondary threads 
  8943. of execution when you start an IThread object. The User Interface Class Library 
  8944. reference counts objects of this class to manage their destruction after the 
  8945. thread has terminated. The User Interface Class Library passes such a reference 
  8946. to IThread::start, supplying the reference via the IReference template class. 
  8947.  
  8948. This class is an abstract thread function class. 
  8949.  
  8950.  
  8951. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IThreadFn ΓòÉΓòÉΓòÉ
  8952.  
  8953. Constructors
  8954. IThreadFn
  8955. ~IThreadFn
  8956.  
  8957. Run Function
  8958. run
  8959.  
  8960. Inherited Members
  8961. IRefCounted
  8962. addRef
  8963. removeRef
  8964. useCount
  8965.  
  8966. IVBase
  8967. asDebugInfo
  8968. asString
  8969.  
  8970. IBase
  8971. asDebugInfo
  8972. asString
  8973. messageFile
  8974. messageText
  8975. setMessageFile
  8976. version
  8977.  
  8978.  
  8979. ΓòÉΓòÉΓòÉ <hidden> IThreadFn - Constructors ΓòÉΓòÉΓòÉ
  8980.  
  8981. You cannot construct or destruct objects of this class because it is an 
  8982. abstract class.  Use the template class IThreadMemberFn for dispatching C++ 
  8983. member functions to an object on a new thread. 
  8984.  
  8985.  
  8986. ΓòÉΓòÉΓòÉ <hidden> IThreadFn - Hidden Members ΓòÉΓòÉΓòÉ
  8987.  
  8988. You cannot access these members. 
  8989.  
  8990.  
  8991. ΓòÉΓòÉΓòÉ <hidden> IThreadFn - Run Function ΓòÉΓòÉΓòÉ
  8992.  
  8993. Use run function members to implement the code that you need to run on 
  8994. secondary threads of execution. 
  8995.  
  8996.  
  8997. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IThreadFn ΓòÉΓòÉΓòÉ
  8998.  
  8999. Inherited Members
  9000. IBase
  9001. recoverable
  9002. unrecoverable
  9003.  
  9004.  
  9005. ΓòÉΓòÉΓòÉ 1.25.1. IThreadFn::IThreadFn ΓòÉΓòÉΓòÉ
  9006.  
  9007. The default and only constructor for this abstract class. 
  9008.  
  9009. public:
  9010. IThreadFn();
  9011.  
  9012. Platform Support 
  9013.  
  9014. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9015. ΓöéPM          ΓöéMOTIF       Γöé
  9016. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9017. ΓöéYes         ΓöéYes         Γöé
  9018. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9019.  
  9020.  
  9021. ΓòÉΓòÉΓòÉ 1.25.2. IThreadFn::run ΓòÉΓòÉΓòÉ
  9022.  
  9023. Called when the thread function object is called. Override this function to 
  9024. implement the code that you need to run on secondary threads of execution. 
  9025.  
  9026. public:
  9027. virtual void run() = 0;
  9028.  
  9029. Platform Support 
  9030.  
  9031. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9032. ΓöéPM          ΓöéMOTIF       Γöé
  9033. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9034. ΓöéYes         ΓöéYes         Γöé
  9035. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9036.  
  9037.  
  9038. ΓòÉΓòÉΓòÉ 1.25.3. IThreadFn::~IThreadFn ΓòÉΓòÉΓòÉ
  9039.  
  9040. public:
  9041. virtual  ~IThreadFn();
  9042.  
  9043. Platform Support 
  9044.  
  9045. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9046. ΓöéPM          ΓöéMOTIF       Γöé
  9047. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9048. ΓöéYes         ΓöéYes         Γöé
  9049. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9050.  
  9051.  
  9052. ΓòÉΓòÉΓòÉ 1.26. IThreadId ΓòÉΓòÉΓòÉ
  9053.  
  9054. Description 
  9055.  
  9056. Derivation 
  9057.  
  9058. Constructors 
  9059.  
  9060. Public Functions 
  9061.  
  9062. Protected Data 
  9063.  
  9064. To close all the panels in a chapter, double click on this panel's system menu. 
  9065.  
  9066.  
  9067. ΓòÉΓòÉΓòÉ <hidden> Derivation - IThreadId ΓòÉΓòÉΓòÉ
  9068.  
  9069. IBase
  9070.   Γöé
  9071. IHandle
  9072.   Γöé
  9073. IThreadId
  9074.  
  9075. Inherited by none. 
  9076.  
  9077.  
  9078. ΓòÉΓòÉΓòÉ <hidden> Class Description - IThreadId ΓòÉΓòÉΓòÉ
  9079.  
  9080. ihandle.hpp 
  9081.  
  9082. Objects of the IThreadId class access numeric identifiers for threads. 
  9083.  
  9084. Presentation Manager Information 
  9085.  
  9086. IThreadId is an alias for the OS/2 Programmer's Toolkit type TID. 
  9087.  
  9088. Motif Information 
  9089.  
  9090. In AIX, the User Interface Class Library does not support multiple threads. 
  9091. This class always returns a ThreadId of 1. 
  9092.  
  9093.  
  9094. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IThreadId ΓòÉΓòÉΓòÉ
  9095.  
  9096. Constructors
  9097. IThreadId
  9098.  
  9099. Inherited Members
  9100. IHandle
  9101. asDebugInfo
  9102. asString
  9103. asUnsigned
  9104. operator Value
  9105.  
  9106. IBase
  9107. asDebugInfo
  9108. asString
  9109. messageFile
  9110. messageText
  9111. setMessageFile
  9112. version
  9113.  
  9114.  
  9115. ΓòÉΓòÉΓòÉ <hidden> IThreadId - Constructors ΓòÉΓòÉΓòÉ
  9116.  
  9117. You can construct objects of this class. 
  9118.  
  9119.  
  9120. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IThreadId ΓòÉΓòÉΓòÉ
  9121.  
  9122. Inherited Members
  9123. IHandle
  9124. handle
  9125.  
  9126. IBase
  9127. recoverable
  9128. unrecoverable
  9129.  
  9130.  
  9131. ΓòÉΓòÉΓòÉ 1.26.1. IThreadId::IThreadId ΓòÉΓòÉΓòÉ
  9132.  
  9133. You can construct objects of this class from a thread ID (a value of type 
  9134. IHandle::Value), which defaults to 0. 
  9135.  
  9136. public:
  9137. IThreadId(Value tid = 0);
  9138.  
  9139. Platform Support 
  9140.  
  9141. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9142. ΓöéPM          ΓöéMOTIF       Γöé
  9143. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9144. ΓöéYes         ΓöéYes         Γöé
  9145. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9146.  
  9147. Used in sample:   Multi-Line Entry Field Sample: amle.cpp 
  9148.  
  9149.  
  9150. ΓòÉΓòÉΓòÉ 1.27. IThreadMemberFn ΓòÉΓòÉΓòÉ
  9151.  
  9152. Description 
  9153.  
  9154. Derivation 
  9155.  
  9156. Constructors 
  9157.  
  9158. Public Functions 
  9159.  
  9160. Protected Data 
  9161.  
  9162. To close all the panels in a chapter, double click on this panel's system menu. 
  9163.  
  9164.  
  9165. ΓòÉΓòÉΓòÉ <hidden> Derivation - IThreadMemberFn ΓòÉΓòÉΓòÉ
  9166.  
  9167. IBase
  9168.   Γöé
  9169. IVBase
  9170.   Γöé
  9171. IRefCounted
  9172.   Γöé
  9173. IThreadFn
  9174.   Γöé
  9175. IThreadMemberFn
  9176.  
  9177. Inherited by none. 
  9178.  
  9179.  
  9180. ΓòÉΓòÉΓòÉ <hidden> Class Description - IThreadMemberFn ΓòÉΓòÉΓòÉ
  9181.  
  9182. ithread.hpp 
  9183.  
  9184. The IThreadMemberFn template class is derived from IThreadFn for dispatching 
  9185. C++ member functions to an object on a new thread. The template argument is the 
  9186. class of the object where the dispatched member functions are called. 
  9187.  
  9188. The constructor for such objects requires the following: 
  9189.  
  9190.      A reference to the object where the dispatched member functions are 
  9191.       called 
  9192.  
  9193.      A pointer to the member functions to call 
  9194.  
  9195.  The member functions return void and accept no parameters. You can add support 
  9196.  for other member functions by deriving a class from this class. 
  9197.  
  9198.  Customization (Template Argument) 
  9199.  
  9200.  IThreadMemberFn is a template class that is created with the following 
  9201.  template argument: 
  9202.  
  9203.  T    The class of the object where the dispatched member functions are called. 
  9204.  
  9205.  
  9206. ΓòÉΓòÉΓòÉ <hidden> Public Functions - IThreadMemberFn ΓòÉΓòÉΓòÉ
  9207.  
  9208. Constructors
  9209. IThreadMemberFn
  9210. ~IThreadMemberFn
  9211.  
  9212. Run Function
  9213. run
  9214.  
  9215. Inherited Members
  9216. IThreadFn
  9217. run
  9218.  
  9219. IRefCounted
  9220. addRef
  9221. removeRef
  9222. useCount
  9223.  
  9224. IVBase
  9225. asDebugInfo
  9226. asString
  9227.  
  9228. IBase
  9229. asDebugInfo
  9230. asString
  9231. messageFile
  9232. messageText
  9233. setMessageFile
  9234. version
  9235.  
  9236.  
  9237. ΓòÉΓòÉΓòÉ <hidden> IThreadMemberFn - Constructors ΓòÉΓòÉΓòÉ
  9238.  
  9239. Use these members to construct and destruct objects of this template class. 
  9240.  
  9241.  
  9242. ΓòÉΓòÉΓòÉ <hidden> IThreadMemberFn - Hidden Members ΓòÉΓòÉΓòÉ
  9243.  
  9244. You cannot use these members. 
  9245.  
  9246.  
  9247. ΓòÉΓòÉΓòÉ <hidden> IThreadMemberFn - Run Function ΓòÉΓòÉΓòÉ
  9248.  
  9249. Use these members to run the member function that was specified when an object 
  9250. of this class was created. 
  9251.  
  9252.  
  9253. ΓòÉΓòÉΓòÉ <hidden> Protected Data - IThreadMemberFn ΓòÉΓòÉΓòÉ
  9254.  
  9255. Inherited Members
  9256. IBase
  9257. recoverable
  9258. unrecoverable
  9259.  
  9260.  
  9261. ΓòÉΓòÉΓòÉ 1.27.1. IThreadMemberFn::IThreadMemberFn ΓòÉΓòÉΓòÉ
  9262.  
  9263. You can only construct objects of this class by specifying an argument of the 
  9264. template argument class and a pointer to a member function of the template 
  9265. argument class. 
  9266.  
  9267. public:
  9268. IThreadMemberFn(T& obj, void ( T::* mem ) ( ));
  9269.  
  9270.  obj       Object of the template argument class T. 
  9271.  
  9272.  mem       Pointer to a member function of the template argument class. The 
  9273.            member function should return a void parameter and accept no formal 
  9274.            parameters. 
  9275.  
  9276.  Platform Support 
  9277.  
  9278.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9279.   ΓöéPM          ΓöéMOTIF       Γöé
  9280.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9281.   ΓöéYes         ΓöéYes         Γöé
  9282.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9283.  
  9284.  
  9285. ΓòÉΓòÉΓòÉ 1.27.2. IThreadMemberFn::run ΓòÉΓòÉΓòÉ
  9286.  
  9287. Calls the member function that you specify when you create an object of this 
  9288. class. 
  9289.  
  9290. public:
  9291. virtual void run();
  9292.  
  9293. Platform Support 
  9294.  
  9295. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9296. ΓöéPM          ΓöéMOTIF       Γöé
  9297. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9298. ΓöéYes         ΓöéYes         Γöé
  9299. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9300.  
  9301.  
  9302. ΓòÉΓòÉΓòÉ 1.27.3. IThreadMemberFn::~IThreadMemberFn ΓòÉΓòÉΓòÉ
  9303.  
  9304. public:
  9305. virtual  ~IThreadMemberFn();
  9306.  
  9307. Platform Support 
  9308.  
  9309. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9310. ΓöéPM          ΓöéMOTIF       Γöé
  9311. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9312. ΓöéYes         ΓöéYes         Γöé
  9313. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9314.  
  9315.  
  9316. ΓòÉΓòÉΓòÉ 1.28. ITimer ΓòÉΓòÉΓòÉ
  9317.  
  9318. Description 
  9319.  
  9320. Derivation 
  9321.  
  9322. Constructors 
  9323.  
  9324. Public Functions 
  9325.  
  9326. Protected Data 
  9327.  
  9328. Nested Types 
  9329.  
  9330. To close all the panels in a chapter, double click on this panel's system menu. 
  9331.  
  9332.  
  9333. ΓòÉΓòÉΓòÉ <hidden> Derivation - ITimer ΓòÉΓòÉΓòÉ
  9334.  
  9335. IBase
  9336.   Γöé
  9337. IVBase
  9338.   Γöé
  9339. ITimer
  9340.  
  9341. Inherited by none. 
  9342.  
  9343.  
  9344. ΓòÉΓòÉΓòÉ <hidden> Class Description - ITimer ΓòÉΓòÉΓòÉ
  9345.  
  9346. itimer.hpp 
  9347.  
  9348. The ITimer class creates and references periodic time-interval-based 
  9349. operations. 
  9350.  
  9351. ITimer objects use timer identifier values above 1000.  Limit your use of timer 
  9352. identifiers to values below 1000 when directly creating or managing timers 
  9353. using operating system calls. 
  9354.  
  9355. The ITimer class uses the operating system message queue for timer expiration. 
  9356. This can cause timer actions to be delayed if the application is currently 
  9357. tying up the queue.  If a timer event is delayed, the next timer event still 
  9358. occurs at the expected interval (there should be no timer drift). 
  9359.  
  9360.  
  9361. ΓòÉΓòÉΓòÉ <hidden> Public Functions - ITimer ΓòÉΓòÉΓòÉ
  9362.  
  9363. Comparison
  9364. operator ==
  9365.  
  9366. Constructors
  9367. ITimer
  9368. operator =
  9369. ~ITimer
  9370.  
  9371. Diagnostics
  9372. asDebugInfo
  9373. asString
  9374.  
  9375. Expiration Interval
  9376. interval
  9377. setInterval
  9378.  
  9379. Retrieving Objects
  9380. timerAt
  9381.  
  9382. Starting and Stopping
  9383. isStarted
  9384. start
  9385. stop
  9386.  
  9387. Timer Information
  9388. id
  9389.  
  9390. Inherited Members
  9391. IVBase
  9392. asDebugInfo
  9393. asString
  9394.  
  9395. IBase
  9396. asDebugInfo
  9397. asString
  9398. messageFile
  9399. messageText
  9400. setMessageFile
  9401. version
  9402.  
  9403.  
  9404. ΓòÉΓòÉΓòÉ <hidden> ITimer - Comparison ΓòÉΓòÉΓòÉ
  9405.  
  9406. Use these members to compare ITimer objects. 
  9407.  
  9408.  
  9409. ΓòÉΓòÉΓòÉ <hidden> ITimer - Constructors ΓòÉΓòÉΓòÉ
  9410.  
  9411. You can construct, copy, assign, and destruct objects of this class. 
  9412.  
  9413. Note:  The ITimer class does not support user-specified timer identifier values 
  9414.        or timers that were not created with the ITimer class. 
  9415.  
  9416.  
  9417. ΓòÉΓòÉΓòÉ <hidden> ITimer - Diagnostics ΓòÉΓòÉΓòÉ
  9418.  
  9419. Use these members for diagnostic purposes.  They return IString representation 
  9420. of the timer diagnostics. 
  9421.  
  9422.  
  9423. ΓòÉΓòÉΓòÉ <hidden> ITimer - Expiration Interval ΓòÉΓòÉΓòÉ
  9424.  
  9425. Use these members to access the timer expiration interval. 
  9426.  
  9427.  
  9428. ΓòÉΓòÉΓòÉ <hidden> ITimer - Retrieving Objects ΓòÉΓòÉΓòÉ
  9429.  
  9430. Use these members to retrieve a timer object using ITimer::Cursor. 
  9431.  
  9432.  
  9433. ΓòÉΓòÉΓòÉ <hidden> ITimer - Starting and Stopping ΓòÉΓòÉΓòÉ
  9434.  
  9435. Use these members to start and stop timers. 
  9436.  
  9437.  
  9438. ΓòÉΓòÉΓòÉ <hidden> ITimer - Timer Information ΓòÉΓòÉΓòÉ
  9439.  
  9440. Use these members to access timer information such as the timer identifier. 
  9441.  
  9442.  
  9443. ΓòÉΓòÉΓòÉ <hidden> Protected Data - ITimer ΓòÉΓòÉΓòÉ
  9444.  
  9445. Inherited Members
  9446. IBase
  9447. recoverable
  9448. unrecoverable
  9449.  
  9450.  
  9451. ΓòÉΓòÉΓòÉ 1.28.1. ITimer::asDebugInfo ΓòÉΓòÉΓòÉ
  9452.  
  9453. Returns a representation of the timer as diagnostic information. 
  9454.  
  9455. public:
  9456. virtual IString asDebugInfo() const;
  9457.  
  9458. Platform Support 
  9459.  
  9460. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9461. ΓöéPM          ΓöéMOTIF       Γöé
  9462. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9463. ΓöéYes         ΓöéNo          Γöé
  9464. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9465.  
  9466.  
  9467. ΓòÉΓòÉΓòÉ 1.28.2. ITimer::asString ΓòÉΓòÉΓòÉ
  9468.  
  9469. Returns a string of the form ITimer(ID) where ID is replaced by the actual 
  9470. identifier of the timer. 
  9471.  
  9472. public:
  9473. virtual IString asString() const;
  9474.  
  9475. Platform Support 
  9476.  
  9477. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9478. ΓöéPM          ΓöéMOTIF       Γöé
  9479. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9480. ΓöéYes         ΓöéNo          Γöé
  9481. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9482.  
  9483.  
  9484. ΓòÉΓòÉΓòÉ 1.28.3. ITimer::id ΓòÉΓòÉΓòÉ
  9485.  
  9486. Returns the identifier value of the timer. 
  9487.  
  9488. public:
  9489. unsigned long id() const;
  9490.  
  9491. Platform Support 
  9492.  
  9493. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9494. ΓöéPM          ΓöéMOTIF       Γöé
  9495. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9496. ΓöéYes         ΓöéNo          Γöé
  9497. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9498.  
  9499.  
  9500. ΓòÉΓòÉΓòÉ 1.28.4. ITimer::interval ΓòÉΓòÉΓòÉ
  9501.  
  9502. Returns the timer interval (in thousandths of a second). 
  9503.  
  9504. public:
  9505. unsigned long interval() const;
  9506.  
  9507. Platform Support 
  9508.  
  9509. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9510. ΓöéPM          ΓöéMOTIF       Γöé
  9511. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9512. ΓöéYes         ΓöéNo          Γöé
  9513. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9514.  
  9515.  
  9516. ΓòÉΓòÉΓòÉ 1.28.5. ITimer::isStarted ΓòÉΓòÉΓòÉ
  9517.  
  9518. Returns true if the timer is currently active. 
  9519.  
  9520. public:
  9521. Boolean isStarted() const;
  9522.  
  9523. Platform Support 
  9524.  
  9525. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9526. ΓöéPM          ΓöéMOTIF       Γöé
  9527. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9528. ΓöéYes         ΓöéNo          Γöé
  9529. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9530.  
  9531.  
  9532. ΓòÉΓòÉΓòÉ 1.28.6. ITimer::ITimer ΓòÉΓòÉΓòÉ
  9533.  
  9534. You can construct, copy, assign, and destruct objects of this class. 
  9535.  
  9536. Note:  The ITimer class does not support user-specified timer identifier values 
  9537.        or timers that were not created with the ITimer class. 
  9538.  
  9539.  Overload 1 
  9540.  
  9541.   public:
  9542.   ITimer(const ITimer& timer);
  9543.  
  9544.  Creates an ITimer object from an existing ITimer object. 
  9545.  
  9546.  Platform Support 
  9547.  
  9548.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9549.   ΓöéPM          ΓöéMOTIF       Γöé
  9550.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9551.   ΓöéYes         ΓöéNo          Γöé
  9552.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9553.  
  9554.  Overload 2 
  9555.  
  9556.   public:
  9557.   ITimer();
  9558.  
  9559.  Creates an ITimer object using the default constructor. 
  9560.  
  9561.  Platform Support 
  9562.  
  9563.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9564.   ΓöéPM          ΓöéMOTIF       Γöé
  9565.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9566.   ΓöéYes         ΓöéNo          Γöé
  9567.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9568.  
  9569.  Exceptions 
  9570.  
  9571.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9572.   ΓöéIOutOfSystemResourceΓöéThe system is out of available timer    Γöé
  9573.   Γöé                    Γöéidentifiers.                            Γöé
  9574.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9575.  
  9576.  Overload 3 
  9577.  
  9578.   public:
  9579.   ITimer( const IReference< ITimerFn>& timerFunction,
  9580.           unsigned long timerInterval = 1000);
  9581.  
  9582.  Creates an ITimer object with a specification of code to be run. Use this form 
  9583.  of the constructor to construct a new ITimer and immediately start it.  It is 
  9584.  equivalent to using the default constructor and then calling the start method. 
  9585.  
  9586.  This constructor permits specification of a time-interval to be used (in 
  9587.  thousandths of a second). A time-interval of one second is the default. 
  9588.  
  9589.  This constructor is equivalent to using the default constructor and 
  9590.  immediately calling the start member function. 
  9591.  
  9592.  Platform Support 
  9593.  
  9594.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9595.   ΓöéPM          ΓöéMOTIF       Γöé
  9596.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9597.   ΓöéYes         ΓöéNo          Γöé
  9598.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9599.  
  9600.  Overload 4 
  9601.  
  9602.   public:
  9603.   ITimer(unsigned long timerIdentifier);
  9604.  
  9605.  Creates an ITimer object from the timer ID of an existing ITimer object. 
  9606.  
  9607.  Platform Support 
  9608.  
  9609.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9610.   ΓöéPM          ΓöéMOTIF       Γöé
  9611.   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9612.   ΓöéYes         ΓöéNo          Γöé
  9613.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9614.  
  9615.  Exceptions 
  9616.  
  9617.   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9618.   ΓöéIInvalidParameter   ΓöéThe timer identifier value is not valid.Γöé
  9619.   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9620.  
  9621.  
  9622. ΓòÉΓòÉΓòÉ 1.28.7. ITimer::operator = ΓòÉΓòÉΓòÉ
  9623.  
  9624. Assigns an ITimer object to reference an existing timer. 
  9625.  
  9626. public:
  9627. ITimer& operator =(const ITimer& timer);
  9628.  
  9629. Platform Support 
  9630.  
  9631. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9632. ΓöéPM          ΓöéMOTIF       Γöé
  9633. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9634. ΓöéYes         ΓöéNo          Γöé
  9635. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9636.  
  9637.  
  9638. ΓòÉΓòÉΓòÉ 1.28.8. ITimer::operator == ΓòÉΓòÉΓòÉ
  9639.  
  9640. Returns true if and only if the timers are identical. 
  9641.  
  9642. public:
  9643. Boolean operator ==(const ITimer timer);
  9644.  
  9645. Platform Support 
  9646.  
  9647. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9648. ΓöéPM          ΓöéMOTIF       Γöé
  9649. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9650. ΓöéYes         ΓöéNo          Γöé
  9651. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9652.  
  9653.  
  9654. ΓòÉΓòÉΓòÉ 1.28.9. ITimer::setInterval ΓòÉΓòÉΓòÉ
  9655.  
  9656. Sets the timer interval (in thousandths of a second).  If no interval is set 
  9657. for a timer, then an interval of one second is used by default. 
  9658.  
  9659. If this member function is called for a started timer, then the timer is 
  9660. stopped and restarted with the new interval.  The ITimerFn being used is saved 
  9661. and used when the timer is restarted. 
  9662.  
  9663. An interval of 0 causes the timer to expire as quickly as possible. 
  9664.  
  9665. public:
  9666. virtual ITimer& setInterval(unsigned long aInterval = 1000);
  9667.  
  9668. Platform Support 
  9669.  
  9670. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9671. ΓöéPM          ΓöéMOTIF       Γöé
  9672. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9673. ΓöéYes         ΓöéNo          Γöé
  9674. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9675.  
  9676. Presentation Manager: When running on the OS/2 operating system, an effective 
  9677. minimum of about 1/18 of a second exists for timer intervals. 
  9678.  
  9679.  
  9680. ΓòÉΓòÉΓòÉ 1.28.10. ITimer::start ΓòÉΓòÉΓòÉ
  9681.  
  9682. Starts a time-interval-based operation with an arbitrary ITimerFn.  The 
  9683. ITimerFn is passed in using an IReference so that the ITimerFn can be reference 
  9684. counted and subsequently deleted when the timer is stopped. 
  9685.  
  9686. The ITimerFn is called each time the timer interval expires. 
  9687.  
  9688. Overload 1 
  9689.  
  9690. public:
  9691. virtual ITimer&
  9692.   start( const IReference< ITimerFn>& timerFunction);
  9693.  
  9694. Platform Support 
  9695.  
  9696. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9697. ΓöéPM          ΓöéMOTIF       Γöé
  9698. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9699. ΓöéYes         ΓöéNo          Γöé
  9700. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9701.  
  9702. Exceptions 
  9703.  
  9704. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9705. ΓöéIInvalidRequest     ΓöéThe timer has already been started.     Γöé
  9706. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9707. ΓöéIAccessError        ΓöéThe operating system is unable to start Γöé
  9708. Γöé                    Γöéthe timer.                              Γöé
  9709. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9710.  
  9711. Overload 2 
  9712.  
  9713. public:
  9714. virtual ITimer&
  9715.   start( const IReference< ITimerFn>& timerFunction,
  9716.          unsigned long timerInterval);
  9717.  
  9718. Platform Support 
  9719.  
  9720. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9721. ΓöéPM          ΓöéMOTIF       Γöé
  9722. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9723. ΓöéYes         ΓöéNo          Γöé
  9724. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9725.  
  9726.  
  9727. ΓòÉΓòÉΓòÉ 1.28.11. ITimer::stop ΓòÉΓòÉΓòÉ
  9728.  
  9729. Stops the timer.  You must stop the timer to deallocate resources used by the 
  9730. timer. 
  9731.  
  9732. public:
  9733. virtual ITimer& stop();
  9734.  
  9735. Platform Support 
  9736.  
  9737. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9738. ΓöéPM          ΓöéMOTIF       Γöé
  9739. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9740. ΓöéYes         ΓöéNo          Γöé
  9741. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9742.  
  9743. Exceptions 
  9744.  
  9745. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9746. ΓöéIAccessError        ΓöéThe operating system is unable to stop  Γöé
  9747. Γöé                    Γöéthe timer.                              Γöé
  9748. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9749.  
  9750. Used in sample:   Magnify Sample: magnify.cpp 
  9751.  
  9752.  
  9753. ΓòÉΓòÉΓòÉ 1.28.12. ITimer::timerAt ΓòÉΓòÉΓòÉ
  9754.  
  9755. Returns an ITimer object at a cursor position. 
  9756.  
  9757. public:
  9758. static ITimer timerAt(const Cursor& cursor);
  9759.  
  9760. Platform Support 
  9761.  
  9762. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9763. ΓöéPM          ΓöéMOTIF       Γöé
  9764. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9765. ΓöéYes         ΓöéNo          Γöé
  9766. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9767.  
  9768. Exceptions 
  9769.  
  9770. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9771. ΓöéIInvalidParameter   ΓöéThe ITimer::Cursor is invalid.          Γöé
  9772. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9773.  
  9774.  
  9775. ΓòÉΓòÉΓòÉ 1.28.13. ITimer::~ITimer ΓòÉΓòÉΓòÉ
  9776.  
  9777. The destructor does not stop the timer or deallocate resources. If you want to 
  9778. stop the timer and deallocate resources, call the stop method to halt the 
  9779. started timer. 
  9780.  
  9781. public:
  9782. virtual  ~ITimer();
  9783.  
  9784. Platform Support 
  9785.  
  9786. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9787. ΓöéPM          ΓöéMOTIF       Γöé
  9788. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9789. ΓöéYes         ΓöéNo          Γöé
  9790. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9791.  
  9792.  
  9793. ΓòÉΓòÉΓòÉ <hidden> Nested Types - ITimer ΓòÉΓòÉΓòÉ
  9794.  
  9795. Classes 
  9796.  
  9797.        ITimer::Cursor 
  9798.  
  9799.  
  9800. ΓòÉΓòÉΓòÉ 1.29. ITimer::Cursor ΓòÉΓòÉΓòÉ
  9801.  
  9802. Description 
  9803.  
  9804. Derivation 
  9805.  
  9806. Constructors 
  9807.  
  9808. Public Functions 
  9809.  
  9810. Protected Data 
  9811.  
  9812. To close all the panels in a chapter, double click on this panel's system menu. 
  9813.  
  9814.  
  9815. ΓòÉΓòÉΓòÉ <hidden> Derivation - ITimer::Cursor ΓòÉΓòÉΓòÉ
  9816.  
  9817. IBase
  9818.   Γöé
  9819. IVBase
  9820.   Γöé
  9821. ITimer::Cursor
  9822.  
  9823. Inherited by none. 
  9824.  
  9825.  
  9826. ΓòÉΓòÉΓòÉ <hidden> Class Description - ITimer::Cursor ΓòÉΓòÉΓòÉ
  9827.  
  9828. itimer.hpp 
  9829.  
  9830. The ITimer::Cursor nested class iterates over the active timers for the current 
  9831. application.  Only timers that are started with the ITimer class are iterated 
  9832. over.  Timers for all threads will be iterated. 
  9833.  
  9834.  
  9835. ΓòÉΓòÉΓòÉ <hidden> Public Functions - ITimer::Cursor ΓòÉΓòÉΓòÉ
  9836.  
  9837. Constructors
  9838. Cursor
  9839. ~Cursor
  9840.  
  9841. Timer Iteration
  9842. invalidate
  9843. isValid
  9844. setToFirst
  9845. setToNext
  9846.  
  9847. Inherited Members
  9848. IVBase
  9849. asDebugInfo
  9850. asString
  9851.  
  9852. IBase
  9853. asDebugInfo
  9854. asString
  9855. messageFile
  9856. messageText
  9857. setMessageFile
  9858. version
  9859.  
  9860.  
  9861. ΓòÉΓòÉΓòÉ <hidden> ITimer::Cursor - Constructors ΓòÉΓòÉΓòÉ
  9862.  
  9863. Use these members to construct and destruct objects of this class. 
  9864.  
  9865.  
  9866. ΓòÉΓòÉΓòÉ <hidden> ITimer::Cursor - Timer Iteration ΓòÉΓòÉΓòÉ
  9867.  
  9868. Use these members to iterate through the set of active timers. 
  9869.  
  9870.  
  9871. ΓòÉΓòÉΓòÉ <hidden> Protected Data - ITimer::Cursor ΓòÉΓòÉΓòÉ
  9872.  
  9873. Inherited Members
  9874. IBase
  9875. recoverable
  9876. unrecoverable
  9877.  
  9878.  
  9879. ΓòÉΓòÉΓòÉ 1.29.1. ITimer::Cursor::Cursor ΓòÉΓòÉΓòÉ
  9880.  
  9881. The default constructor accepts no arguments. 
  9882.  
  9883. public:
  9884. Cursor();
  9885.  
  9886. Platform Support 
  9887.  
  9888. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9889. ΓöéPM          ΓöéMOTIF       Γöé
  9890. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9891. ΓöéYes         ΓöéNo          Γöé
  9892. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9893.  
  9894.  
  9895. ΓòÉΓòÉΓòÉ 1.29.2. ITimer::Cursor::invalidate ΓòÉΓòÉΓòÉ
  9896.  
  9897. Invalidates the cursor. 
  9898.  
  9899. public:
  9900. virtual void invalidate();
  9901.  
  9902. Platform Support 
  9903.  
  9904. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9905. ΓöéPM          ΓöéMOTIF       Γöé
  9906. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9907. ΓöéYes         ΓöéNo          Γöé
  9908. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9909.  
  9910.  
  9911. ΓòÉΓòÉΓòÉ 1.29.3. ITimer::Cursor::isValid ΓòÉΓòÉΓòÉ
  9912.  
  9913. Returns true if the cursor is valid. 
  9914.  
  9915. public:
  9916. virtual Boolean isValid() const;
  9917.  
  9918. Platform Support 
  9919.  
  9920. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9921. ΓöéPM          ΓöéMOTIF       Γöé
  9922. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9923. ΓöéYes         ΓöéNo          Γöé
  9924. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9925.  
  9926.  
  9927. ΓòÉΓòÉΓòÉ 1.29.4. ITimer::Cursor::setToFirst ΓòÉΓòÉΓòÉ
  9928.  
  9929. Initializes the cursor to the first timer.  If no timers are active, then it 
  9930. returns false and invalidates the cursor. 
  9931.  
  9932. public:
  9933. virtual Boolean setToFirst();
  9934.  
  9935. Platform Support 
  9936.  
  9937. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9938. ΓöéPM          ΓöéMOTIF       Γöé
  9939. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9940. ΓöéYes         ΓöéNo          Γöé
  9941. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9942.  
  9943.  
  9944. ΓòÉΓòÉΓòÉ 1.29.5. ITimer::Cursor::setToNext ΓòÉΓòÉΓòÉ
  9945.  
  9946. Advances the cursor to the next timer.  If no other timers are active, then it 
  9947. returns false and invalidates the cursor. 
  9948.  
  9949. If you call setToNext with an invalid cursor, it sets the cursor to the first 
  9950. active timer. 
  9951.  
  9952. public:
  9953. virtual Boolean setToNext();
  9954.  
  9955. Platform Support 
  9956.  
  9957. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9958. ΓöéPM          ΓöéMOTIF       Γöé
  9959. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9960. ΓöéYes         ΓöéNo          Γöé
  9961. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9962.  
  9963.  
  9964. ΓòÉΓòÉΓòÉ 1.29.6. ITimer::Cursor::~Cursor ΓòÉΓòÉΓòÉ
  9965.  
  9966. public:
  9967. virtual  ~Cursor();
  9968.  
  9969. Platform Support 
  9970.  
  9971. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  9972. ΓöéPM          ΓöéMOTIF       Γöé
  9973. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  9974. ΓöéYes         ΓöéNo          Γöé
  9975. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  9976.  
  9977.  
  9978. ΓòÉΓòÉΓòÉ 1.30. ITimerFn ΓòÉΓòÉΓòÉ
  9979.  
  9980. Description 
  9981.  
  9982. Derivation 
  9983.  
  9984. Constructors 
  9985.  
  9986. Public Functions 
  9987.  
  9988. Protected Data 
  9989.  
  9990. To close all the panels in a chapter, double click on this panel's system menu. 
  9991.  
  9992.  
  9993. ΓòÉΓòÉΓòÉ <hidden> Derivation - ITimerFn ΓòÉΓòÉΓòÉ
  9994.  
  9995. IBase
  9996.   Γöé
  9997. IVBase
  9998.   Γöé
  9999. IRefCounted
  10000.   Γöé
  10001. ITimerFn
  10002.  
  10003. Inherited by: 
  10004.  
  10005.       ITimerMemberFn 
  10006.       ITimerMemberFn0 
  10007.  
  10008.  
  10009. ΓòÉΓòÉΓòÉ <hidden> Class Description - ITimerFn ΓòÉΓòÉΓòÉ
  10010.  
  10011. itimer.hpp 
  10012.  
  10013. The ITimerFn class is an abstract timer function class.  To use an ITimer, 
  10014. create a class derived from ITimerFn that implements the timerExpired function. 
  10015. The ITimerMemberFn and ITimerMemberFn0 are template classes that are derived 
  10016. from ITimerFn. 
  10017.  
  10018. Objects of this class represent functions to be called when an active timer 
  10019. expires.  These objects are reference counted to manage their destruction 
  10020. (after the timer has been stopped).  A reference to such an ITimerFn is passed 
  10021. to ITimer::start. 
  10022.  
  10023.  
  10024. ΓòÉΓòÉΓòÉ <hidden> Public Functions - ITimerFn ΓòÉΓòÉΓòÉ
  10025.  
  10026. Constructors
  10027. ITimerFn
  10028. ~ITimerFn
  10029.  
  10030. Timer Expiration
  10031. timerExpired
  10032.  
  10033. Inherited Members
  10034. IRefCounted
  10035. addRef
  10036. removeRef
  10037. useCount
  10038.  
  10039. IVBase
  10040. asDebugInfo
  10041. asString
  10042.  
  10043. IBase
  10044. asDebugInfo
  10045. asString
  10046. messageFile
  10047. messageText
  10048. setMessageFile
  10049. version
  10050.  
  10051.  
  10052. ΓòÉΓòÉΓòÉ <hidden> ITimerFn - Constructors ΓòÉΓòÉΓòÉ
  10053.  
  10054. You can construct and destruct objects of this class. You cannot copy or assign 
  10055. ITimerFn objects because both the copy constructor and the assignment operator 
  10056. are private members. 
  10057.  
  10058.  
  10059. ΓòÉΓòÉΓòÉ <hidden> ITimerFn - Hidden Members ΓòÉΓòÉΓòÉ
  10060.  
  10061. You cannot access these members. 
  10062.  
  10063.  
  10064. ΓòÉΓòÉΓòÉ <hidden> ITimerFn - Timer Expiration ΓòÉΓòÉΓòÉ
  10065.  
  10066. Use these members to perform actions each time the timer expires. 
  10067.  
  10068.  
  10069. ΓòÉΓòÉΓòÉ <hidden> Protected Data - ITimerFn ΓòÉΓòÉΓòÉ
  10070.  
  10071. Inherited Members
  10072. IBase
  10073. recoverable
  10074. unrecoverable
  10075.  
  10076.  
  10077. ΓòÉΓòÉΓòÉ 1.30.1. ITimerFn::ITimerFn ΓòÉΓòÉΓòÉ
  10078.  
  10079. You can construct and destruct objects of this class. You cannot copy or assign 
  10080. ITimerFn objects because both the copy constructor and the assignment operator 
  10081. are private members. 
  10082.  
  10083. public:
  10084. ITimerFn();
  10085.  
  10086. Creates an ITimerFn object. 
  10087.  
  10088. Platform Support 
  10089.  
  10090. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  10091. ΓöéPM          ΓöéMOTIF       Γöé
  10092. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  10093. ΓöéYes         ΓöéNo          Γöé
  10094. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  10095.  
  10096.  
  10097. ΓòÉΓòÉΓòÉ 1.30.2. ITimerFn::timerExpired ΓòÉΓòÉΓòÉ
  10098.  
  10099. Called each time the timer expires. 
  10100.  
  10101. public:
  10102. virtual void timerExpired(unsigned long timerId) = 0;
  10103.  
  10104. Platform Support 
  10105.  
  10106. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  10107. ΓöéPM          ΓöéMOTIF       Γöé
  10108. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  10109. ΓöéYes         ΓöéNo          Γöé
  10110. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  10111.  
  10112.  
  10113. ΓòÉΓòÉΓòÉ 1.30.3. ITimerFn::~ITimerFn ΓòÉΓòÉΓòÉ
  10114.  
  10115. public:
  10116. virtual  ~ITimerFn();
  10117.  
  10118. Platform Support 
  10119.  
  10120. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  10121. ΓöéPM          ΓöéMOTIF       Γöé
  10122. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  10123. ΓöéYes         ΓöéNo          Γöé
  10124. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  10125.  
  10126.  
  10127. ΓòÉΓòÉΓòÉ 1.31. ITimerMemberFn ΓòÉΓòÉΓòÉ
  10128.  
  10129. Description 
  10130.  
  10131. Derivation 
  10132.  
  10133. Constructors 
  10134.  
  10135. Public Functions 
  10136.  
  10137. Protected Data 
  10138.  
  10139. To close all the panels in a chapter, double click on this panel's system menu. 
  10140.  
  10141.  
  10142. ΓòÉΓòÉΓòÉ <hidden> Derivation - ITimerMemberFn ΓòÉΓòÉΓòÉ
  10143.  
  10144. IBase
  10145.   Γöé
  10146. IVBase
  10147.   Γöé
  10148. IRefCounted
  10149.   Γöé
  10150. ITimerFn
  10151.   Γöé
  10152. ITimerMemberFn
  10153.  
  10154. Inherited by none. 
  10155.  
  10156.  
  10157. ΓòÉΓòÉΓòÉ <hidden> Class Description - ITimerMemberFn ΓòÉΓòÉΓòÉ
  10158.  
  10159. itimer.hpp 
  10160.  
  10161. The ITimerMemberFn template class is an ITimerFn-derived class for dispatching 
  10162. C++ member functions to an object when a timer expires. The template argument 
  10163. is as follows: 
  10164.  
  10165.  T 
  10166.       The class of object against which the member functions are applied. 
  10167.  
  10168.  Objects of this class dispatch C++ member functions when a timer expires.  The 
  10169.  template argument is the class of the object for which the functions are 
  10170.  called.  The constructor for such objects requires a reference to the object 
  10171.  that the member functions are to be applied to and a pointer to the member 
  10172.  functions. 
  10173.  
  10174.  The member functions return void and accept a timer ID argument. 
  10175.  
  10176.  
  10177. ΓòÉΓòÉΓòÉ <hidden> Public Functions - ITimerMemberFn ΓòÉΓòÉΓòÉ
  10178.  
  10179. Constructors
  10180. ITimerMemberFn
  10181.  
  10182. Timer Expiration
  10183. timerExpired
  10184.  
  10185. Inherited Members
  10186. ITimerFn
  10187. timerExpired
  10188.  
  10189. IRefCounted
  10190. addRef
  10191. removeRef
  10192. useCount
  10193.  
  10194. IVBase
  10195. asDebugInfo
  10196. asString
  10197.  
  10198. IBase
  10199. asDebugInfo
  10200. asString
  10201. messageFile
  10202. messageText
  10203. setMessageFile
  10204. version
  10205.  
  10206.  
  10207. ΓòÉΓòÉΓòÉ <hidden> ITimerMemberFn - Constructors ΓòÉΓòÉΓòÉ
  10208.  
  10209. You can construct objects of this class. You cannot copy or assign 
  10210. ITimerMemberFn objects because both the copy constructor and the assignment 
  10211. operator are private members. 
  10212.  
  10213.  
  10214. ΓòÉΓòÉΓòÉ <hidden> ITimerMemberFn - Hidden Members ΓòÉΓòÉΓòÉ
  10215.  
  10216. You cannot access these members. 
  10217.  
  10218.  
  10219. ΓòÉΓòÉΓòÉ <hidden> ITimerMemberFn - Timer Expiration ΓòÉΓòÉΓòÉ
  10220.  
  10221. Use these members to perform actions each time the timer expires. 
  10222.  
  10223.  
  10224. ΓòÉΓòÉΓòÉ <hidden> Protected Data - ITimerMemberFn ΓòÉΓòÉΓòÉ
  10225.  
  10226. Inherited Members
  10227. IBase
  10228. recoverable
  10229. unrecoverable
  10230.  
  10231.  
  10232. ΓòÉΓòÉΓòÉ 1.31.1. ITimerMemberFn::ITimerMemberFn ΓòÉΓòÉΓòÉ
  10233.  
  10234. You can construct objects of this class. You cannot copy or assign 
  10235. ITimerMemberFn objects because both the copy constructor and the assignment 
  10236. operator are private members. 
  10237.  
  10238. public:
  10239. ITimerMemberFn( T& object,
  10240.                 void ( T::* memberFunction ) ( unsigned long ));
  10241.  
  10242. The constructor requires an object of the template argument class T and a 
  10243. pointer to a member function of that class (returning void and accepting a 
  10244. timer reference argument). 
  10245.  
  10246. Platform Support 
  10247.  
  10248. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  10249. ΓöéPM          ΓöéMOTIF       Γöé
  10250. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  10251. ΓöéYes         ΓöéNo          Γöé
  10252. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  10253.  
  10254.  
  10255. ΓòÉΓòÉΓòÉ 1.31.2. ITimerMemberFn::timerExpired ΓòÉΓòÉΓòÉ
  10256.  
  10257. Calls the pointed-to member function that was provided at construction each 
  10258. time the timer expires. 
  10259.  
  10260. public:
  10261. virtual void timerExpired(unsigned long timerId);
  10262.  
  10263. Platform Support 
  10264.  
  10265. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  10266. ΓöéPM          ΓöéMOTIF       Γöé
  10267. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  10268. ΓöéYes         ΓöéNo          Γöé
  10269. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  10270.  
  10271.  
  10272. ΓòÉΓòÉΓòÉ 1.32. ITimerMemberFn0 ΓòÉΓòÉΓòÉ
  10273.  
  10274. Description 
  10275.  
  10276. Derivation 
  10277.  
  10278. Constructors 
  10279.  
  10280. Public Functions 
  10281.  
  10282. Protected Data 
  10283.  
  10284. To close all the panels in a chapter, double click on this panel's system menu. 
  10285.  
  10286.  
  10287. ΓòÉΓòÉΓòÉ <hidden> Derivation - ITimerMemberFn0 ΓòÉΓòÉΓòÉ
  10288.  
  10289. IBase
  10290.   Γöé
  10291. IVBase
  10292.   Γöé
  10293. IRefCounted
  10294.   Γöé
  10295. ITimerFn
  10296.   Γöé
  10297. ITimerMemberFn0
  10298.  
  10299. Inherited by none. 
  10300.  
  10301.  
  10302. ΓòÉΓòÉΓòÉ <hidden> Class Description - ITimerMemberFn0 ΓòÉΓòÉΓòÉ
  10303.  
  10304. itimer.hpp 
  10305.  
  10306. The ITimerMemberFn0 template class is an ITimerFn-derived class for dispatching 
  10307. C++ member functions to an object when a timer expires. The template argument 
  10308. is as follows: 
  10309.  
  10310.  T 
  10311.       The class of object against which the member functions are applied. 
  10312.  
  10313.  Objects of this class dispatch C++ member functions when a timer expires.  The 
  10314.  template argument is the class of the object for which the functions are 
  10315.  called.  The constructor for such objects requires a reference to the object 
  10316.  that the member functions are to be applied to and a pointer to the member 
  10317.  functions. 
  10318.  
  10319.  The member functions return void and accept no arguments. 
  10320.  
  10321.  
  10322. ΓòÉΓòÉΓòÉ <hidden> Public Functions - ITimerMemberFn0 ΓòÉΓòÉΓòÉ
  10323.  
  10324. Constructors
  10325. ITimerMemberFn0
  10326.  
  10327. Timer Expiration
  10328. timerExpired
  10329.  
  10330. Inherited Members
  10331. ITimerFn
  10332. timerExpired
  10333.  
  10334. IRefCounted
  10335. addRef
  10336. removeRef
  10337. useCount
  10338.  
  10339. IVBase
  10340. asDebugInfo
  10341. asString
  10342.  
  10343. IBase
  10344. asDebugInfo
  10345. asString
  10346. messageFile
  10347. messageText
  10348. setMessageFile
  10349. version
  10350.  
  10351.  
  10352. ΓòÉΓòÉΓòÉ <hidden> ITimerMemberFn0 - Constructors ΓòÉΓòÉΓòÉ
  10353.  
  10354. You can construct objects of this class. You cannot copy or assign 
  10355. ITimerMemberFn0 objects because both the copy constructor and the assignment 
  10356. operator are private members. 
  10357.  
  10358.  
  10359. ΓòÉΓòÉΓòÉ <hidden> ITimerMemberFn0 - Hidden Members ΓòÉΓòÉΓòÉ
  10360.  
  10361. You cannot access these members. 
  10362.  
  10363.  
  10364. ΓòÉΓòÉΓòÉ <hidden> ITimerMemberFn0 - Timer Expiration ΓòÉΓòÉΓòÉ
  10365.  
  10366. Use these members to perform actions each time the timer expires. 
  10367.  
  10368.  
  10369. ΓòÉΓòÉΓòÉ <hidden> Protected Data - ITimerMemberFn0 ΓòÉΓòÉΓòÉ
  10370.  
  10371. Inherited Members
  10372. IBase
  10373. recoverable
  10374. unrecoverable
  10375.  
  10376.  
  10377. ΓòÉΓòÉΓòÉ 1.32.1. ITimerMemberFn0::ITimerMemberFn0 ΓòÉΓòÉΓòÉ
  10378.  
  10379. You can construct objects of this class. You cannot copy or assign 
  10380. ITimerMemberFn0 objects because both the copy constructor and the assignment 
  10381. operator are private members. 
  10382.  
  10383. public:
  10384. ITimerMemberFn0( T& object,
  10385.                  void ( T::* memberFunction ) ( ));
  10386.  
  10387. The constructor requires an object of the template argument class T and a 
  10388. pointer to a member function of that class (returning void and accepting no 
  10389. arguments). 
  10390.  
  10391. Platform Support 
  10392.  
  10393. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  10394. ΓöéPM          ΓöéMOTIF       Γöé
  10395. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  10396. ΓöéYes         ΓöéNo          Γöé
  10397. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  10398.  
  10399.  
  10400. ΓòÉΓòÉΓòÉ 1.32.2. ITimerMemberFn0::timerExpired ΓòÉΓòÉΓòÉ
  10401.  
  10402. Calls the pointed-to member function that was provided at construction each 
  10403. time the timer expires. 
  10404.  
  10405. public:
  10406. virtual void timerExpired(unsigned long timerId);
  10407.  
  10408. Platform Support 
  10409.  
  10410. ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  10411. ΓöéPM          ΓöéMOTIF       Γöé
  10412. Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  10413. ΓöéYes         ΓöéNo          Γöé
  10414. ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
  10415.