Adding UDFs to AutoIt and SciTE - Revision history

Melba23 at 09:59, 24 February 2015

2015-02-24T09:59:14Z

← Older revision		Revision as of 09:59, 24 February 2015
Line 1:		Line 1:
	[[Category:SciTE]][[Category:UDF]]		[[Category:SciTE]][[Category:UDF]]
	The ability to download UDFs created by other users is one of the major advantages of AutoIt, but are you one of the many coders who just add these UDFs to the existing "''Include''" folder which contains the standard UDFS distributed with AutoIt? If so then there is much better way to do it - one which will prevent you from losing all of these additional UDFs when you upgrade. Just use a user-defined folder to store all your UDFs - AutoIt makes this very easy to do.		The ability to download UDFs created by other users is one of the major advantages of AutoIt, but are you one of the many coders who just add these UDFs to the existing "''Include''" folder which contains the standard UDFS distributed with AutoIt? If so then there is much better way to do it - one which will prevent you from losing all of these additional UDFs when you upgrade. Just use a user-defined folder to store all your UDFs - AutoIt makes this very easy to do.

			=Creating a Personal Include Folder=

	Begin by creating a new folder to hold the additional UDFs - it is recommended that you do '''NOT''' put this folder in the AutoIt install folder (or it will get overwritten when you upgrade). Then tell AutoIt about this folder.		Begin by creating a new folder to hold the additional UDFs - it is recommended that you do '''NOT''' put this folder in the AutoIt install folder (or it will get overwritten when you upgrade). Then tell AutoIt about this folder.
Line 13:		Line 15:
	'''CYA Note''': Normal precautions are advised if modifying the registry.		'''CYA Note''': Normal precautions are advised if modifying the registry.

	You now have a folder to store modified, downloaded or personal UDFs which are available to use with no need to specify the path and which will not be lost on upgrade. But to make coding with these UDFs even easier you can also add '''CallTips''' and '''AutoComplete''' for them.		You now have a folder to store modified, downloaded or personal UDFs which are available to use with no need to specify the path and which will not be
			lost on upgrade.

			=Adding CallTips and AutoComplete=

			But to make coding with these UDFs even easier you can also add '''CallTips''' and '''AutoComplete''' for them.

	As you might expect, the full ''SciTE4AutoIt3'' package makes it easy - have you downloaded and installed it yet? If you have then just open '''SciTEConfig''' on the '''Other Tools''' tab and press '''Run User Call Tip Manager'''. Then you just need to select the UDF file to add and everything is done for you automatically.		As you might expect, the full ''SciTE4AutoIt3'' package makes it easy - have you downloaded and installed it yet? If you have then just open '''SciTEConfig''' on the '''Other Tools''' tab and press '''Run User Call Tip Manager'''. Then you just need to select the UDF file to add and everything is done for you automatically. Full instructions on using the ''User Call Tip Manager'' are found in the ''SciTE4AutoIt3'' Help file under ''<Extra Utilities>''.

	But if you want to do it manually (which is '''not''' recommended):		But if you want to do it manually (which is '''not''' recommended):

Melba23 at 14:35, 7 September 2013

2013-09-07T14:35:18Z

← Older revision		Revision as of 14:35, 7 September 2013
Line 17:		Line 17:
	As you might expect, the full ''SciTE4AutoIt3'' package makes it easy - have you downloaded and installed it yet? If you have then just open '''SciTEConfig''' on the '''Other Tools''' tab and press '''Run User Call Tip Manager'''. Then you just need to select the UDF file to add and everything is done for you automatically.		As you might expect, the full ''SciTE4AutoIt3'' package makes it easy - have you downloaded and installed it yet? If you have then just open '''SciTEConfig''' on the '''Other Tools''' tab and press '''Run User Call Tip Manager'''. Then you just need to select the UDF file to add and everything is done for you automatically.

	But if you want to do it manually:		But if you want to do it manually (which is '''not''' recommended):

	'''Calltips''' first. These are stored in ''~~C:\Program Files\AutoIt3\SciTE\api~~\au3.user.calltips.api''. If you are doing this for the first time then this file will not exist and you will have to create it. Then add a line like this to the file for each function you wish to have a calltip:		'''Calltips''' first. These are stored in ''<Your_User_Profile>\au3.user.calltips.api''. If you are doing this for the first time then this file will not exist and you will have to create it. Then add a line like this to the file for each function you wish to have a calltip:
	<syntaxhighlight lang="autoit">		<syntaxhighlight lang="autoit">
	_Function($param1, $param2, $param3) Explanation of function (Requires: #Include UDF.au3)		_Function($param1, $param2, $param3) Explanation of function (Requires: #Include UDF.au3)
Line 25:		Line 25:
	Of course you need to change the ''Function, $param'' and ''UDF'' words to the correct values for the UDF function you want to include.		Of course you need to change the ''Function, $param'' and ''UDF'' words to the correct values for the UDF function you want to include.

	Now '''AutoComplete'''. Again a special file is used ''~~C:\Program Files\AutoIt3\SciTE\Properties~~\au3.userudfs.properties'' - again you will have to create it initially - which should read as follows:		Now '''AutoComplete'''. Again a special file is used ''<Your_User_Profile>\au3.userudfs.properties'' - again you will have to create it initially - which should read as follows:
	<syntaxhighlight lang="autoit">		<syntaxhighlight lang="autoit">
	au3.keywords.user.udfs=_function1 _function2 _function3 _function4 \		au3.keywords.user.udfs=_function1 _function2 _function3 _function4 \
Line 31:		Line 31:
	</syntaxhighlight>		</syntaxhighlight>
	Note that the entries are all in lowercase and all lines other than the first begin with a ''@TAB'' character.		Note that the entries are all in lowercase and all lines other than the first begin with a ''@TAB'' character.

	~~You may have adjust the path if you have installed SciTE elsewhere than the recommended option.~~

	Then save all files, close and restart SciTE. You will have '''AutoComplete''' when you start typing the UDF function name in a script and a syntax '''CallTip''' as you enter the parameters. These files are not overwritten when you update SciTE so all your hard work to set this up should be a once-only event.		Then save all files, close and restart SciTE. You will have '''AutoComplete''' when you start typing the UDF function name in a script and a syntax '''CallTip''' as you enter the parameters. These files are not overwritten when you update SciTE so all your hard work to set this up should be a once-only event.

IEvKI3gv9Wrkd41u: Additional page tagging. (Category,WIP,etc)

2012-11-13T18:06:35Z

Additional page tagging. (Category,WIP,etc)

← Older revision		Revision as of 18:06, 13 November 2012
Line 1:		Line 1:
			[[Category:SciTE]][[Category:UDF]]
	The ability to download UDFs created by other users is one of the major advantages of AutoIt, but are you one of the many coders who just add these UDFs to the existing "''Include''" folder which contains the standard UDFS distributed with AutoIt? If so then there is much better way to do it - one which will prevent you from losing all of these additional UDFs when you upgrade. Just use a user-defined folder to store all your UDFs - AutoIt makes this very easy to do.		The ability to download UDFs created by other users is one of the major advantages of AutoIt, but are you one of the many coders who just add these UDFs to the existing "''Include''" folder which contains the standard UDFS distributed with AutoIt? If so then there is much better way to do it - one which will prevent you from losing all of these additional UDFs when you upgrade. Just use a user-defined folder to store all your UDFs - AutoIt makes this very easy to do.

Melba23 at 09:51, 3 November 2012

2012-11-03T09:51:29Z

New page

The ability to download UDFs created by other users is one of the major advantages of AutoIt, but are you one of the many coders who just add these UDFs to the existing "''Include''" folder which contains the standard UDFS distributed with AutoIt? If so then there is much better way to do it - one which will prevent you from losing all of these additional UDFs when you upgrade. Just use a user-defined folder to store all your UDFs - AutoIt makes this very easy to do.

Begin by creating a new folder to hold the additional UDFs - it is recommended that you do '''NOT''' put this folder in the AutoIt install folder (or it will get overwritten when you upgrade). Then tell AutoIt about this folder.

- If you have ''SciTE4AutoIt3'' you can use '''SciTEConfig''' - look for the ''User Include Dir'' input about 2/3 way down the dialog.

- If not (and why not? You can download it from here[http://www.autoitscript.com/site/autoit-script-editor/downloads/]) you need to modify the registry directly as explained on the "''Include''" page of the Help file:
<syntaxhighlight lang="autoit">
There is a special registry value that can be created at "HKEY_CURRENT_USER\Software\AutoIt v3\AutoIt" called "Include".
It should be a REG_SZ (string) value.
</syntaxhighlight>
'''CYA Note''': Normal precautions are advised if modifying the registry.

You now have a folder to store modified, downloaded or personal UDFs which are available to use with no need to specify the path and which will not be lost on upgrade. But to make coding with these UDFs even easier you can also add '''CallTips''' and '''AutoComplete''' for them.

As you might expect, the full ''SciTE4AutoIt3'' package makes it easy - have you downloaded and installed it yet? If you have then just open '''SciTEConfig''' on the '''Other Tools''' tab and press '''Run User Call Tip Manager'''. Then you just need to select the UDF file to add and everything is done for you automatically.

But if you want to do it manually:

'''Calltips''' first. These are stored in ''C:\Program Files\AutoIt3\SciTE\api\au3.user.calltips.api''. If you are doing this for the first time then this file will not exist and you will have to create it. Then add a line like this to the file for each function you wish to have a calltip:
<syntaxhighlight lang="autoit">
_Function($param1, $param2, $param3) Explanation of function (Requires: #Include UDF.au3)
</syntaxhighlight>
Of course you need to change the ''Function, $param'' and ''UDF'' words to the correct values for the UDF function you want to include.

Now '''AutoComplete'''. Again a special file is used ''C:\Program Files\AutoIt3\SciTE\Properties\au3.userudfs.properties'' - again you will have to create it initially - which should read as follows:
<syntaxhighlight lang="autoit">
au3.keywords.user.udfs=_function1 _function2 _function3 _function4 \
_function5 _function6 _function7
</syntaxhighlight>
Note that the entries are all in lowercase and all lines other than the first begin with a ''@TAB'' character.

You may have adjust the path if you have installed SciTE elsewhere than the recommended option.

Then save all files, close and restart SciTE. You will have '''AutoComplete''' when you start typing the UDF function name in a script and a syntax '''CallTip''' as you enter the parameters. These files are not overwritten when you update SciTE so all your hard work to set this up should be a once-only event.

One final thing. If you want the "''Tools - Open Include''" menu item in SciTE to work on the files within this new folder you need to add the following lines to your "''SciTEUser.properties''" file - you open it by using the <''Options - Open User Options File''> menu item:
<syntaxhighlight lang="autoit">
openpath.$(au3)=$(autoit3dir)\include;Your_Folder_Path
openpath.beta.$(au3)=$(autoit3dir)\beta\include;Your_Folder_Path
</syntaxhighlight>
Now you are all set - your personal include files are as accessible as the standard set.