/AutoHotkey.docset/Contents/Resources/Documents/commands/ComObjCreate.htm

https://gitlab.com/ahkscript/Autohotkey.docset · HTML · 44 lines · 35 code · 9 blank · 0 comment · 0 complexity · fb703c63b0e62e0c738682e12810982c MD5 · raw file 

    

  1. <!DOCTYPE HTML>
    2. 

  2. <html>
    3. 

  3. <head>
    4. 

  4. <title>ComObjCreate()</title>
    5. 

  5. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    6. 

  6. <meta http-equiv="X-UA-Compatible" content="IE=edge">
    7. 

  7. <link href="../static/theme.css" rel="stylesheet" type="text/css" />
    8. 

  8. <script src="../static/content.js" type="text/javascript"></script>
    9. 

  9. </head>
    10. 

  10. <body>
    11. 

  11. 

  12. <h1>ComObjCreate() <span class="ver">[AHK_L 53+]</span></h1>
    13. 

  13. <p>Creates a COM object.</p>
    14. 

  14. <pre class="Syntax">ComObject := ComObjCreate(CLSID [, IID])</pre>
    15. 

  15. 

  16. <h3>Parameters</h3>
    17. 

  17. <dl>
    18. 

  18. 

  19.   <dt>CLSID</dt>
    20. 

  20.   <dd><p>CLSID or human-readable Prog ID of the COM object to create.</p></dd>
    21. 

  21. 

  22.   <dt>IID</dt>
    23. 

  23.   <dd><p><span class="ver">[v1.0.96.00+]:</span> The identifier of an interface the object supports.</p></dd>
    24. 

  24. 

  25. </dl>
    26. 

  26. 

  27. <h3>Return Value</h3>
    28. 

  28. <p>If an error occurs, an empty string is returned.</p>
    29. 

  29. <p>If an IID is specified, an interface pointer is returned. The script must typically call <a href="ObjAddRef.htm">ObjRelease</a> when it is finished with the pointer.</p>
    30. 

  30. <p>Otherwise, a wrapper object usable by script is returned. See <a href="../Objects.htm#Usage_Objects">object syntax</a>.</p>
    31. 

  31. 

  32. <h3>Related</h3>
    33. 

  33. <a href="ComObjGet.htm">ComObjGet</a>, <a href="ComObjActive.htm">ComObjActive</a>, <a href="ComObjConnect.htm">ComObjConnect</a>, <a href="ComObjArray.htm">ComObjArray</a>, <a href="ComObjError.htm">ComObjError</a>, <a href="ComObjQuery.htm">ComObjQuery</a>, <a href="http://msdn.microsoft.com/en-us/library/dcw63t7z.aspx">CreateObject (MSDN)</a>
    34. 

  34. 

  35. <h3>Examples</h3>
    36. 

  36. <p>For a constantly growing list of examples, see the following forum topic: <a href="http://www.autohotkey.com/forum/topic61509.html">http://www.autohotkey.com/forum/topic61509.html</a>.</p>
    37. 

  37. <pre class="NoIndent">
    38. 

  38. ie := <b>ComObjCreate</b>("InternetExplorer.Application")
    39. 

  39. ie.Visible := true  <em>; This is known to work incorrectly on IE7.</em>
    40. 

  40. ie.Navigate("https://autohotkey.com/")
    41. 

  41. </pre>
    42. 

  42. 

  43. </body>
    44. 

  44. </html>
    45.