PageRenderTime 53ms CodeModel.GetById 26ms RepoModel.GetById 0ms app.codeStats 0ms

/docs/TutorialLaunch.htm

https://github.com/fincs/AutoHotkey_L-Docs
HTML | 40 lines | 37 code | 3 blank | 0 comment | 0 complexity | 940958d1dccca642550beb6c2016ce63 MD5 | raw file
    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
    2. 

  2. "http://www.w3.org/TR/html4/loose.dtd">
    3. 

  3. <html>
    4. 

  4. <head>
    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. <title>AutoHotkey Tutorial - Launch a program or document (continued)</title>
    8. 

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

  9. <script src="static/jquery.js" type="text/javascript"></script>
    10. 

  10. <script src="static/tree.jquery.js" type="text/javascript"></script>
    11. 

  11. <script src="static/content.js" type="text/javascript"></script>
    12. 

  12. </head>
    13. 

  13. <body>
    14. 

  14. 

  15. <h1>Tutorial - Launch a program or document (continued)</h1>
    16. 

  16. 

  17. 

  18. <p>To have a program or document start off maximized, minimized, or hidden, consider the following <a href="Hotkeys.htm">hotkey</a> subroutine, which assigns the Win+Z hotkey to launch two instances of Notepad, the first maximized and the second minimized:</p>
    19. 

  19. <pre>#z::
    20. 

  20. Run, Notepad, , max
    21. 

  21. Run, Notepad, , min
    22. 

  22. return</pre>
    23. 

  23. <p>To have a program use a specific folder as its working directory, consider this Win+C hotkey which creates a command prompt window in the specified directory:</p>
    24. 

  24. <pre>#c::Run, %comspec% /k, C:\My Documents</pre>
    25. 

  25. <p>In the above example, <a href="Variables.htm#ComSpec">comspec</a> is a built-in variable that resolves to C:\Windows\system32\cmd.exe on a typical system.</p>
    26. 

  26. <p>To pass parameters, add them immediately after the name of the program or document as in these examples:</p>
    27. 

  27. <pre>Run, %comspec% /c dir &gt;&quot;Output File.txt&quot;, C:\My Documents
    28. 

  28. Run, Notepad.exe &quot;C:\My Documents\Address List.txt&quot;
    29. 

  29. Run, &quot;<a href="Variables.htm#AhkPath">%A_AhkPath%</a>&quot; &quot;C:\Scripts\Test Script.ahk&quot; param1 &quot;param2 with spaces&quot; param3</pre>
    30. 

  30. <p>In the second and third examples above, parameters with spaces in them are enclosed in quotes, which is generally the safest practice. By contrast, the working directory should not be enclosed in quotes even if it contains spaces, such as in the first example above.</p>
    31. 

  31. <p>Certain special words known as <em>system verbs</em> are also supported. The first example below opens the Explorer's properties dialog for the indicated file. The second example prints the specified document.</p>
    32. 

  32. <pre>Run, properties &quot;C:\Address List.txt&quot;
    33. 

  33. Run, print &quot;C:\Address List.txt&quot;</pre>
    34. 

  34. <p>Finally, <a href="commands/Run.htm">RunWait</a> sets the built-in <a href="misc/ErrorLevel.htm">ErrorLevel</a> variable to the exit code of the program it ran (it also waits for the program to finish and close). For example, the following displays a non-zero ErrorLevel because cmd.exe is indicating that a problem occurred:</p>
    35. 

  35. <pre>RunWait, %comspec% /c dir c:\NonExistent.txt, , hide
    36. 

  36. MsgBox, %ErrorLevel%</pre>
    37. 

  37. <p>For more about launching programs and documents, see <a href="commands/Run.htm">Run/RunWait</a>.</p>
    38. 

  38. <p><a href="Tutorial.htm">Return to the Tutorial Table of Contents</a></p>
    39. 

  39. </body>
    40. 

  40. </html>
    41. 

  41.