UltraEdit Wiki - User contributions [en]

Main Page

2024-12-13T12:11:53Z

Idmadmin: /* Welcome to the UltraEdit wiki! */

{{#seo:
|title=UltraEdit text editor wiki
|description=A wiki containing full help documentation for UltraEdit text editor for Windows, Mac, and Linux.
}}<div class="row"><div class="col-sm-12">
<h1>UltraEdit text editor wiki</h1>
</div></div>

<div class="row">
<div class="col-md-6">
==Welcome to the UltraEdit wiki!==

This wiki is designed to be a "less official" documentation source for UltraEdit, the [https://www.ultraedit.com/products/ultraedit/ text editor for Windows, Mac, and Linux]. As a user, you are encouraged to contribute to the wiki as you see fit whether that be updating information, adding use cases, helpful tips, etc. Any questions or comments should be [https://www.ultraedit.com/company/contact-us.html#emailform sent to IDM support].
</div>
<div class="col-md-6">

==Wiki editing help==

Editing the wiki is incredibly easy and simple. Check out the [https://en.wikipedia.org/wiki/Help:Cheatsheet wiki markup cheatsheet] or the [https://en.wikipedia.org/wiki/Help:Wiki_markup full documentation on wiki markup].

In order to edit the UltraEdit wiki, you need to [http://wiki.ultraedit.com/Special:CreateAccount create an account] and be logged in.
</div>
</div>

<div class="row">
<div class="col-md-6">
==Getting started with UltraEdit==

New users, start here! We've created the following topics to help get you up and running with UltraEdit finely-tuned to meet your specific preferences and needs.

* [[:Category:Getting started with UltraEdit|Getting started with UltraEdit]]
</div>
<div class="col-md-6">

==UltraEdit Help documentation==
We've stratified our in-product help to be conveniently available for you online. Check the help documentation if you're wanting to know more about a specific feature or functionality.
* [[:Category:Help documentation|Help documentation]]
</div>
</div>

Main Page

2024-12-13T12:11:16Z

Idmadmin: /* Welcome to the UltraEdit wiki! */

{{#seo:
|title=UltraEdit text editor wiki
|description=A wiki containing full help documentation for UltraEdit text editor for Windows, Mac, and Linux.
}}<div class="row"><div class="col-sm-12">
<h1>UltraEdit text editor wiki</h1>
</div></div>

<div class="row">
<div class="col-md-6">
==Welcome to the UltraEdit wiki!==

This wiki is designed to be a "less official" documentation source for UltraEdit, the [https://www.ultraedit.com/products/ultraedit/
text editor for Windows, Mac, and Linux]. As a user, you are encouraged to contribute to the wiki as you see fit whether that be updating information, adding use cases, helpful tips, etc. Any questions or comments should be [https://www.ultraedit.com/company/contact-us.html#emailform sent to IDM support].
</div>
<div class="col-md-6">

==Wiki editing help==

Editing the wiki is incredibly easy and simple. Check out the [https://en.wikipedia.org/wiki/Help:Cheatsheet wiki markup cheatsheet] or the [https://en.wikipedia.org/wiki/Help:Wiki_markup full documentation on wiki markup].

In order to edit the UltraEdit wiki, you need to [http://wiki.ultraedit.com/Special:CreateAccount create an account] and be logged in.
</div>
</div>

<div class="row">
<div class="col-md-6">
==Getting started with UltraEdit==

New users, start here! We've created the following topics to help get you up and running with UltraEdit finely-tuned to meet your specific preferences and needs.

* [[:Category:Getting started with UltraEdit|Getting started with UltraEdit]]
</div>
<div class="col-md-6">

==UltraEdit Help documentation==
We've stratified our in-product help to be conveniently available for you online. Check the help documentation if you're wanting to know more about a specific feature or functionality.
* [[:Category:Help documentation|Help documentation]]
</div>
</div>

Main Page

2024-12-13T12:10:44Z

Idmadmin: /* Welcome to the UltraEdit wiki! */

{{#seo:
|title=UltraEdit text editor wiki
|description=A wiki containing full help documentation for UltraEdit text editor for Windows, Mac, and Linux.
}}<div class="row"><div class="col-sm-12">
<h1>UltraEdit text editor wiki</h1>
</div></div>

<div class="row">
<div class="col-md-6">
==Welcome to the UltraEdit wiki!==

This wiki is designed to be a "less official" documentation source for UltraEdit, the [https://www.ultraedit.com/products/ultraedit/
text editor for Windows, Mac, and Linux]. As a user, you are encouraged to contribute to the wiki as you see fit whether that be updating information, adding use cases, helpful tips, etc. Any questions or comments should be [https://www.ultraedit.com/company/contact-us.html#emailform sent to IDM support].
</div>
<div class="col-md-6">

==Wiki editing help==

Editing the wiki is incredibly easy and simple. Check out the [https://en.wikipedia.org/wiki/Help:Cheatsheet wiki markup cheatsheet] or the [https://en.wikipedia.org/wiki/Help:Wiki_markup full documentation on wiki markup].

In order to edit the UltraEdit wiki, you need to [http://wiki.ultraedit.com/Special:CreateAccount create an account] and be logged in.
</div>
</div>

<div class="row">
<div class="col-md-6">
==Getting started with UltraEdit==

New users, start here! We've created the following topics to help get you up and running with UltraEdit finely-tuned to meet your specific preferences and needs.

* [[:Category:Getting started with UltraEdit|Getting started with UltraEdit]]
</div>
<div class="col-md-6">

==UltraEdit Help documentation==
We've stratified our in-product help to be conveniently available for you online. Check the help documentation if you're wanting to know more about a specific feature or functionality.
* [[:Category:Help documentation|Help documentation]]
</div>
</div>

Main Page

2024-12-13T12:08:04Z

Idmadmin: /* Welcome to the UltraEdit wiki! */

{{#seo:
|title=UltraEdit text editor wiki
|description=A wiki containing full help documentation for UltraEdit text editor for Windows, Mac, and Linux.
}}<div class="row"><div class="col-sm-12">
<h1>UltraEdit text editor wiki</h1>
</div></div>

<div class="row">
<div class="col-md-6">
==Welcome to the UltraEdit wiki!==

This wiki is designed to be a "less official" documentation source for UltraEdit, the [https://www.ultraedit.com/products/ultraedit/ <span class="newtab">text editor for Windows, Mac, and Linux</span>]. As a user, you are encouraged to contribute to the wiki as you see fit whether that be updating information, adding use cases, helpful tips, etc. Any questions or comments should be [https://www.ultraedit.com/company/contact-us.html#emailform sent to IDM support].
</div>
<div class="col-md-6">

==Wiki editing help==

Editing the wiki is incredibly easy and simple. Check out the [https://en.wikipedia.org/wiki/Help:Cheatsheet wiki markup cheatsheet] or the [https://en.wikipedia.org/wiki/Help:Wiki_markup full documentation on wiki markup].

In order to edit the UltraEdit wiki, you need to [http://wiki.ultraedit.com/Special:CreateAccount create an account] and be logged in.
</div>
</div>

<div class="row">
<div class="col-md-6">
==Getting started with UltraEdit==

New users, start here! We've created the following topics to help get you up and running with UltraEdit finely-tuned to meet your specific preferences and needs.

* [[:Category:Getting started with UltraEdit|Getting started with UltraEdit]]
</div>
<div class="col-md-6">

==UltraEdit Help documentation==
We've stratified our in-product help to be conveniently available for you online. Check the help documentation if you're wanting to know more about a specific feature or functionality.
* [[:Category:Help documentation|Help documentation]]
</div>
</div>

Main Page

2024-12-13T11:44:02Z

Idmadmin: /* Welcome to the UltraEdit wiki! */

Main Page

2024-12-13T11:43:33Z

Idmadmin: /* Welcome to the UltraEdit wiki! */

{{#seo:
|title=UltraEdit text editor wiki
|description=A wiki containing full help documentation for UltraEdit text editor for Windows, Mac, and Linux.
}}<div class="row"><div class="col-sm-12">
<h1>UltraEdit text editor wiki</h1>
</div></div>

<div class="row">
<div class="col-md-6">
==Welcome to the UltraEdit wiki!==

This wiki is designed to be a "less official" documentation source for UltraEdit, the [newtab>https://www.ultraedit.com/products/ultraedit/ text editor for Windows, Mac, and Linux]. As a user, you are encouraged to contribute to the wiki as you see fit whether that be updating information, adding use cases, helpful tips, etc. Any questions or comments should be [https://www.ultraedit.com/company/contact-us.html#emailform sent to IDM support].
</div>
<div class="col-md-6">

==Wiki editing help==

Editing the wiki is incredibly easy and simple. Check out the [https://en.wikipedia.org/wiki/Help:Cheatsheet wiki markup cheatsheet] or the [https://en.wikipedia.org/wiki/Help:Wiki_markup full documentation on wiki markup].

In order to edit the UltraEdit wiki, you need to [http://wiki.ultraedit.com/Special:CreateAccount create an account] and be logged in.
</div>
</div>

<div class="row">
<div class="col-md-6">
==Getting started with UltraEdit==

New users, start here! We've created the following topics to help get you up and running with UltraEdit finely-tuned to meet your specific preferences and needs.

* [[:Category:Getting started with UltraEdit|Getting started with UltraEdit]]
</div>
<div class="col-md-6">

==UltraEdit Help documentation==
We've stratified our in-product help to be conveniently available for you online. Check the help documentation if you're wanting to know more about a specific feature or functionality.
* [[:Category:Help documentation|Help documentation]]
</div>
</div>

Main Page

2024-12-13T11:42:38Z

Idmadmin: /* Welcome to the UltraEdit wiki! */

{{#seo:
|title=UltraEdit text editor wiki
|description=A wiki containing full help documentation for UltraEdit text editor for Windows, Mac, and Linux.
}}<div class="row"><div class="col-sm-12">
<h1>UltraEdit text editor wiki</h1>
</div></div>

<div class="row">
<div class="col-md-6">
==Welcome to the UltraEdit wiki!==

This wiki is designed to be a "less official" documentation source for UltraEdit, the [[ https://www.ultraedit.com/products/ultraedit/ text editor for Windows, Mac, and Linux ]]. As a user, you are encouraged to contribute to the wiki as you see fit whether that be updating information, adding use cases, helpful tips, etc. Any questions or comments should be [https://www.ultraedit.com/company/contact-us.html#emailform sent to IDM support].
</div>
<div class="col-md-6">

==Wiki editing help==

Editing the wiki is incredibly easy and simple. Check out the [https://en.wikipedia.org/wiki/Help:Cheatsheet wiki markup cheatsheet] or the [https://en.wikipedia.org/wiki/Help:Wiki_markup full documentation on wiki markup].

In order to edit the UltraEdit wiki, you need to [http://wiki.ultraedit.com/Special:CreateAccount create an account] and be logged in.
</div>
</div>

<div class="row">
<div class="col-md-6">
==Getting started with UltraEdit==

New users, start here! We've created the following topics to help get you up and running with UltraEdit finely-tuned to meet your specific preferences and needs.

* [[:Category:Getting started with UltraEdit|Getting started with UltraEdit]]
</div>
<div class="col-md-6">

==UltraEdit Help documentation==
We've stratified our in-product help to be conveniently available for you online. Check the help documentation if you're wanting to know more about a specific feature or functionality.
* [[:Category:Help documentation|Help documentation]]
</div>
</div>

Main Page

2024-12-13T11:42:02Z

Idmadmin: /* Welcome to the UltraEdit wiki! */

{{#seo:
|title=UltraEdit text editor wiki
|description=A wiki containing full help documentation for UltraEdit text editor for Windows, Mac, and Linux.
}}<div class="row"><div class="col-sm-12">
<h1>UltraEdit text editor wiki</h1>
</div></div>

<div class="row">
<div class="col-md-6">
==Welcome to the UltraEdit wiki!==

This wiki is designed to be a "less official" documentation source for UltraEdit, the [ [https://www.ultraedit.com/products/ultraedit/ text editor for Windows, Mac, and Linux] ]. As a user, you are encouraged to contribute to the wiki as you see fit whether that be updating information, adding use cases, helpful tips, etc. Any questions or comments should be [https://www.ultraedit.com/company/contact-us.html#emailform sent to IDM support].
</div>
<div class="col-md-6">

==Wiki editing help==

Editing the wiki is incredibly easy and simple. Check out the [https://en.wikipedia.org/wiki/Help:Cheatsheet wiki markup cheatsheet] or the [https://en.wikipedia.org/wiki/Help:Wiki_markup full documentation on wiki markup].

In order to edit the UltraEdit wiki, you need to [http://wiki.ultraedit.com/Special:CreateAccount create an account] and be logged in.
</div>
</div>

<div class="row">
<div class="col-md-6">
==Getting started with UltraEdit==

New users, start here! We've created the following topics to help get you up and running with UltraEdit finely-tuned to meet your specific preferences and needs.

* [[:Category:Getting started with UltraEdit|Getting started with UltraEdit]]
</div>
<div class="col-md-6">

==UltraEdit Help documentation==
We've stratified our in-product help to be conveniently available for you online. Check the help documentation if you're wanting to know more about a specific feature or functionality.
* [[:Category:Help documentation|Help documentation]]
</div>
</div>

Main Page

2024-12-13T11:39:36Z

Idmadmin: /* Welcome to the UltraEdit wiki! */

{{#seo:
|title=UltraEdit text editor wiki
|description=A wiki containing full help documentation for UltraEdit text editor for Windows, Mac, and Linux.
}}<div class="row"><div class="col-sm-12">
<h1>UltraEdit text editor wiki</h1>
</div></div>

<div class="row">
<div class="col-md-6">
==Welcome to the UltraEdit wiki!==

This wiki is designed to be a "less official" documentation source for UltraEdit, the [[https://www.ultraedit.com/products/ultraedit/ text editor for Windows, Mac, and Linux]]. As a user, you are encouraged to contribute to the wiki as you see fit whether that be updating information, adding use cases, helpful tips, etc. Any questions or comments should be [https://www.ultraedit.com/company/contact-us.html#emailform sent to IDM support].
</div>
<div class="col-md-6">

==Wiki editing help==

Editing the wiki is incredibly easy and simple. Check out the [https://en.wikipedia.org/wiki/Help:Cheatsheet wiki markup cheatsheet] or the [https://en.wikipedia.org/wiki/Help:Wiki_markup full documentation on wiki markup].

In order to edit the UltraEdit wiki, you need to [http://wiki.ultraedit.com/Special:CreateAccount create an account] and be logged in.
</div>
</div>

<div class="row">
<div class="col-md-6">
==Getting started with UltraEdit==

New users, start here! We've created the following topics to help get you up and running with UltraEdit finely-tuned to meet your specific preferences and needs.

* [[:Category:Getting started with UltraEdit|Getting started with UltraEdit]]
</div>
<div class="col-md-6">

==UltraEdit Help documentation==
We've stratified our in-product help to be conveniently available for you online. Check the help documentation if you're wanting to know more about a specific feature or functionality.
* [[:Category:Help documentation|Help documentation]]
</div>
</div>

Main Page

2024-12-13T11:36:55Z

Idmadmin: /* Welcome to the UltraEdit wiki! */

Main Page

2024-12-13T11:36:39Z

Idmadmin: /* Welcome to the UltraEdit wiki! */

{{#seo:
|title=UltraEdit text editor wiki
|description=A wiki containing full help documentation for UltraEdit text editor for Windows, Mac, and Linux.
}}<div class="row"><div class="col-sm-12">
<h1>UltraEdit text editor wiki</h1>
</div></div>

<div class="row">
<div class="col-md-6">
==Welcome to the UltraEdit wiki!==

This wiki is designed to be a "less official" documentation source for UltraEdit, the[https://www.ultraedit.com/products/ultraedit/ text editor for Windows, Mac, and Linux]. As a user, you are encouraged to contribute to the wiki as you see fit whether that be updating information, adding use cases, helpful tips, etc. Any questions or comments should be [https://www.ultraedit.com/company/contact-us.html#emailform sent to IDM support].
</div>
<div class="col-md-6">

==Wiki editing help==

Editing the wiki is incredibly easy and simple. Check out the [https://en.wikipedia.org/wiki/Help:Cheatsheet wiki markup cheatsheet] or the [https://en.wikipedia.org/wiki/Help:Wiki_markup full documentation on wiki markup].

In order to edit the UltraEdit wiki, you need to [http://wiki.ultraedit.com/Special:CreateAccount create an account] and be logged in.
</div>
</div>

<div class="row">
<div class="col-md-6">
==Getting started with UltraEdit==

New users, start here! We've created the following topics to help get you up and running with UltraEdit finely-tuned to meet your specific preferences and needs.

* [[:Category:Getting started with UltraEdit|Getting started with UltraEdit]]
</div>
<div class="col-md-6">

==UltraEdit Help documentation==
We've stratified our in-product help to be conveniently available for you online. Check the help documentation if you're wanting to know more about a specific feature or functionality.
* [[:Category:Help documentation|Help documentation]]
</div>
</div>

Select compiler

2024-12-12T12:14:41Z

Idmadmin: Redirected page to Main Page

#REDIRECT [[Main_Page]]

Category:Build

2024-12-12T12:14:09Z

Idmadmin: Redirected page to Main Page

#REDIRECT [[Main_Page]]

Save As

2024-12-12T12:13:43Z

Idmadmin: Redirected page to Main Page

#REDIRECT [[Main_Page]]

Scripting

2024-12-12T12:12:25Z

Idmadmin: Redirected page to Main Page

#REDIRECT [[Main_Page]]

Hex mode

2024-12-12T11:53:47Z

Idmadmin: Redirected page to Main Page

#REDIRECT [[Main_Page]]

Conversions (encoding)

2024-12-12T11:46:03Z

Idmadmin: Redirected page to Main Page

#REDIRECT [[Main_Page]]

Settings:Editor:Word wrap/tab settings

2024-12-12T11:39:49Z

Idmadmin: Redirected page to Main Page

#REDIRECT [[Main_Page]]

INI file

2024-12-12T10:59:36Z

Idmadmin: Redirected page to Main Page

#REDIRECT [[Main_Page]]

Https://wiki.ultraedit.com/

2024-12-12T10:59:28Z

Idmadmin: Blanked the page

Https://wiki.ultraedit.com/

2024-12-12T10:58:26Z

Idmadmin: Redirected page to Main Page

#REDIRECT [[Main_Page]]

INI file

2024-12-12T10:37:04Z

Idmadmin: Blanked the page

INI file

2024-12-12T10:34:54Z

Idmadmin: Redirected page to Https://wiki.ultraedit.com/

#REDIRECT [[https://wiki.ultraedit.com/]]

Cloud sync

2024-09-13T15:05:23Z

Idmadmin:

[[Category:Home tab]]

''Cloud Sync is no longer available for new licenses as of January 1, 2024. Current license owners can still access it until it is discontinued (date TBD).''

[[File:UltraEdit cloud sync.png|right|200px|alt=screenshot of cloud sync in UltraEdit|Cloud sync in UltraEdit]]

'''Cloud sync''' is a feature of [https://www.ultraedit.com/products/cloud-services.html Cloud Services], an optional add-on with subscription licenses. With cloud sync, you can share settings between multiple connected systems over the cloud. service that allows users to share settings and files between systems. You can open the cloud sync window by either clicking the '''Cloud services''' icon in the [[:Category:Home tab|Home tab]], or checking the '''Cloud services''' checkbox in the [[:Category:Layout tab|Layout tab]].

== Logging in ==
To use cloud sync, you must have a subscription license that includes Cloud Services, and then you must login with an existing identity provider (Google account, Github account, or Microsoft account). Use the same credentials on your other systems where you've activated the license.

== Syncing systems ==
The system on which you first log into cloud sync is set as "Master," meaning this is the system that you can push settings to the cloud from. All other systems you log into are considered secondary, meaning you can pull settings from Master onto them.

In the "Sync" tab on the '''Master''' system, you'll see a list of all syncable settings / files as well as a '''PUSH''' button at the bottom. Here you can check or uncheck the settings and categories you wish to sync to other systems. Once you click the '''PUSH''' button, these settings are pushed to the cloud.

Note that macros and scripts are synced ''only'' from the "Macro directory" and "Script directory" paths set in [[Settings:Cloud services|Settings » Cloud services]].

In the "Sync" tab on '''secondary''' systems, you'll see the same list of syncable settings as well as a '''PULL''' button at the bottom. You can check or uncheck the settings and categories you wish to sync on this system only. For example, even if the Master system has pushed all settings to the cloud, you might only want to sync the FTP / SSH accounts to this secondary system.

If a new sync is available on the cloud, a green notification will appear above the '''PULL''' button. Once you click the '''PULL''' button, all selected categories are synced down to the secondary system, overwriting the existing settings.

== Cloud contents ==
You can review what is currently on the cloud by clicking the "Cloud" tab. All categories are shown here as well as the origin system and the last time they were synced.

At the bottom of this list is a '''Delete Cloud Contents''' button where you can delete all settings, data, and files that are stored on the cloud with your sync account.

== Settings ==
You can click the "'''⚙'''" tab to access settings related to your sync systems:

'''Make Master'''<br>
This allows you to set the current system as Master. This button is unavailable if the system is already set as Master.

'''Edit Nickname'''<br>
This allows you to rename the current system within Cloud Services. By default the machine name is used, but providing a more descriptive name makes management of instances much easier.

'''Remove system'''<br>
This allows you to remove the current system from the sync account completely. This action will also sign you out of your sync account.

'''Reset system'''<br>
As shown in this button's caption, this option will reset the local system to the settings that are currently on the cloud. This is useful on the Master system, for example, where it's only possible to push settings to the cloud on the "Sync" tab. '''Caution:''' It's important to understand that this option is potentially destructive: With the '''PULL''' option, the local system's settings and data will never be overwritten with nothing (effectively deleted), however in the case of '''Reset System''', cloud sync ''will'' overwrite all local system settings to match the ''exact'' state of data and settings on the cloud. This means that if one settings category doesn't ''exist'' on the cloud, that category will be '''reset to defaults''' locally.

== Undoing a sync ==
All local settings are backed up each time you pull settings to a secondary system. If wish to undo a pull, you can access and restore from these backups by going to [[Settings:Cloud services|Settings » Cloud services]] and clicking the '''Restore from local backup''' button.

== Manage account ==
The cloud sync interface provides account management features. To see all instances (systems) in your sync account including which is Master, from the sync home, click the '''←''' button at the top left. To go back to the sync home, click the '''→''' icon next to your active system's name. You can also open the menu at top-left and click '''Sync Home'''.

Within the instances view, you can also click the '''⚙''' icon next to the current system name to jump to its settings page.

To see your user settings, open the menu at top-left and select "User Settings". Here you can delete your entire cloud account, reload (refresh) cloud sync, or sign out of your account on the active system.

<div class="idm-see-also">
See also:
* [[Settings:Cloud services|Settings » Cloud services]]
</div>

Cloud sync

2024-01-19T07:21:54Z

Idmadmin:

[[Category:Home tab]]

''Cloud sync is being discontinued as of January 1, 2024. Current license owners can use it until expiry.''

[[File:UltraEdit cloud sync.png|right|200px|alt=screenshot of cloud sync in UltraEdit|Cloud sync in UltraEdit]]

'''Cloud sync''' is a feature of [https://www.ultraedit.com/products/cloud-services.html Cloud Services], an optional add-on with subscription licenses. With cloud sync, you can share settings between multiple connected systems over the cloud. service that allows users to share settings and files between systems. You can open the cloud sync window by either clicking the '''Cloud services''' icon in the [[:Category:Home tab|Home tab]], or checking the '''Cloud services''' checkbox in the [[:Category:Layout tab|Layout tab]].

== Logging in ==
To use cloud sync, you must have a subscription license that includes Cloud Services, and then you must login with an existing identity provider (Google account, Github account, or Microsoft account). Use the same credentials on your other systems where you've activated the license.

== Syncing systems ==
The system on which you first log into cloud sync is set as "Master," meaning this is the system that you can push settings to the cloud from. All other systems you log into are considered secondary, meaning you can pull settings from Master onto them.

In the "Sync" tab on the '''Master''' system, you'll see a list of all syncable settings / files as well as a '''PUSH''' button at the bottom. Here you can check or uncheck the settings and categories you wish to sync to other systems. Once you click the '''PUSH''' button, these settings are pushed to the cloud.

Note that macros and scripts are synced ''only'' from the "Macro directory" and "Script directory" paths set in [[Settings:Cloud services|Settings » Cloud services]].

In the "Sync" tab on '''secondary''' systems, you'll see the same list of syncable settings as well as a '''PULL''' button at the bottom. You can check or uncheck the settings and categories you wish to sync on this system only. For example, even if the Master system has pushed all settings to the cloud, you might only want to sync the FTP / SSH accounts to this secondary system.

If a new sync is available on the cloud, a green notification will appear above the '''PULL''' button. Once you click the '''PULL''' button, all selected categories are synced down to the secondary system, overwriting the existing settings.

== Cloud contents ==
You can review what is currently on the cloud by clicking the "Cloud" tab. All categories are shown here as well as the origin system and the last time they were synced.

At the bottom of this list is a '''Delete Cloud Contents''' button where you can delete all settings, data, and files that are stored on the cloud with your sync account.

== Settings ==
You can click the "'''⚙'''" tab to access settings related to your sync systems:

'''Make Master'''<br>
This allows you to set the current system as Master. This button is unavailable if the system is already set as Master.

'''Edit Nickname'''<br>
This allows you to rename the current system within Cloud Services. By default the machine name is used, but providing a more descriptive name makes management of instances much easier.

'''Remove system'''<br>
This allows you to remove the current system from the sync account completely. This action will also sign you out of your sync account.

'''Reset system'''<br>
As shown in this button's caption, this option will reset the local system to the settings that are currently on the cloud. This is useful on the Master system, for example, where it's only possible to push settings to the cloud on the "Sync" tab. '''Caution:''' It's important to understand that this option is potentially destructive: With the '''PULL''' option, the local system's settings and data will never be overwritten with nothing (effectively deleted), however in the case of '''Reset System''', cloud sync ''will'' overwrite all local system settings to match the ''exact'' state of data and settings on the cloud. This means that if one settings category doesn't ''exist'' on the cloud, that category will be '''reset to defaults''' locally.

== Undoing a sync ==
All local settings are backed up each time you pull settings to a secondary system. If wish to undo a pull, you can access and restore from these backups by going to [[Settings:Cloud services|Settings » Cloud services]] and clicking the '''Restore from local backup''' button.

== Manage account ==
The cloud sync interface provides account management features. To see all instances (systems) in your sync account including which is Master, from the sync home, click the '''←''' button at the top left. To go back to the sync home, click the '''→''' icon next to your active system's name. You can also open the menu at top-left and click '''Sync Home'''.

Within the instances view, you can also click the '''⚙''' icon next to the current system name to jump to its settings page.

To see your user settings, open the menu at top-left and select "User Settings". Here you can delete your entire cloud account, reload (refresh) cloud sync, or sign out of your account on the active system.

<div class="idm-see-also">
See also:
* [[Settings:Cloud services|Settings » Cloud services]]
</div>

Cloud sync

2024-01-19T07:20:39Z

Idmadmin:

[[Category:Home tab]]

Cloud sync is being discontinued as of January 1, 2024. Current license owners can use it until expiry.

[[File:UltraEdit cloud sync.png|right|200px|alt=screenshot of cloud sync in UltraEdit|Cloud sync in UltraEdit]]

'''Cloud sync''' is a feature of [https://www.ultraedit.com/products/cloud-services.html Cloud Services], an optional add-on with subscription licenses. With cloud sync, you can share settings between multiple connected systems over the cloud. service that allows users to share settings and files between systems. You can open the cloud sync window by either clicking the '''Cloud services''' icon in the [[:Category:Home tab|Home tab]], or checking the '''Cloud services''' checkbox in the [[:Category:Layout tab|Layout tab]].

== Logging in ==
To use cloud sync, you must have a subscription license that includes Cloud Services, and then you must login with an existing identity provider (Google account, Github account, or Microsoft account). Use the same credentials on your other systems where you've activated the license.

== Syncing systems ==
The system on which you first log into cloud sync is set as "Master," meaning this is the system that you can push settings to the cloud from. All other systems you log into are considered secondary, meaning you can pull settings from Master onto them.

In the "Sync" tab on the '''Master''' system, you'll see a list of all syncable settings / files as well as a '''PUSH''' button at the bottom. Here you can check or uncheck the settings and categories you wish to sync to other systems. Once you click the '''PUSH''' button, these settings are pushed to the cloud.

Note that macros and scripts are synced ''only'' from the "Macro directory" and "Script directory" paths set in [[Settings:Cloud services|Settings » Cloud services]].

In the "Sync" tab on '''secondary''' systems, you'll see the same list of syncable settings as well as a '''PULL''' button at the bottom. You can check or uncheck the settings and categories you wish to sync on this system only. For example, even if the Master system has pushed all settings to the cloud, you might only want to sync the FTP / SSH accounts to this secondary system.

If a new sync is available on the cloud, a green notification will appear above the '''PULL''' button. Once you click the '''PULL''' button, all selected categories are synced down to the secondary system, overwriting the existing settings.

== Cloud contents ==
You can review what is currently on the cloud by clicking the "Cloud" tab. All categories are shown here as well as the origin system and the last time they were synced.

At the bottom of this list is a '''Delete Cloud Contents''' button where you can delete all settings, data, and files that are stored on the cloud with your sync account.

== Settings ==
You can click the "'''⚙'''" tab to access settings related to your sync systems:

'''Make Master'''<br>
This allows you to set the current system as Master. This button is unavailable if the system is already set as Master.

'''Edit Nickname'''<br>
This allows you to rename the current system within Cloud Services. By default the machine name is used, but providing a more descriptive name makes management of instances much easier.

'''Remove system'''<br>
This allows you to remove the current system from the sync account completely. This action will also sign you out of your sync account.

'''Reset system'''<br>
As shown in this button's caption, this option will reset the local system to the settings that are currently on the cloud. This is useful on the Master system, for example, where it's only possible to push settings to the cloud on the "Sync" tab. '''Caution:''' It's important to understand that this option is potentially destructive: With the '''PULL''' option, the local system's settings and data will never be overwritten with nothing (effectively deleted), however in the case of '''Reset System''', cloud sync ''will'' overwrite all local system settings to match the ''exact'' state of data and settings on the cloud. This means that if one settings category doesn't ''exist'' on the cloud, that category will be '''reset to defaults''' locally.

== Undoing a sync ==
All local settings are backed up each time you pull settings to a secondary system. If wish to undo a pull, you can access and restore from these backups by going to [[Settings:Cloud services|Settings » Cloud services]] and clicking the '''Restore from local backup''' button.

== Manage account ==
The cloud sync interface provides account management features. To see all instances (systems) in your sync account including which is Master, from the sync home, click the '''←''' button at the top left. To go back to the sync home, click the '''→''' icon next to your active system's name. You can also open the menu at top-left and click '''Sync Home'''.

Within the instances view, you can also click the '''⚙''' icon next to the current system name to jump to its settings page.

To see your user settings, open the menu at top-left and select "User Settings". Here you can delete your entire cloud account, reload (refresh) cloud sync, or sign out of your account on the active system.

<div class="idm-see-also">
See also:
* [[Settings:Cloud services|Settings » Cloud services]]
</div>

Cloud sync

2024-01-19T07:20:09Z

Idmadmin:

Cloud sync is being discontinued as of January 1, 2024. Current license owners can use it until expiry.

[[Category:Home tab]]

[[File:UltraEdit cloud sync.png|right|200px|alt=screenshot of cloud sync in UltraEdit|Cloud sync in UltraEdit]]

'''Cloud sync''' is a feature of [https://www.ultraedit.com/products/cloud-services.html Cloud Services], an optional add-on with subscription licenses. With cloud sync, you can share settings between multiple connected systems over the cloud. service that allows users to share settings and files between systems. You can open the cloud sync window by either clicking the '''Cloud services''' icon in the [[:Category:Home tab|Home tab]], or checking the '''Cloud services''' checkbox in the [[:Category:Layout tab|Layout tab]].

== Logging in ==
To use cloud sync, you must have a subscription license that includes Cloud Services, and then you must login with an existing identity provider (Google account, Github account, or Microsoft account). Use the same credentials on your other systems where you've activated the license.

== Syncing systems ==
The system on which you first log into cloud sync is set as "Master," meaning this is the system that you can push settings to the cloud from. All other systems you log into are considered secondary, meaning you can pull settings from Master onto them.

In the "Sync" tab on the '''Master''' system, you'll see a list of all syncable settings / files as well as a '''PUSH''' button at the bottom. Here you can check or uncheck the settings and categories you wish to sync to other systems. Once you click the '''PUSH''' button, these settings are pushed to the cloud.

Note that macros and scripts are synced ''only'' from the "Macro directory" and "Script directory" paths set in [[Settings:Cloud services|Settings » Cloud services]].

In the "Sync" tab on '''secondary''' systems, you'll see the same list of syncable settings as well as a '''PULL''' button at the bottom. You can check or uncheck the settings and categories you wish to sync on this system only. For example, even if the Master system has pushed all settings to the cloud, you might only want to sync the FTP / SSH accounts to this secondary system.

If a new sync is available on the cloud, a green notification will appear above the '''PULL''' button. Once you click the '''PULL''' button, all selected categories are synced down to the secondary system, overwriting the existing settings.

== Cloud contents ==
You can review what is currently on the cloud by clicking the "Cloud" tab. All categories are shown here as well as the origin system and the last time they were synced.

At the bottom of this list is a '''Delete Cloud Contents''' button where you can delete all settings, data, and files that are stored on the cloud with your sync account.

== Settings ==
You can click the "'''⚙'''" tab to access settings related to your sync systems:

'''Make Master'''<br>
This allows you to set the current system as Master. This button is unavailable if the system is already set as Master.

'''Edit Nickname'''<br>
This allows you to rename the current system within Cloud Services. By default the machine name is used, but providing a more descriptive name makes management of instances much easier.

'''Remove system'''<br>
This allows you to remove the current system from the sync account completely. This action will also sign you out of your sync account.

'''Reset system'''<br>
As shown in this button's caption, this option will reset the local system to the settings that are currently on the cloud. This is useful on the Master system, for example, where it's only possible to push settings to the cloud on the "Sync" tab. '''Caution:''' It's important to understand that this option is potentially destructive: With the '''PULL''' option, the local system's settings and data will never be overwritten with nothing (effectively deleted), however in the case of '''Reset System''', cloud sync ''will'' overwrite all local system settings to match the ''exact'' state of data and settings on the cloud. This means that if one settings category doesn't ''exist'' on the cloud, that category will be '''reset to defaults''' locally.

== Undoing a sync ==
All local settings are backed up each time you pull settings to a secondary system. If wish to undo a pull, you can access and restore from these backups by going to [[Settings:Cloud services|Settings » Cloud services]] and clicking the '''Restore from local backup''' button.

== Manage account ==
The cloud sync interface provides account management features. To see all instances (systems) in your sync account including which is Master, from the sync home, click the '''←''' button at the top left. To go back to the sync home, click the '''→''' icon next to your active system's name. You can also open the menu at top-left and click '''Sync Home'''.

Within the instances view, you can also click the '''⚙''' icon next to the current system name to jump to its settings page.

To see your user settings, open the menu at top-left and select "User Settings". Here you can delete your entire cloud account, reload (refresh) cloud sync, or sign out of your account on the active system.

<div class="idm-see-also">
See also:
* [[Settings:Cloud services|Settings » Cloud services]]
</div>

Cloud sync

2024-01-19T07:19:54Z

Idmadmin:

Cloud sync

2024-01-19T07:19:08Z

Idmadmin:

Wiki/api.php

2023-11-28T06:43:21Z

Idmadmin: Blanked the page

Wiki/api.php

2023-11-28T06:42:45Z

Idmadmin: Redirected page to Https://ultraedit.com/

#REDIRECT [[https://ultraedit.com/]]

Reindent selection

2023-09-21T13:02:13Z

Idmadmin:

[[Category:Format tab]]
'''Reindent selection''' allows you to reformat the selected text within the active file. This is typically used when typing source code to reformat existing text according to the settings in [[Settings:Editor:Word_wrap_/_tab_settings|Settings » Editor » Word wrap/tab settings]] and the automatic [[Wordfiles#Indent_.2F_unindent_strings|indent / unindent strings]] settings for syntax highlighting. The file must be syntax highlighted with a wordfile containing indent / unindent strings in order for reindent selection to have any effect.

When reindenting, UltraEdit will reindent the selection line by line, starting by "resetting" the indentation of the first line in the selection to column 1 and then applying reindentation to other lines from that point forward until the end of the selection, based upon the indent / unindent strings in the wordfile.

UltraEdit will try and determine if the statement causing a change in the indentation is part of a comment or string and ignores it in this case. However, if the file contains preprocessor conditional statements (#ifdef, #ifndef, etc.) UltraEdit does not attempt to determine which text is valid and which is not. This may cause lines to be adjusted incorrectly.

To avoid problems with conditional statements it is recommended that all conditional sections include the same number of open and close conditional statements. For examplel, if an <code>if (test) {</code> statement is in the conditional text, make sure the closing brace <code>}</code> is also in the conditional text.

In some cases it may be desirable not to indent lines such as compiler directives or comments. UltraEdit provides for this capability by allowing strings to be ignored to be defined in the active [[Wordfiles#Indent_.2F_unindent_strings|wordfile]].

Wordfiles

2023-05-04T14:32:12Z

Idmadmin:

{{#seo:
|title=Configuring syntax highlighting wordfiles in UltraEdit text editor
|description=Full documentation on creating and configuring syntax highlighting wordfiles in UltraEdit text editor for Windows, Mac, and Linux
}}[[File:Ultraedit wordfile.png|right|thumb|alt=UltraEdit wordfile|Example of a wordfile used for syntax highlighting in UltraEdit]]

As discussed in the [[Syntax highlighting]] topic, UltraEdit applies syntax highlighting from definitions and configurations in wordfiles. In order to work properly, wordfiles:

* must be in plain text format with DOS style line endings
* can be in either ANSI, UTF-16, or UTF-8 encoding format (with or without BOM – Unicode characters are supported for all wordfile settings and definitions)
* must have a .uew file extension
* must be no more than 372 KB in size, and finally
* must be saved in the wordfiles folder shown in [[Settings:Editor display:Syntax highlighting|Settings » Editor Display » Syntax Highlighting]] (subfolders are ignored).

Wordfiles are loaded on startup, or when modified via the '''[[Add syntax highlighting languages|Add another language...]]''' dialog.

The '''easiest''' way to create your own wordfile is to take one of the existing wordfiles and modify it as desired, saving it into the wordfiles directory with a unique name and .uew file extension. You will need to restart UltraEdit in order to initialize the new wordfile, but once initialized, any changes you make to it will be reflected in real-time when you switch to an open file being highlighted by the wordfile you're modifying.

This topic exhaustively documents all possible options and sections of the wordfile.

== Language definition ==
The first step to creating a valid wordfile is defining the language it will apply highlighting for. This is done on the '''first line''' of the wordfile via the following syntax:

<code>/L#"Language Name"</code>

...where "#" is a number (no longer used for sorting purposes but still required) and "Language Name" is the name as it will appear in the list of available syntax highlighting languages.

== Language options ==

There are several keywords available for specifying syntax highlighting behavior options in the wordfile. These options are set by simply including the keyword in the wordfile. These are typically added immediately after the language definition on line 1 of the wordfile, but can be listed on their own line if you desire. Note: If the option is on its own line in the wordfile, it must be preceded by a forward slash, e.g.:

<code>/DisableMLS</code>
{|
!Option name
!Behavior
|-
|<code>Nocase</code>
|Disables case sensitivity for syntax highlighting. By default, syntax highlighting ''is'' case sensitive.
|-
|<code>Noquote</code>
|Disables string highlighting for the language completely.
|-
|<code>EnableMLS</code>
|Enables multi-line string support (an unclosed string may span multiple lines) for the language.
|-
|<code>DisableMLS</code>
|Disables multi-line string support (an unclosed string will not be highlighted past the first line) for the language.
|-
|<code>NestBlockComments</code>
|Enables the matching/pairing of nested block comment highlighting if the coding language supports these. (HTML, for example, does not.)
|-
|<code>EnableCFByIndent</code>
|Overrides any code folding string and applies code folding based upon the code's indentation level (for languages like Python).
|-
|<code>EnableSpellasYouType</code>
|Enables spell-as-you-type inline spell checking for the language (if set in [[Settings:Spell checker:Miscellaneous|Settings » Spell checker » Miscellaneous]]).
|}

== Special "_LANG" language flags ==
In order to apply correct syntax highlighting and other wordfile-based functionality, for several languages, special internal handling is required. These languages are determined via special flags in the wordfile. There are a fixed number of special language flags, and more may be added in the future. The available flags are described in detail below.

The language flag must exist on the line 1 of the wordfile somewhere after the language definition.

'''Important note: each language flag may exist only once in a single wordfile. Adding a language flag to multiple wordfiles will result in unexpected / incorrect highlighting for the associated language(s).'''

{|
!Flag
!For language
|-|-
|<code>AASM_LANG</code>
|'''AT&T Assembly'''
|-
|<code>ASP_LANG</code>
|'''ASP'''

Note: the .asp(x) file extension (and all variants) should be listed in the HTML wordfile to support multi-language embedded ASP highlighting. This will not adversely affect standalone ASP files.
|-
|<code>COBOL_LANG</code>
|'''COBOL'''
|-
|<code>CSHARP_LANG</code>
|'''C#'''
|-
|<code>CSS_LANG</code>
|'''CSS'''
|-
|<code>C_LANG</code>
|'''C/C++'''
|-
|<code>ECMA_LANG</code>
|'''EcmaScript'''
|-
|<code>FORTRAN_LANG</code>
|'''FORTRAN'''

With this flag, in highlighted source files UltraEdit treats a 'C', 'c' or '*' in the first column as a line comment indicator and the rest of the line is highlighted as a line comment.
|-
|<code>HTML_LANG</code>
|'''HTML'''

HTML is considerably different from other coding languages. With the HTML_LANG keyword, in the wordfile itself, the special characters "<" and optionally "/" can be prepended to any keyword in the wordfile without having to sort lines as is normally required for wordfile color groups. For example, all keywords beginning with "<a" or "</a" should be on the same line as other words beginning with "a". In the same way, all words beginning with "<b" or "</b" should be on the same line as other words beginning with "b", but on a different line from those starting with "<a", "</a", or "a".

This flag also controls HTML tag matching and some other special internal handling for HTML syntax highlighting.

This flag also sets which language type to allow multi-language web-based highlighting; for example, CSS, JavaScript, or PHP embedded in a .html file.
|-
|<code>JAVA_LANG</code>
|'''Java'''
|-
|<code>JSON_LANG</code>
|'''JSON'''

JSON syntax doesn't use keywords but key / value pairs separated by a colon. This flag triggers special internal handling for highlighting the unique JSON syntax. While there are a couple of keywords in the JSON wordfile, most highlighting controls are hard-coded for this language.
|-
|<code>JSCRIPT_LANG</code>
|'''JavaScript'''
|-
|<code>LATEX_LANG</code>
|'''LaTeX'''

With the LaTeX language flag, UltraEdit applies special highlighting to allow words to be appropriately handled and highlighted with the "\", and with consecutive words.

This also allows the keywords to be sorted in the wordfile color group without all of them being on the same line. If the keyword begins with "\" then the second character is used to determine which line the word should be on. For example, all words beginning with "\a" should be on the same line as other words beginning with "\a" or "a". In the same way, all words beginning with "\b" should be on the same line as other words beginning with "\b" or "b" but on a different line from those starting with "\a".
|-
|<code>MASM_LANG</code>
|'''Microsoft Assembly'''
|-
|<code>MARKDOWN_LANG</code>
|'''Markdown'''

Since Markdown's syntax is so drastically different than most other languages, this flag triggers special internal handling for highlighting the unique Markdown syntax. There are no Markdown keywords in the default Markdown wordfile, but each (internally handled) color group is defined so that its colors can be modified as desired in the active theme.

Additionally, embedded HTML syntax highlighting is fully supported in files highlighted as this type.

This flag is required to support Markdown rendering in [[Live preview]].
|-
|<code>MATLAB_LANG</code>
|'''MATLAB'''
|-
|<code>NASM_LANG</code>
|'''Netwide Assembly'''
|-
|<code>PASCAL_LANG</code>
|'''Pascal'''
|-
|<code>PERL_LANG</code>
|'''Perl'''
|-
|<code>PHP_LANG</code>
|'''PHP'''

Note: the .php file extension should be listed in the HTML wordfile to support multi-language embedded PHP highlighting. This will not adversely affect standalone PHP files.
|-
|<code>PLB_LANG</code>
|'''PLB'''
|-
|<code>PUREBASIC_LANG</code>
|'''PureBasic'''
|-
|<code>PYTHON_LANG</code>
|'''Python'''
|-
|<code>RUBY_LANG</code>
|'''Ruby'''
|-
|<code>SQL_LANG</code>
|'''SQL'''
|-
|<code>VBSCRIPT_LANG</code>
|'''VBScript'''
|-
|<code>VB_LANG</code>
|'''Visual Basic'''
|-
|<code>XML_LANG</code>
|'''XML'''
|-
|<code>XSL_LANG</code>
|'''XSL'''
|}

== Comments ==

=== Line comments ===
Line comments can be defined with the following syntax, typically placed on line 1 of the wordfile:

<code>Line Comment = #</code><br>
<code>/Line Comment = #</code> (if on its own line in wordfile)

The above would cause all text following a "#" character to be colored as a comment until the end of the line.

Note: If <code>Block Comment On</code> or <code>Block Comment On Alt</code> is defined in the wordfile, but the <code>Block Comment Off</code>/<code>Block Comment Off Alt</code> is not, the block commenting will stop at the end of the line. This effectively allows block comments to be used as line comments also. (See [[#Block comments|Block comments]] section below)

Line comments must be 5 characters or less. If less than 5 characters and on the first line of the wordfile, the characters must be followed by a space.

You can define a second set of line comments with the following syntax:

<code>Line Comment Alt = //</code><br>
<code>/Line Comment Alt = //</code> (if on its own line in wordfile)

The above would cause all text following "//" to be colored as a comment until the end of the line.

Some languages may require a space follow the line comment character. To facilitate this, the following wordfile definition is available:

<code>Line Comment Num = xCC </code><br>
<code>/Line Comment Num = xCC </code> (if on its own line in wordfile)

...where x specifies the number of characters (1 to 5) and '''immediately''' following are the characters to be used as line comments. In the example above, x would be 3 since the line comment would be "CC " (note the space after "CC").

By default, UltraEdit will treat all characters preceding a comment as valid, but some languages may require that line comments are only valid if they occur after specific characters. To facilitate this, the following wordfile definition is available:

<code>Line Comment Preceding Chars = [a-z]</code><br>
<code>/Line Comment Preceding Chars = [a-z]</code> (if on its own line in wordfile)

In the example above, UltraEdit would only identify line comments if the line comment character immediately follows any character a – z.

You can also use <code>~</code> to specify a negative matching set of characters (i.e., comments are '''not''' valid if they are preceded by the following characters):

<code>Line Comment Preceding Chars = [~a-z]</code><br>
<code>/Line Comment Preceding Chars = [~a-z]</code> (if on its own line in wordfile)

While ranges are helpful for defining line comment preceding characters, they're not required. You can also specify each character, for example <code>Line Comment Preceding Chars = [~abcdefg]</code>

In the example above, UltraEdit would only identify line comments if the line comment character '''does not''' immediately follow any character a – z.

Note: You can use <code>^</code> as an an escape character to define a literal <code>]</code> as a line comment preceding character, for example: <code>Line Comment Preceding Chars = [[^]]</code>. In this example, UltraEdit would only identify line comments if the line comment character immediately follows a <code>[</code> or <code>]</code>.

By default, UltraEdit will treat comment characters in any column as a valid comment, but some languages may require that line comments must start in a specific column(s). To facilitate this, the following wordfile definition is available:

<code>Line Comment Valid Columns = [1-7,10]</code><br>
<code>/Line Comment Valid Columns = [1-7,10]</code> (if on its own line in wordfile)

In the example above, UltraEdit would only identify and highlight line comments if the line comment character occurs at columns 1 through 7, or at column 10.

=== Block comments ===

Block comments can be defined with the following syntax, typically placed on line 1 of the wordfile:

<code>Block Comment On = /* Block Comment Off = */</code><br>
<code>/Block Comment On = /*</code><br>
<code>/Block Comment Off = */</code> (if on its own line in wordfile)

The above would cause all text between "/*" and "*/" to be highlighted as a block comment, even if it spans multiple lines.

Note: If <code>Block Comment On</code> is defined in the wordfile, but the <code>Block Comment Off</code> is not, the block commenting will stop at the end of the line. This effectively allows the block comments to be used as line comments also.

You can define a second set of alternative block comments as well. These can be defined with the following syntax, typically placed on line 1 of the wordfile:

<code>Block Comment On Alt = /* Block Comment Off Alt = */</code><br>
<code>/Block Comment On Alt = /*</code><br>
<code>/Block Comment Off Alt = */</code> (if on its own line in wordfile)

Both block comments and alternate block comments must be no more than 19 characters.

By default, ULtraEdit will end block comment highlighting at the next block comment close string in the source code. To force UltraEdit to explicitly match all block comment start strings with all block comment end strings, use the <code>NestBlockComments</code> directive as described above.

== Strings ==

By default, in any syntax highlighted file, UltraEdit will highlight any text following a double quote (") or single quote (') as a string. The string highlighting occurs until a matching string character of the same type.

You can override the string characters in the wordfile, or disable them completely with the <code>Noquote</code> directive on line 1. To set custom string characters, use the following syntax, typically placed on line 1 of the wordfile:

<code>String Chars = "</code><br>
<code>/String Chars = "</code> (if on its own line in wordfile)

In the above, only text following " would be highlighted as a string. No more than 2 string characters can be defined.

If you have 2 different string characters set (or are using the defaults) and want a different highlighting color for both types of strings, you can include the string character in one of the color groups in a line by itself, then configure the color for the string's color group in your theme. This will override the default string highlighting color in your them. For example:

<code>/L1"My language" Line Comment = // Block Comment On = /* Block Comment Off = */ String Chars = '"</code><br>
<code>/C1"Special strings"</code><br>
<code>"</code>

In the above, any strings encapsulated by " would be highlighted with the color set for the "Special strings" color group, whereas any strings encapsulated by ' would be highlighted with the regular color for strings.

UltraEdit supports multi-line string highlighting, however you can configure this. By default, UltraEdit will highlight strings spanning multiple lines. To disable this, add the <code>DisableMLS</code> directive to line 1 of the wordfile.

=== String literal prefix ===

You can define a string prefix character for string literals in the wordfile as well. For example, in C# the string literal is defined by an "@" sign preceding the string. To set the string literal character, use the following syntax, typically placed on line 1 of the wordfile:

<code>String Literal Prefix = @</code><br>
<code>/String Literal Prefix = @</code> (if on its own line in wordfile)

In the example above, the "@" before the string indicates that a backslash is not an escape character which is useful for encapsulating file paths in strings. To illustrate, the following two statements are equivalent:

"c:\\data\\"<br>
@"c:\data\"

The only special character in a @"..." literal is the double quote ("), which is simply doubled if you need to embed one.

== Escape characters ==

Most languages support an escape character (usually "\") for overriding string characters (and other characters with special meanings as well). You can define the escape character using the following syntax, typically placed on line 1 of the wordfile:

<code>Escape Char = \</code><br>
<code>/Escape Char = \</code> (if on its own line in wordfile)

== File extensions / names ==

=== File extensions ===

In most cases, UltraEdit uses a file's extension to determine which wordfile/language to use for its syntax highlighting. The file extensions for a particular wordfile / language are set in the wordfile, typically at the end of line 1, using the following syntax with each file extension separated by a space:

<code>File Extensions = C CPP CC CXX H HPP AWK</code><br>
<code>/File Extensions = C CPP CC CXX H HPP AWK</code> (if on its own line in wordfile)

File extensions are '''not''' case sensitive. When checking a file's extension, UltraEdit will only evaluate the characters '''after''' the last dot in the file's name. A maximum of 97 single-byte characters are supported for this setting.

You can set a default syntax highlighting language by adding an asterisk (*) to the file extensions definition. This would force all files not matching a file extension in any other wordfile to use this wordfile / language for syntax highlighting. This includes new unsaved files and files without an extension.

=== File names ===

In some cases, you may want to assign a wordfile / language based upon the full file name. This can be set typically on line 1 of the wordfile, use the following syntax with each file name separated by a space:

<code>File Names = config myfile.xml</code><br>
<code>/File Names = config myfile.xml</code> (if on its own line in wordfile)

In the example above, any file named "config" or "myfile.xml" would be highlighted with this wordfile.

A maximum of 125 single-byte characters are supported for this setting. Names including spaces may not be used.

== Shebang parsing ==

Perl, XML, and other script source files are frequently saved without an extension. To ensure proper, automatic highlighting of these, if the file's extension does not match any of the existing wordfiles' definitions, UltraEdit will search for a language marker / shebang in the '''first line''' of the source file. The following defaults are used:

{|
!Language
!Language identifier (must be in line 1)
|-
|Perl
|#!/usr/bin/perl
|-
|PHP
|#!/bin/php
|-
|Python
|#!/bin/python
|-
|XML
|<?xml
|}

Other script files (especially Unix shell scripts) often use some form of the [https://en.wikipedia.org/wiki/Shebang_(Unix) shebang line] to identify the language or script to be used, for example "#!/bin/ksh". To support these, you can extend the internal functionality with the language marker setting using the following syntax on a separate line in the wordfile:

<code>/LanguageMarker = #!/bin/ksh</code>

You can also set multiple flags using the following syntax:

<code>/LanguageMarker = "ksh" "sh" "csh"</code>

In the above example, any files with the following lines would be matched and the syntax highlighting of the wordfile would be applied:

<pre>#!/bin/ksh
#! /usr/bin/sh
#!/usr/local/bin/csh</pre>

== Function list strings ==
In order to populate the [[Function list]], UltraEdit uses function strings defined in the wordfile. Function strings are regular expressions used to match and identify functions is source code. (They don't necessarily have to be used for functions; they can be used for whatever you wish to list in the function list.) Function listing is '''not''' case sensitive, regardless of whether the <code>Nocase</code> directive is in the wordfile.

Historically UltraEdit has used its legacy [[Regular expressions|regular expressions]] syntax for function strings. However, you can specify that function strings will use [[Perl regular expressions]] syntax (recommended and used by most modern wordfiles) by adding the following to the top portion of the wordfile on its own line:

<code>/Regexp Type = Perl</code>

The recommended method for creating or modifying function strings is through the [[Modify groups]] dialog, accessible by right-clicking in the function list and selecting "Configuration." If modified through this GUI, functions can be arranged and displayed in a hierarchical tree-style view, with the function strings being written out to the wordfile automatically. When written out automatically, these function strings will look similar to the following:

<code>/TGBegin "Functions"</code><br>
<code>/TGFindStr = "^(?!if\b|else\b|while\b|[\s*])(?:[\w*~_&]+?\s+){1,6}([\w:*~_&]+\s*)$[^);]*$[^{;]*?(?:^[^\r\n{]*;?[\s]+){0,10}\{"</code><br>
<code>/TGBegin "Parameters"</code><br>
<code>/TGFindStr = "\s*([^,]+)"</code><br>
<code>/TGFindBStart = "$"</code><br>
<code>/TGFindBEnd = "$"</code><br>
<code>/TGEnd</code><br>
<code>/TGBegin "Variables"</code><br>
<code>/TGFindStr = "^[ \t]*((?:static[ \t*]+)?(?:const[ \t*]+)?(?:(?:un)?signed[ \t*]+)?(?:long[ \t*]+)?[a-z0-9_]+[ \t*&]+[a-z0-9[\]_]+);"</code><br>
<code>/TGFindBStart = "\{"</code><br>
<code>/TGFindBEnd = "\}"</code><br>
<code>/TGFindStr = "^[ \t]*((?:static[ \t*]+)?(?:const[ \t*]+)?(?:(?:un)?signed[ \t*]+)?(?:long[ \t*]+)?[a-z0-9_]+[ \t*&]+[a-z0-9[\]_]+)[ \t]*=.+;"</code><br>
<code>/TGFindBStart = "\{"</code><br>
<code>/TGFindBEnd = "\}"</code><br>
<code>/TGEnd</code><br>
<code>/TGEnd</code>

Since these function strings are created automatically by the editor, it is not recommended nor supported to modify them directly. However, you can create your own function strings and manually add them to the wordfile using the legacy function string syntax.

=== Legacy function strings ===

To use legacy function strings, add a line similar to the following with the regular expression that matches functions in your source files:

<code>/Function String = "^[ \t]*function[ \t]([^\(])+"</code>

Up to 6 function strings are supported, and each subsequent string should be on its own line with a sequential number starting with 1 for the second function string. For example:

<code>/Function String = "<regexp1>"</code><br>
<code>/Function String 1 = "<regexp2>"</code><br>
<code>/Function String 2 = "<regexp3>"</code><br>
<code>/Function String 3 = "<regexp4>"</code><br>
<code>/Function String 4 = "<regexp5>"</code><br>
<code>/Function String 5 = "<regexp6>"</code><br>

The regular expression you provide for the function string must be encapsulated in double quotes and should tag (via the regular expression's tagging syntax) the portion of the regular expression that will match the function name, as this is what will be returned in the function list. In the real example above using the regular expression '''<nowiki>[ \t]*function[ \t]([^\(])+[ \t]+</nowiki>''', any preceding whitespace, the word "function," any trailing whitespace after the word "function", and any number of characters that are not "(" would be matched, but only the last portion would be returned in the function list as it is the only portion that is tagged via parentheses.

=== Showing commented functions ===

By default, functions inside of comments (whether line or block comments) aren't shown in the function list. If you want functions inside of commented text to be displayed in the function list, add the following setting to the wordfile on the top line:

<code>Strip Comments = False</code> or <code>Strip Comments = No</code><br>
<code>/Strip Comments = False</code> or <code>/Strip Comments = No</code> (if on its own line in wordfile)

== Delimiters ==

Delimiters are defined as any non-word character. UltraEdit has a default set of built-in delimiters, but you can override these and define your own delimiters on a per-wordfile basis. This is useful if you have a non-standard coding language or some sort of non-grammar-based syntax that may not use standard grammar rules. You can also use this if the language uses what are typically non-word characters as word characters.

To specify the delimiters, add a new line similar to the following to the wordfile:

<code>/Delimiters = ~!@$%^&*()_-+=|\/{}[]:;"'<> ,.?/</code>

If the delimiters setting does not exist in the wordfile, UltraEdit's built-in defaults are used.

With the exception of the "<" and ">" characters in HTML, a character that is a delimiter cannot also be part of a word. So, for example, you cannot specify keywords including the @ symbol and list @ as a delimiter in the wordfile. However, a delimiter ''can'' be included at the '''beginning''' of a keyword and be highlighted accordingly, but delimiters cannot be included in the middle of keywords. If a "compound" keyword, or a keyword that includes a delimiter character between two sections is desired, the delimiter character would need to be removed from the delimiters list in the wordfile, or the two portions of the keyword would need to be defined separately to highlight correctly.

It is possible to assign the delimiter characters to the color sections. If you have a character that is a delimiter, such as a '+', and you wish this to be colored with one of the keyword color groups you may add this character to a line of its own under the color section, and this will retain its recognition as a delimiter ''and'' be highlighted with the appropriate color.

== Delimiter overrides ==

For some languages, it may be desirable to override delimiters (i.e., word boundaries) for selecting and Ctrl + Left / Right Arrow. For example, in PHP files you may want the leading "$" to be selected when double-clicking a variable name like <code>$my_var</code>, but you would ''not'' want this behavior in other plain text files. To facilitate this, add a new line similar to the following to the wordfile:

<code>/Word Select Include = $</code>

You can add as many non-word characters as you'd like for this setting. Any character specified here (including tab / space) will be included in a selection when double-clicking on a word, and will be skipped over when using Ctrl + Left / Right Arrow to reposition the caret in the file.

== Indent / unindent strings ==

UltraEdit provids automatic indentation on a per-language basis to indent or unindent a line when the indent / unindent string is typed. By default, UltraEdit uses "{" and "}" as indent and unindent strings, respectively. To override this and specify your own indent and unindent strings, use the following syntax on separate lines in the wordfile:

<code>/Indent Strings = "{"</code><br>
<code>/Unindent Strings = "}"</code>

Any number of words/strings may be specified in quotes (each word or string must be in a separate set of quotes).

When an indent string is typed in a file being highlighted by the wordfile, an indent will be added to the line. The indent value (tab/spaces, and number thereof) is in accordance with your indentation settings in [[Settings:Editor:Word wrap/tab settings|Settings » Editor » Word wrap/tab settings]]. The indentation is the next tab stop over from the indentation of the preceding line (same as if the Tab key was pressed).

When an unindent string is typed in a file being highlighted by the wordfile, an indent will be removed from the line.

When reindenting existing text (see [[Reindent selection]]), you may want to avoid indenting certain lines that are commented out or are compiler directives, for example. You can prevent this by adding indentation ignore strings to the wordfile on a separate line using the following syntax:

<code>/Ignore Strings SOL = "#" "//"</code>

Any number of words/strings may be specified in quotes (each word or string must be in a separate set of quotes). For the word to match it must be the '''first''' character(s) of the line. If a line does begin with one of these ignore strings, it would not be indented, and the indenting of the next line would continue on as if this line didn't exist.

== Code folding strings ==

UltraEdit provides code folding on a per-language basis. By default, UltraEdit uses "{" and "}" as open fold and close fold strings, respectively. To override this and specify your own open / close fold strings, use the following syntax on separate lines in the wordfile:

<code>/Open Fold Strings = "{"</code><br>
<code>/Close Fold Strings = "}"</code>

Alternatively, if you want code folding of the source language to be based on indentation rather than strings, add the <code>EnableCFByIndent</code> directive to line 1 of the wordfile. This will override any open/close fold strings set in the wordfile.

In some cases, you may want the fold logic to ingore lines containing a certain string. To facilitate this, add the following line to the wordfile:

<code>/Ignore Fold Strings = "Exit Function"</code>

Note that there are no default ignore fold strings.

UltraEdit also allows you to specify open and close fold strings that are recognized in block comments only via the following lines in the wordfile:

<code>/Open Comment Fold Strings = "#Region"</code><br>
<code>/Close Comment Fold Strings = "#End Region"</code>

== Brace matching strings ==

UltraEdit provides brace matching (and the ability to jump to / select matching brace) on a per-language basis. UltraEdit uses the standard brace pairs as defaults: "(" and ")", "{" and "}", and "[" and "]". However, you can override these by using the following syntax on separate lines in the wordfile:

<code>/Open Brace Strings = "If" "For" "Select Case" "Else" "ElseIf"</code><br>
<code>/Close Brace Strings = "End If" "Next" "End Select" "End If" "ElseIf"</code>

It's important to note that, unlike code folding and indent/unindent strings, brace matching strunks '''must''' be positionally matched in their lists. So in the above example, "If" will only brace match to "End If," "For" will only brace match to "Next," etc. "If" will '''not''' brace match to "Next", because "If" occurs '''first''' in the open brace string list while "Next" occurs '''second''' in the close brace string list. Because of this, there may be valid cases where there are duplicate open or close brace strings.

== Marker characters ==

There may be instances where all text between two characters should be highlighted. UltraEdit facilitates this via marker characters, which mark the first and last part of a string that UltraEdit will highlight. All characters between the two characters are highlighted including the marker characters themselves. To add marker characters, add the following to the wordfile on its own line:

<code>/Marker Characters = "ab" </code>

...where "a" is the first character of the string to be highlighted and "b" is the last character. All characters between "a" and "b" will be highlighted, including spaces. If the line is a comment or string, marker characters are ignored. Alphanumeric characters may be used, but whitespace characters (space/tab) are not supported as marker characters.

Marker character highlighting does not span multiple lines; the highlighting will end either at the first occurrence of the closing marker character or the end of the line, whichever comes first.

You can define up to 4 pairs of characters to highlight between as in:

<code>/Marker Characters = "abcdefgh"</code>

...where strings starting with "a" and ending with "b" are highlighted as are strings starting with "c" and ending with "d", etc.

You must also configure the color of the highlighted string by adding the two marker characters under the appropriate color group section as if they were a word such as "ab", "cd", etc. See the [[#Keyword color groups|keyword color groups]] section. Marker character highlighting will not work if they're not added to a color group.

== Keyword color groups==

Keyword color groups comprise the bulk of most wordfiles. These sections are simply collections of string-based keywords that are highlighted within source files. UltraEdit supports up to 20 color groups. The contents of color groups can be arbitrarily determined by the user, although in most cases color groups are used to contain similar types of the language's keywords (for example, "Built-in functions," "Operators," "Basic keywords," etc).

Each color group's first line must consist of a "/C#" directive to designate the color group. The "#" must be a unique number in sequential order, starting with 1. Additionally, you can specify a name for the color group in quotes immediately following the "/C#" directive. While the name is optional, it is highly recommended to provide this as it is used to label the language's color group setting in the theme. The name can be up to 24 characters.

Keywords within a color group '''must''' be sorted alphabetically. Multiple keywords starting with the same character may be on one line, as long as they are separated by a space and sorted alphabetically. By default, keyword highlighting is case sensitive, but you can make highlighting case-insensitive by adding the <code>Nocase</code> directive to line 1 of the wordfile.

If the language is case sensitive, the letter "A" is different from "a" and so words starting with "A" '''must''' be on a different line than words starting with "a". Otherwise, "A" and "a" are seen as the same letter and keywords beggining with either of these should be grouped / sorted as such.

Examples:

<code>/C1"Basic keywords"</code><br>
<code>auto</code><br>
<code>break</code><br>
<code>case const continue</code><br>
<code>default defined do</code><br>
<code>else extern</code><br>
<code>for</code><br>
<code>goto</code><br>
<code>if </code><br>
<code>register return</code><br>
<code>signed sizeof static switch</code><br>
<code>typedef</code><br>
<code>union unsigned</code><br>
<code>void volatile</code><br>
<code>while</code><br>
<code>/C2"Data Types"</code><br>
<code>bool byte</code><br>
<code>char class</code><br>
<code>decimal delegate double</code><br>
<code>enum</code><br>
<code>float</code><br>
<code>int interface</code><br>
<code>long</code><br>
<code>object</code><br>
<code>sbyte short string struct</code><br>
<code>uint ulong ushort</code>

=== Keywords beginning with a sub-string ===

Many languages include support for a predefined substring, however the rest of the word is not known or is determined by the programmer as (s)he is writing the code, for example, variables beginning with "$" in PHP. Because variable names are completely arbitrary, it is not possible to highlight them with a string-based syntax. To facilitate these cases, UltraEdit provides sub-string support. The sub-strings must be defined within a color group, as with any other set of keywords, however the line containing the sub-strings should start with "** " and all sub-strings should be on the same line, sorted alphabetically. For example:

<code>/C3"Variables"</code><br>
<code>** $ aaa bbb</code>

In this example, all words in the source file beginning with "$", "aaa", or "bbb" would be highlighted as the "Variables" color group.

=== Keywords starting with "/" ===

As UltraEdit uses '/' as a command character within the wordfile, keywords that begin with this character require special handling. To highlight words beginning with a '/' the line should begin with '// ' followed by the keywords themselves, sorted alphabetically. For example:

<code>/C4"Some / keywords"</code><br>
<code>// /akeyword /mykeyword /zkeyword </code>

== IntelliTips markers ==
Special markers are available in the wordfile to identify keyword groups for IntelliTips support. These markers are added on the same line as a color group declaration (e.g., <code>/C1"Functions" STYLE_FUNCTIONS</code>). Currently the use of the style elements is limited but may be expanded in the future. A complete list of style elements follows:

{|
!Marker
|-
|<code>STYLE_KEYWORD</code>
|-
|<code>STYLE_STATEMENT</code>
|-
|<code>STYLE_EVENT</code>
|-
|<code>STYLE_OPERATOR</code>
|-
|<code>STYLE_EXTENSION</code>
|-
|<code>STYLE_FUNCTION</code>
|-
|<code>STYLE_TAG</code>
|-
|<code>STYLE_ATTRIBUTE</code>
|-
|<code>STYLE_METHOD</code>
|-
|<code>STYLE_ELEMENT</code>
|-
|<code>STYLE_REGEX</code>
|-
|<code>STYLE_VARIABLE</code>
|-
|<code>STYLE_COMMAND</code>
|}

<div class="idm-see-also">
See also:
* [[Syntax highlighting]]
* [[Add syntax highlighting languages]]
* [[Settings:Editor display:Syntax highlighting|Settings » Editor display » Syntax highlighting]]
</div>

Activating your license key

2023-03-30T11:04:41Z

Idmadmin:

[[Category:General]]
You can activate UltraEdit / UEStudio and unlock trial mode by entereing your '''license ID''' and '''password''' into the activation dialog. (You receive your license ID and password via email after placing a successful order online, over the phone, or via purchase order.)

[[File:Activate dialog.png|alt=screenshot of license activation dialog]]

You can access the activation dialog by any of the following methods:

* By clicking the "Enter license key" button in the trial dialog
* By clicking the "Enter license key" option in the [[:Category:File_menu|File menu]]
* By clicking the "Enter license key" option in the "Support" drop down menu

An Internet connection is required to activate your license. If you do not have an Internet connection and need an [[#Offline activation|offline activation]], you must [https://www.ultraedit.com/company/contact-us.html#contactForm contact IDM support] to obtain offline activation codes.

After entering your license ID and password, click the '''Activate''' button to finalize the activation and unlock trial mode. After your license ID and password have been validated, you should see a dialog indicating that the activation was successful:

[[File:Activate dialog successful.png|alt=screenshot of successful activation message]]

'''Please note:''' If you purchased an [https://www.ultraedit.com/products/idm-all-access.html IDM All Access subscription license], you will only need to activate your license one time. Once one IDM application has been activated on the system with the All Access license, all other IDM applications on that system will be automatically activated as well.

If necessary, click the '''Support options''' button and then the '''Proxy''' button to input proxy server information. For most users this should not be necessary as all IDM applications will use the proxy settings specified for Internet Explorer, if configured, on the system.

[[File:Activate dialog proxy.png|alt=screenshot of license activation dialog's proxy options]]

==Offline activation==
If online activation is not possible because there is no Internet connection available, you will need to use the offline activation dialog to register. To access the offline activation options, press Ctrl + Shift, then click the '''Activate''' button in the Activation dialog. This will open the offline activation dialog as shown below.

[[File:Activate dialog offline.png|alt=screenshot of offline activation dialog]]

The '''License ID''' and '''Password''' fields must be entered as provided in your license email. The '''User Code 1''' and '''User Code 2''' fields will be pre-populated with numeric values. You must call or email this information to [mailto:support@ultraedit.com support@ultraedit.com] in an email, and we will reply with the value to enter into the '''Authorization Code 1''' field.

'''Please note:''' If any values other than those provided by IDM Computer Solutions, Inc. are entered here, this will cause the values in the user code fields to be recalculated the next time the offline activation dialog is opened. Please do not enter any values except those provided by our support team.

Activating your license key

2023-03-30T11:04:09Z

Idmadmin:

Command palette

2022-08-23T13:48:58Z

Idmadmin:

[[Category:General]]
<div class="idm-shortcut">
Shortcut: <span>Ctrl+Shift+P</span>
</div>

[[File:UltraEdit command palette.png|right|384px|alt=screenshot of command palette in UltraEdit|Command palette in UltraEdit]]

The '''command palette''' provides quick access to all commands available in UltraEdit / UEStudio, with a filter for searching commands by name. You can also directly invoke commands from it. In addition to its shortcut, you can invoke the command palette by clicking its icon in the right of the ribbon bar menu, next to the help icon.

When the command palette opens, you can immediately begin typing to search / filter commands. Only those commands matching your search will be shown.

The command palette includes both '''commands''' (i.e., something that executes an action) and '''settings'''. Commands are sorted alphabetically and listed at the top of the results. The location of the command is shown in the second column and keyboard shortcuts for the command (if they exist) are shown in the third column. Settings matching the filter are listed alphabetically underneath commands. Once you've selected a command you wish to use you can press '''Enter''' or click on it to invoke that specific command or jump to the referenced setting in [[:Category:Settings|Settings]].

== Launch custom macros, tools, scripts, templates ==
You can launch your custom macros, tools, scripts, and templates directly from the command palette. Just type all or part of the item's name, or if you're not sure, type "play" or "insert" or "tool" to see a list of available items. Press enter to insert or play the selected item.

== Favorites / recently used ==
You can click on the star to the left of a command or setting to add it to your favorites list which appears at the top of the command palette. Click the star again to remove a command or setting from the favorites list.

You can access the last five recently used commands directly below the favorites. If you wish to clear the command history, click the '''X''' to the right of the "Recently used" heading.

== Quick open from history ==
The command palette maintains a history of all files you've opened, similar to a web browser's browing history. This allows you to quickly re-open a file without having to remember the time or exact location from where you opened it. To open a file from the history, with the command palette open type <strong>\</strong> to enter history mode. Begin typing all or part of the path / name of the file you wish to open. You'll see results filtered into the command palette. Once you see the file you wish to open, select it and press <strong>Enter</strong> to immediately open it. This feature supports local, network, and (S)FTP files.

If you wish to clear the open history, click the '''X''' to the right of the "Search recently opened files" heading.

== Open files ==
The command palette also functions as a quick open for local files. To open files, with the command palette open, begin typing the path beginning with the drive letter. You'll see auto-suggestions appear in the command palette filtered based upon the path you're typing. Press <strong>Tab</strong> to auto-complete the path with the selected item. If a full file path is entered, press '''Enter''' to open it. You can also use the arrow keys to move through the list of filtered results, then press '''Enter''' on the selected result to open it.

You can use the asterisk (*) as a wildcard in the command palette to open multiple files. You can also use relative paths (relative to the active file) and traverse parent directories with "..".

Multi-caret editing

2022-06-30T20:25:51Z

Idmadmin:

[[Category:General]]
[[File:UltraEdit multi-caret.png|right|alt=screenshot of UltraEdit's multi-caret editing feature]]
Multi-caret editing allows you to activate two or more non-contiguous insertion points (identified by the blinking caret) within the active file. Each caret acts and operates independently of any other caret, and most edit operations you execute are performed in all caret locations simultaneously. This is an optional feature and can be disabled completely under [[Settings:Editor display:Cursor / caret|Settings » Editor display » Cursor / caret]].

Multi-caret editing is not supported in [[column mode]] or [[hex edit]] mode.

==Multi-caret via mouse==

===Creating multiple carets via mouse===
Regardless of how many carets are active, you can add a new caret by holding the <strong>Ctrl</strong> key and <strong>left-mouse-button clicking</strong> at any location within the file where you can normally click to reposition the caret, including beyond a line end if "Allow positioning beyond line end" is set under [[Settings:Editor display:Cursor / caret|Settings » Editor display » Cursor / caret]]

===Adding a new caret to an existing set via mouse===
If you have created a caret set and released <strong>Ctrl</strong> and wish to add a new caret to the active set, then, prior to clicking anywhere else in the file, you can press <strong>Ctrl</strong> again and click in a new position to add a new caret to the existing set.

===Removing a caret via mouse===
You may remove a caret from the active set by holding <strong>Ctrl</strong> and clicking on the caret you wish to remove. No other carets are affected. You can also undo the last-added caret by pressing <strong>Shift</strong> + <strong>Alt</strong> + <strong>Z</strong>.

===Clearing all multiple carets via mouse===
To remove multiple carets, you can release <strong>Ctrl</strong> and then click elsewhere in the file (not on an active selection). All carets will be removed and the clicked position will become the only active caret. Alternatively, you can press <strong>Ctrl</strong> + <strong>Shift</strong> + <strong>/</strong> to remove all but the primary caret.

==Multi-select via mouse==

Multi-select is a component of multi-caret in that it allows you to select multiple non-contiguous sections of data.

===Creating multiple selections via mouse===
Regardless of how many selections are active, you can add a new selection by holding the <strong>Ctrl</strong> key and selecting any text within the file where you can normally do so.

The selection can be created via:

* Click-and-drag (standard selection)
* Double-/triple-click
* Click on line number

===Adding a new selection to an existing set via mouse===
If you create a set of multiple selections and have released <strong>Ctrl</strong> and wish to add a new caret / selection to the active set, then, prior to clicking anywhere else in the file, you can press <strong>Ctrl</strong> again and select new text to add to the existing set.

===Removing a selection via mouse===
You can remove a selection from the active set by holding <strong>Ctrl</strong> and clicking anywhere on the selection you want to remove. No other selections are affected. No caret is left where you clicked.

===Clearing all multiple selections via mouse===
To remove multiple selections, you must release <strong>Ctrl</strong> and then click elsewhere in the file (not on an active caret / selection). All carets will be removed and the clicked position will become the only active caret.

==Multi-select strings==

===Select all occurrences of string===
You can use multi-caret editing to quickly select all occurrences of a word regardless of its position in the file. To do this, make your selection and press '''Ctrl ,''' (comma). If no selection exists, the editor will select all occurrences of the word under the active caret.

===Select next occurrence of string===
To select the next occurrence of the selected string, press '''Ctrl ;''' (semicolon). If no selection exists, the editor will first select the word under the caret, and subsequent keypresses will select subsequent occurrences.

===Select all Find matches===
You can also load all matches from a search into multiple selections. To do this, first do a [[Quick find]] or [[Find]] with "Highlight all items found" enabled. After the matched items are highlighted, press '''Ctrl ,''' (comma) to load them into selections. When combined with [[Perl regular expressions]], this provides you with a very powerful way of selecting multiple different strings all at once.

==Movement of multi-carets==
With a caret / selection set active, you can reposition them as you normally would by using basic movement keys on the keyboard. For example, pressing <strong>Left Arrow</strong> will move all carets to the left 1 position. Pressing <strong>Down Arrow</strong> will move all carets down 1 line. Pressing the <strong>Home</strong> key will move all carets to the beginning of each line. <strong>Page Up</strong> will move all carets up 1 page. Any movement which would cause the carets to converge into a unified location will result in a single caret. Examples include <strong>Ctrl + Home</strong>, <strong>Ctrl + End</strong>, <strong>Ctrl + Shift + Home</strong>, <strong>Ctrl + Shift + End</strong>, etc.

==General editing with multi-caret==
Once you have a set of multi-carets and / or selections, you can do any number of general editing operations.

'''Copy/Cut'''<br>
All selections are copied or cut into the clipboard. Non-contiguous selections are separated on the clipboard by a line terminator.

If "Enable copy/cut of current line with no selection active" is set under [[Settings:Editor:Miscellaneous|Settings » Editor » Miscellaneous]], then all lines where a non-selection caret is active are copied / cut.

'''Paste'''<br>
All selections are overwritten with whatever data is on the clipboard, with '''one notable exception:''' if the number of line endings on the clipboard equals the number of active carets in the file, then each individual line on the clipboard will be inserted into each individual caret/selection, in respective order. This is helpful in cases where you wish to copy a plain text list into a pre-formatted code container, for example.

'''Select'''<br>
Using <strong>Shift</strong>, you can select from each caret at once just as you would with a single caret.

'''Backspace / delete'''<br>
All backspace / delete functionality is available and operates independently upon each caret.

Keyboard shortcuts

2022-04-14T19:28:46Z

Idmadmin: /* Toggles */

[[Category:General]]
UltraEdit / UEStudio provides default keyboard shortcuts for many commonly used commands and features. You can add, remove, or change keyboard shortcuts in [[Settings:Key mapping|Settings » Key mapping]].

You can see all key mappings defined on your system by going to [[Settings:Key mapping|Settings » Key mapping]] and clicking the "Show key mapping in editor" button.

The default keyboard shortcuts are grouped below.

==Editing text==
{|
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl A</span></div>
|Select all
|Selects all text in active file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl ;</span></div>
|Select next occurrence
|Selects next occurrence of selected word (creating [[multi-caret editing|multiple selections]]) or word under caret if no selection exists
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl ,</span></div>
|Make selections
|Selects all occurrences of selected word or word under caret if no selection exists (creating [[multi-caret editing|multiple selections]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift Z</span></div>
|Remove last caret
|Removes last-created caret or selection ([[multi-caret editing]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift /</span></div>
|Remove all carets
|Removes all active carets ([[multi-caret editing]]) except for last-created caret
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl J</span></div>
|Join lines
|[[Join lines]], which joins active line to the next one (or all selected lines)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl E</span></div>
|Delete line
|Deletes line caret is on
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F11</span></div>
|Delete to start of line
|Deletes from caret to start of line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F12</span></div>
|Delete to end of line
|Deletes from caret to end of line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift D</span></div>
|Duplicate line
|Duplicates the active line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Z</span></div>
|Undo
|Undoes last action if possible
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Y</span></div>
|Redo
|Reverses last undo action if possible
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Backspace</span></div>
|Delete previous word
|Deletes the word preceding the caret, or to beginning of word if the caret is in the middle of a word
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Delete</span></div>
|Delete next word
|Deletes the word following the caret, or to end of word if the caret is in the middle of a word
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl /</span></div>
|Trim trailing spaces
|Deletes all trailing spaces on all lines in active file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl \</span></div>
|Trim leading spaces
|Deletes all leading spaces on all lines in active file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl T</span></div>
|Reformat paragraph
|[[Reformat paragraph|Reformats the current paragraph]] or selected text
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F5</span></div>
|To lowercase
|Converts selected text or letter next to caret to lowercase
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F5</span></div>
|To uppercase
|Converts selected text or letter next to caret to uppercase
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F5</span></div>
|Capitalize
|Capitalizes letter next to caret or first character of each word in selected text
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift F5</span></div>
|Invert case
|Inverts case of letter next to caret or all characters in selected text
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl K</span></div>
|Spell check
|Invokes the [[Spell check|spelling checker]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl I</span></div>
|Insert literal character
|Inserts a [[Insert literal character|literal character]] at caret position
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl D</span></div>
|Hex insert / delete
|[[Hex insert/delete|Insert or delete characters]] in hex edit mode
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift A</span></div>
|Inserts ä character
|(As appropriate for active file's encoding)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift A</span></div><br>(Caps Lock on)
|Inserts Ä character
|(As appropriate for active file's encoding)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift O</span></div>
|Inserts ö character
|(As appropriate for active file's encoding)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift O</span></div><br>(Caps Lock on)
|Inserts Ö character
|(As appropriate for active file's encoding)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift U</span></div>
|Inserts ü character
|(As appropriate for active file's encoding)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift U</span></div><br>(Caps Lock on)
|Inserts Ü character
|(As appropriate for active file's encoding)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift S</span></div>
|Inserts ß character
|(As appropriate for active file's encoding)
|}

==Clipboard operations==
{|
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl C</span></div>
|Copy
|Copies text from active file into the clipboard
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Insert</span></div>
|Copy
|Copies selected text (also in [[SSH / telnet console|SSH / telnet client window]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl X</span></div>
|Cut
|Cuts text from active file into the clipboard
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift Delete</span></div>
|Cut
|Cuts text from active file into the clipboard (also in [[SSH / telnet console|SSH / telnet client window]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl V</span></div>
|Paste
|Pastes text from the clipboard into the active file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift Insert</span></div>
|Paste
|Pastes clipboard contents (als in [[SSH / telnet console|SSH / Telnet client window]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift C</span></div>
|Copy and append
|Copies selected text and appends it onto the clipboard
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift X</span></div>
|Cut and append
|Cuts selected text and appends it onto the clipboard
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift V</span></div>
|Paste and copy
|Pastes text from the clipboard into the active file while simultaneously moving original selection to clipboard
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl 0-9</span></div>
|Select clipboard
|Selects Windows clipboard (0) or one of the user [[clipboards]] (1 - 9)
|}

==File operations==
{|
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl N</span></div>
|New
|Creates a new file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl O</span></div>
|Open
|Opens [[file open]] dialog to open an existing file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Q</span></div>
|Quick open
|Opens [[Quick open]] dialog for quickly opening files without file open dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F4</span></div>
|Close
|Closes active file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift F4</span></div>
|Close all files
|Closes all open files
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl S</span></div>
|Save
|Saves the active file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F12</span></div>
|Save
|Saves all open files
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F12</span></div>
|Save as
|Saves the active file as a new file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl P</span></div>
|Print
|[[Print|Prints]] the active file
|}

==Search / goto operations==
{|
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F</span></div>
|Quick find / Find
|Opens [[Quick find]]; Hold '''Ctrl''' and press '''F''' twice to open regular [[Find]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F3</span></div>
|Find
|Opens [[find]] (bypassing [[Quick Find]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl R</span></div>
|Replace
|Opens [[replace]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift F</span></div>
|Find in files
|Opens [[find in files]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl .</span></div>
|Highlight all
|Highlights all occurrences of selected text, or word under caret if no selection exists
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F3</span></div>
|Find next
|Searches forwards for last find string
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F3</span></div>
|Find previous
|Searches backwards for last find string
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift F3</span></div>
|Select to next occurrence
|Selects all text from caret through next occurence of find string
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl G</span></div>
|Goto
|[[Goto|Goes to]] the specified line (or hex address)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl B</span></div>
|Select to matching brace
|Selects to matching brace from next (,[,{ to closing },],) or other brace character as defined in the [[wordfiles|wordfile]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F2</span></div>
|Toggle bookmark
|Toggles [[Bookmarks|bookmark]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F2</span></div>
|Go to bookmark
|Jumps to next [[Bookmarks|bookmark]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift F2</span></div>
|Select to next bookmark
|Selects all text from caret through next [[Bookmarks|bookmarked]] line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift Alt F2</span></div>
|Select to previous bookmark
|Selects all text from caret through previous [[Bookmarks|bookmarked]] line
|}

==Caret / view positioning==
{|
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl 🠕</span></div>
|Scroll view up
|Scrolls view up one line while maintaining current caret position
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl 🠗</span></div>
|Scroll view down
|Scrolls view down one line while maintaining current caret position
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift Mouse Wheel</span></div>
|Scrolls horizontally
|Tracks horizontal scroll bar
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt 🠖</span></div>
|Next Paragraph
|Positions caret at first non-space character of next paragraph
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt 🠔</span></div>
|Previous Paragraph
|Positions caret at first non-space character of current paragraph (if positioned mid-paragraph) or previous paragraph
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Page Up</span></div>
|Top of window
|Moves caret to first visible line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Page Down</span></div>
|Bottom of window
|Moves caret to last visible line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl -</span></div><br>(numeric keypad only)
|Hide / show selection
|[[Hide/show_selection|Hides or shows]] active code folding node, or active line if in non-highlighted file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl +</span></div><br>(numeric keypad only)
|Collapse all
|Collapses all code folding nodes
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl *</span></div><br>(numeric keypad only)
|Expand all
|Expands all hidden / collapsed lines
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt -</span></div><br>(numeric keypad only)
|Scroll to top
|Positions active line to top of window
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt +</span></div><br>(numeric keypad only)
|Scroll to bottom
|Positions active line to bottom of window
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt *</span></div><br>(numeric keypad only)
|Scroll to center
|Positions active line to center of window
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt 5</span></div><br>(numeric keypad only)
|Scroll to center
|Positions active line to center of window
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl 1</span></div><br>(numeric keypad only)
|End of previous word
|Positions caret at the end of the previous word
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl 2</span></div><br>(numeric keypad only)
|End of next word
|Positions caret at the end of the next word
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Q</span></div>
|Quick find switch focus
|Switches focus between editor window and [[quick find]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F6</span></div>
|Focus other pane
|Moves focus to other pane when [[split window]] is active
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F6</span></div>
|Next window
|Makes next file window active (based upon last-accessed [[File tabs|file tab]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift F6</span></div>
|Previous window
|Makes previous file window active (based upon last-accessed [[File tabs|file tab]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt 🠕</span></div>
|Previous file tab
|Activates [[File tabs|file tab]] immediately to the left of active [[File tabs|file tab]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt 🠗</span></div>
|Next [[File tabs|file tab]]
|Activates [[File tabs|file tab]] immediately to the right of active [[File tabs|file tab]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F10</span></div>
|Previous panel
|Moves focus through last used child windows
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F10</span></div>
|Next panel
|Moves focus through next used child windows
|}

==Toggles==
{|
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt C</span></div>
|Column mode
|Toggles [[Column mode|column / block editing mode]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl W</span></div>
|Word wrap
|Toggles [[Settings:Editor:Word_wrap/tab_settings|word wrap]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Mouse click / drag</span></div>
|Quick column selection
|Allows you to create a quick column / block selection without enabling [[column mode]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl H</span></div>
|Hex mode
|Toggles [[hex edit|hex edit mode]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F8</span></div>
|Display function list
|Opens / refreshes [[function list]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F8</span></div>
|Tag list
|Toggles [[tag list]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl U</span></div>
|File explorer
|Toggles [[file view|file explorer]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Insert</span></div>
|Insert or overstrike mode
|Toggles [[Insert_and_overstrike_mode|insert / overstrike mode]]
|}

==Accessing other functionality==
{|
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift P</span></div>
|Command palette
|Opens [[Command palette]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F1</span></div>
|Help
|Shows UltraEdit help
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift F1</span></div>
|Context help
|Invokes the context-sensitive help
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt 0-9</span></div> or<br><div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift Alt 0-9'''</span></div>
|Insert template
|Inserts [[Modify_templates|user-defined template]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F7</span></div>
|Insert time / date
|Inserts time / date at caret
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F8</span></div>
|Layouts
|Opens [[Manage layouts|layout manager]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift R</span></div>
|Quick record macro (toggle)
|Immediately begins [[Edit and create macros|macro]] recording with no prompt
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl M</span></div>
|Play macro
|Plays last-played [[Edit and create macros|macro]], or first macro in macro list
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl L</span></div>
|Choose macro to play multiple times
|Allows you to select a [[Edit and create macros|macro]] and how many times to play it
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift Z</span></div>
|Scripts
|Opens [[scripts list]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift R</span></div>
|Run active script
|Runs active file as [[scripts|script]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Space bar</span></div>
|Auto-complate
|Opens [[auto-complete]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Enter</span></div>
|Character properties
|Opens character properties dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt \</span></div>
|Word count
|Opens word count dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift O</span></div>
|Open project / workspace
|Opens the open [[:Category:Project_tab|project]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift C</span></div>
|Close project / workspace
|Closes the active [[:Category:Project_tab|project]] and workspace
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift S</span></div>
|Open project settings
|Opens [[project settings]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F11</span></div>
|Compare
|Opens compare files dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F9</span></div>
|Run DOS command
|Opens run DOS command window
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F9</span></div>
|Run Last DOS Command
|Repeats last-run DOS command
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F10</span></div>
|Run Windows program
|Opens run Windows command window
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl P, S</span></div>
|Persistent selection
|Begins [[persistent selection]] mode allowing you to move caret anywhere in file to create a selection
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift 🠗</span></div>
|Next message
|Moves focus to next error or warning in output window listing and opens referenced file to corresponding line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift 🠕</span></div>
|Previous message
|Moves focus to previous error or warning in output window listing and opens referenced file to corresponding line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F4</span></div>
|Exit UltraEdit / UEStudio
|Exits the application
|}

<div class="idm-see-also">
See also:
* [[Settings:Key mapping|Settings » Key mapping]]
</div>

Keyboard shortcuts

2022-04-14T19:20:41Z

Idmadmin: /* Caret / view positioning */

[[Category:General]]
UltraEdit / UEStudio provides default keyboard shortcuts for many commonly used commands and features. You can add, remove, or change keyboard shortcuts in [[Settings:Key mapping|Settings » Key mapping]].

You can see all key mappings defined on your system by going to [[Settings:Key mapping|Settings » Key mapping]] and clicking the "Show key mapping in editor" button.

The default keyboard shortcuts are grouped below.

==Editing text==
{|
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl A</span></div>
|Select all
|Selects all text in active file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl ;</span></div>
|Select next occurrence
|Selects next occurrence of selected word (creating [[multi-caret editing|multiple selections]]) or word under caret if no selection exists
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl ,</span></div>
|Make selections
|Selects all occurrences of selected word or word under caret if no selection exists (creating [[multi-caret editing|multiple selections]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift Z</span></div>
|Remove last caret
|Removes last-created caret or selection ([[multi-caret editing]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift /</span></div>
|Remove all carets
|Removes all active carets ([[multi-caret editing]]) except for last-created caret
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl J</span></div>
|Join lines
|[[Join lines]], which joins active line to the next one (or all selected lines)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl E</span></div>
|Delete line
|Deletes line caret is on
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F11</span></div>
|Delete to start of line
|Deletes from caret to start of line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F12</span></div>
|Delete to end of line
|Deletes from caret to end of line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift D</span></div>
|Duplicate line
|Duplicates the active line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Z</span></div>
|Undo
|Undoes last action if possible
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Y</span></div>
|Redo
|Reverses last undo action if possible
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Backspace</span></div>
|Delete previous word
|Deletes the word preceding the caret, or to beginning of word if the caret is in the middle of a word
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Delete</span></div>
|Delete next word
|Deletes the word following the caret, or to end of word if the caret is in the middle of a word
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl /</span></div>
|Trim trailing spaces
|Deletes all trailing spaces on all lines in active file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl \</span></div>
|Trim leading spaces
|Deletes all leading spaces on all lines in active file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl T</span></div>
|Reformat paragraph
|[[Reformat paragraph|Reformats the current paragraph]] or selected text
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F5</span></div>
|To lowercase
|Converts selected text or letter next to caret to lowercase
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F5</span></div>
|To uppercase
|Converts selected text or letter next to caret to uppercase
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F5</span></div>
|Capitalize
|Capitalizes letter next to caret or first character of each word in selected text
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift F5</span></div>
|Invert case
|Inverts case of letter next to caret or all characters in selected text
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl K</span></div>
|Spell check
|Invokes the [[Spell check|spelling checker]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl I</span></div>
|Insert literal character
|Inserts a [[Insert literal character|literal character]] at caret position
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl D</span></div>
|Hex insert / delete
|[[Hex insert/delete|Insert or delete characters]] in hex edit mode
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift A</span></div>
|Inserts ä character
|(As appropriate for active file's encoding)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift A</span></div><br>(Caps Lock on)
|Inserts Ä character
|(As appropriate for active file's encoding)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift O</span></div>
|Inserts ö character
|(As appropriate for active file's encoding)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift O</span></div><br>(Caps Lock on)
|Inserts Ö character
|(As appropriate for active file's encoding)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift U</span></div>
|Inserts ü character
|(As appropriate for active file's encoding)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift U</span></div><br>(Caps Lock on)
|Inserts Ü character
|(As appropriate for active file's encoding)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift S</span></div>
|Inserts ß character
|(As appropriate for active file's encoding)
|}

==Clipboard operations==
{|
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl C</span></div>
|Copy
|Copies text from active file into the clipboard
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Insert</span></div>
|Copy
|Copies selected text (also in [[SSH / telnet console|SSH / telnet client window]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl X</span></div>
|Cut
|Cuts text from active file into the clipboard
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift Delete</span></div>
|Cut
|Cuts text from active file into the clipboard (also in [[SSH / telnet console|SSH / telnet client window]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl V</span></div>
|Paste
|Pastes text from the clipboard into the active file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift Insert</span></div>
|Paste
|Pastes clipboard contents (als in [[SSH / telnet console|SSH / Telnet client window]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift C</span></div>
|Copy and append
|Copies selected text and appends it onto the clipboard
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift X</span></div>
|Cut and append
|Cuts selected text and appends it onto the clipboard
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift V</span></div>
|Paste and copy
|Pastes text from the clipboard into the active file while simultaneously moving original selection to clipboard
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl 0-9</span></div>
|Select clipboard
|Selects Windows clipboard (0) or one of the user [[clipboards]] (1 - 9)
|}

==File operations==
{|
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl N</span></div>
|New
|Creates a new file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl O</span></div>
|Open
|Opens [[file open]] dialog to open an existing file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Q</span></div>
|Quick open
|Opens [[Quick open]] dialog for quickly opening files without file open dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F4</span></div>
|Close
|Closes active file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift F4</span></div>
|Close all files
|Closes all open files
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl S</span></div>
|Save
|Saves the active file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F12</span></div>
|Save
|Saves all open files
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F12</span></div>
|Save as
|Saves the active file as a new file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl P</span></div>
|Print
|[[Print|Prints]] the active file
|}

==Search / goto operations==
{|
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F</span></div>
|Quick find / Find
|Opens [[Quick find]]; Hold '''Ctrl''' and press '''F''' twice to open regular [[Find]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F3</span></div>
|Find
|Opens [[find]] (bypassing [[Quick Find]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl R</span></div>
|Replace
|Opens [[replace]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift F</span></div>
|Find in files
|Opens [[find in files]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl .</span></div>
|Highlight all
|Highlights all occurrences of selected text, or word under caret if no selection exists
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F3</span></div>
|Find next
|Searches forwards for last find string
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F3</span></div>
|Find previous
|Searches backwards for last find string
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift F3</span></div>
|Select to next occurrence
|Selects all text from caret through next occurence of find string
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl G</span></div>
|Goto
|[[Goto|Goes to]] the specified line (or hex address)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl B</span></div>
|Select to matching brace
|Selects to matching brace from next (,[,{ to closing },],) or other brace character as defined in the [[wordfiles|wordfile]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F2</span></div>
|Toggle bookmark
|Toggles [[Bookmarks|bookmark]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F2</span></div>
|Go to bookmark
|Jumps to next [[Bookmarks|bookmark]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift F2</span></div>
|Select to next bookmark
|Selects all text from caret through next [[Bookmarks|bookmarked]] line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift Alt F2</span></div>
|Select to previous bookmark
|Selects all text from caret through previous [[Bookmarks|bookmarked]] line
|}

==Caret / view positioning==
{|
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl 🠕</span></div>
|Scroll view up
|Scrolls view up one line while maintaining current caret position
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl 🠗</span></div>
|Scroll view down
|Scrolls view down one line while maintaining current caret position
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift Mouse Wheel</span></div>
|Scrolls horizontally
|Tracks horizontal scroll bar
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt 🠖</span></div>
|Next Paragraph
|Positions caret at first non-space character of next paragraph
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt 🠔</span></div>
|Previous Paragraph
|Positions caret at first non-space character of current paragraph (if positioned mid-paragraph) or previous paragraph
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Page Up</span></div>
|Top of window
|Moves caret to first visible line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Page Down</span></div>
|Bottom of window
|Moves caret to last visible line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl -</span></div><br>(numeric keypad only)
|Hide / show selection
|[[Hide/show_selection|Hides or shows]] active code folding node, or active line if in non-highlighted file
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl +</span></div><br>(numeric keypad only)
|Collapse all
|Collapses all code folding nodes
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl *</span></div><br>(numeric keypad only)
|Expand all
|Expands all hidden / collapsed lines
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt -</span></div><br>(numeric keypad only)
|Scroll to top
|Positions active line to top of window
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt +</span></div><br>(numeric keypad only)
|Scroll to bottom
|Positions active line to bottom of window
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt *</span></div><br>(numeric keypad only)
|Scroll to center
|Positions active line to center of window
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt 5</span></div><br>(numeric keypad only)
|Scroll to center
|Positions active line to center of window
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl 1</span></div><br>(numeric keypad only)
|End of previous word
|Positions caret at the end of the previous word
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl 2</span></div><br>(numeric keypad only)
|End of next word
|Positions caret at the end of the next word
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Q</span></div>
|Quick find switch focus
|Switches focus between editor window and [[quick find]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F6</span></div>
|Focus other pane
|Moves focus to other pane when [[split window]] is active
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F6</span></div>
|Next window
|Makes next file window active (based upon last-accessed [[File tabs|file tab]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift F6</span></div>
|Previous window
|Makes previous file window active (based upon last-accessed [[File tabs|file tab]])
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt 🠕</span></div>
|Previous file tab
|Activates [[File tabs|file tab]] immediately to the left of active [[File tabs|file tab]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt 🠗</span></div>
|Next [[File tabs|file tab]]
|Activates [[File tabs|file tab]] immediately to the right of active [[File tabs|file tab]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F10</span></div>
|Previous panel
|Moves focus through last used child windows
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F10</span></div>
|Next panel
|Moves focus through next used child windows
|}

==Toggles==
{|
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt C</span></div>
|Column mode
|Toggles [[Column mode|column / block editing mode]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl W</span></div>
|Word wrap
|Toggles [[Settings:Editor:Word_wrap/tab_settings|word wrap]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Mouse click / drag</span></div>
|Quick column selection
|Allows you to create a quick column / block selection without enabling [[column mode]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl H</span></div>
|Hex mode
|Toggles [[hex edit|hex edit mode]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F8</span></div>
|Display function list
|Opens / refreshes [[function list]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F8</span></div>
|Tag list
|Toggles [[tag list]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl U</span></div>
|File view / Workspace manager
|Toggles [[file view]] / Workspace manager (UEStudio)
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Insert</span></div>
|Insert or overstrike mode
|Toggles [[Insert_and_overstrike_mode|insert / overstrike mode]]
|}

==Accessing other functionality==
{|
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift P</span></div>
|Command palette
|Opens [[Command palette]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F1</span></div>
|Help
|Shows UltraEdit help
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift F1</span></div>
|Context help
|Invokes the context-sensitive help
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt 0-9</span></div> or<br><div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Shift Alt 0-9'''</span></div>
|Insert template
|Inserts [[Modify_templates|user-defined template]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F7</span></div>
|Insert time / date
|Inserts time / date at caret
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F8</span></div>
|Layouts
|Opens [[Manage layouts|layout manager]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift R</span></div>
|Quick record macro (toggle)
|Immediately begins [[Edit and create macros|macro]] recording with no prompt
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl M</span></div>
|Play macro
|Plays last-played [[Edit and create macros|macro]], or first macro in macro list
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl L</span></div>
|Choose macro to play multiple times
|Allows you to select a [[Edit and create macros|macro]] and how many times to play it
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift Z</span></div>
|Scripts
|Opens [[scripts list]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift R</span></div>
|Run active script
|Runs active file as [[scripts|script]]
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Space bar</span></div>
|Auto-complate
|Opens [[auto-complete]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Enter</span></div>
|Character properties
|Opens character properties dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt \</span></div>
|Word count
|Opens word count dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift O</span></div>
|Open project / workspace
|Opens the open [[:Category:Project_tab|project]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift C</span></div>
|Close project / workspace
|Closes the active [[:Category:Project_tab|project]] and workspace
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt Shift S</span></div>
|Open project settings
|Opens [[project settings]] dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F11</span></div>
|Compare
|Opens compare files dialog
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F9</span></div>
|Run DOS command
|Opens run DOS command window
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl F9</span></div>
|Run Last DOS Command
|Repeats last-run DOS command
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>F10</span></div>
|Run Windows program
|Opens run Windows command window
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl P, S</span></div>
|Persistent selection
|Begins [[persistent selection]] mode allowing you to move caret anywhere in file to create a selection
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift 🠗</span></div>
|Next message
|Moves focus to next error or warning in output window listing and opens referenced file to corresponding line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Ctrl Shift 🠕</span></div>
|Previous message
|Moves focus to previous error or warning in output window listing and opens referenced file to corresponding line
|-
|<div class="idm-shortcut" style="white-space:nowrap;margin-right:.5rem;"><span>Alt F4</span></div>
|Exit UltraEdit / UEStudio
|Exits the application
|}

<div class="idm-see-also">
See also:
* [[Settings:Key mapping|Settings » Key mapping]]
</div>

Configure tools

2021-08-02T13:03:21Z

Idmadmin:

[[Category:Advanced tab]][[File:UltraEdit user tools menu.png|alt=user tools menu in UltraEdit|right]]
<div class="idm-shortcut">
Shortcut: <span>Ctrl+Shift+#</span> ''(where # corresponds to the number of the tool)''
</div>

A '''user tool''' is a way for you to interact with other applications or programs on your system by executing a DOS or Windows command. You can configure up to 50 user tools - 25 standard tools and 25 [[:Category:Project tab|Project]] tools. You can access and execute user tools in the [[:Category:Advanced tab|Advanced tab]] in the '''User tools''' drop down. You can also add your tools to the ribbon or toolbars and [[Settings:Key mapping|map keyboard shortcuts]] to your tools. You can also use user tools in macros or scripts.

Clicking '''Configure tools''' opens the "Tool configuration" dialog, where you can create and delete tools. Here you can also configure tools, including defining the command line, setting parameters, configuring output handling, and setting options for interacting with the active file.

You can modify existing tools by selecting them from the list at the bottom of the dialog. The dialog also includes the following global buttons for adding / removing tools.

'''Insert'''<br>
Creates a new tool and makes it active.

'''Copy'''<br>
Creates a copy of the active / selected tool and makes it active.

'''Delete'''<br>
Deletes the active / selected tool.

Your changes to tools are not saved until you click either the '''OK''' or '''Apply''' button in the "Tool configuration" dialog.

You can configure tools in the '''Command''', '''Options''', and '''Output''' tabs in the "Tool configuration" dialog. The settings for each tab are described below.

==Command tab==

[[File:UltraEdit tool config - command.png|right]]

'''Menu item name'''<br>
This is the name of the tool and is shown in the user / project tool drop down as well as the tool list in the "Tool configuration" dialog.

'''Command line'''<br>
This is the actual command line to be executed when the tool is run. The command line uses the same syntax as a DOS command prompt, however this field also supports a special placeholder syntax (described below) which allows variables, such as the active file's path and name, to be passed to the command line. You can use the '''Browse''' button to browse to and select an existing batch or cmd file.

'''Working directory'''<br>
This is the active directory the tool and ensuing process will be launched in. You can use the '''Browse''' button to browse to and select an existing folder on your system.

For both the '''command line''' and '''working directory''' fields, the following placeholders are available.

''All examples provided below are based upon a hypothetical file path '''D:\work\Dev Projects\Cycle One\some file.c'''.''

{|
!Placeholder
!Meaning
|-
|%F
|Active file's full path and name (short version)<br>''Example: '''D:\work\DEVPRO~1\CYCLEO~1\SOMEFI~1.C'''''
|-
|%f
|Active file's full path and name (long version). Make sure to encapsulate in quotes if the file path or name might contain spaces. <br>''Example: '''D:\work\Dev Projects\Cycle One\some file.c'''''
|-
|%P
|Active file's full path (short version)<br>''Example: '''D:\work\DEVPRO~1\CYCLEO~1\'''''
|-
|%p
|Active file's full path (long version). Make sure to encapsulate in quotes if the file path might contain spaces. <br>''Example: '''D:\work\Dev Projects\Cycle One\'''''
|-
|%N
|Active file's name only (short version)<br>''Example: '''SOMEFI~1'''''
|-
|%n
|Active file's name only (long version). Make sure to encapsulate in quotes if the name might contain spaces. <br>''Example: '''some file'''''
|-
|%E
|Active file's extension only (short version)<br>''Example: '''.C'''''
|-
|%e
|Active file's extension only (long version). Make sure to encapsulate in quotes if the extension might contain spaces. <br>''Example: '''.c'''''
|-
|%R
|Active project's full path and name (short version), similar to %F above.
|-
|%r
|Active project's full path and name (long version), similar to %f above. Make sure to encapsulate in quotes if the path or name might contain spaces.
|-
|%RP
|Active project's full path (short version), similar to %P above.
|-
|%rp
|Active project's full path (long version), similar to %p above. Make sure to encapsulate in quotes if the project path might contain spaces.
|-
|%RN
|Active project's name (short version), similar to %N above.
|-
|%rn
|Active project's full path (long version), similar to %n above. Make sure to encapsulate in quotes if the project path might contain spaces.
|-
|%modify%
|Using this placeholder will allow you to specify any arbitrary command line argument(s) (in its place) in a dialog prompt when the command is run.
|-
|%sel%
|Selected text. Make sure to encapsulate in quotes if the selection might contain spaces.
|-
|%Env:
|An existing environment variable. The environment variable must immediately follow "%Env:". Note that this placeholder does not require the closing percent sign "%". <br>''Example: '''%Env:TEMP''' would be replaced with '''C:\Users\[USERNAME]\AppData\Local\Temp'''''
|-
|%line%
|Current line number in active file (based on first line number of 1)
|-
|%col%
|Current column number in active file (based on first column number of 1)
|}

'''Toolbar bitmap/icon (file path)'''<br>
This field allows you to set the path to a bitmap, png, or icon file to be used in the ribbon, context menu, or toolbar for the tool. Use the '''Browse''' button to browse to and select the image file you'd like to use. The image will be scaled to fit in the ribbon or toolbar. If this isn't set, the default tool icon (with associated number) is displayed with the tool.

==Options tab==
[[File:UltraEdit tool config - options.png|right]]
'''Program type'''<br>
You must define the program type as one of the following two options:

* '''DOS program''' (default)<br>The "Command" field is launched in console mode, just as you would run a command in a DOS command prompt window. Most user tools will use this setting.
* '''Windows program'''<br>The "Command" field is launched as a Windows executable program, just as if you were to double-click its icon in Windows explorer.

'''Save active file first'''<br>
If checked, the active file is saved before the tool is run.

'''Save all files first'''<br>
If checked, all open files are saved before the tool is run.

{{clear}}
==Output tab==
[[File:UltraEdit tool config - output.png|right]]
'''Command output (DOS commands)'''<br>
You can optionally capture the output from your DOS command user tool to a file. The four options for DOS command output are:

# '''Append to existing'''<br>Appends the tool output to the existing "Command Output" tool output file, ''or'' create the "Command Output" file if it does not yet exist.
# '''Replace existing'''<br>Replaces existing text with tool output in the "Command Output" tool output file, ''or'' create the "Command Output" file if it does not yet exist.
# '''Create new file'''<br>Always creates a new "Command Output" file for the tool output regardless of whether one already exists.
# '''Output to list box'''<br>Sends tool output to the [[output window]].

'''Show DOS box'''<br>
If checked, a DOS command prompt window is shown as tool's command is running, otherwise the DOS window will be hidden.

'''Capture output'''<br>
If checked, output from the tool's command is captured and handled as configured elsewhere in this window, otherwise all output including standard, error, etc. is discarded.

'''Clear output before run'''<br>
If checked, any data in the output window is cleared prior to the tool's command being executed.

'''Replace selected text with'''<br>
You can choose what to do with the selection in the active file after the user tool is run. This is especially useful if you want to send a selection of text (a code procedure, a forumala, etc.) to an external process and have it reformatted or recalculated in some way. The three options are:
# '''No replace'''<br>The selection is left unaltered.
# '''Captured output'''<br>The selection is replaced with all output from the user tool.
# '''Clipboard'''<br>The selection is replaced with the clipboard contents after the tool completes execution.

'''Handle output as'''<br>
This allows you to specify the encoding to use when displaying the output returned from the DOS command. These options don't actually convert the output, but allow you to configure which encoding UltraEdit / UEStudio uses to display the output. The three options are:
# '''ANSI''' ''(Default, recommended for most cases)''<br>The user tool output is displayed as ANSI with your system's default code page.
# '''UTF-8'''<br>The user tool output is displayed as though it were UTF-8. This option is not recommended unless your external process specifically creates output as UTF-8. Otherwise, the output may look garbled or incorrect.
# '''UTF-16'''<br>The user tool output is displayed as though it were UTF-16. Additionally, this will cause the command prompt to be internally invoked with the "/u" flag, creating a Unicode (UTF-16) DOS command prompt before the command is run. This option is not recommended unless your external process specifically creates output as UTF-16. Otherwise, the output may look garbled or incorrect.

<div class="idm-see-also">
See also:
* [[Run DOS / Windows command]]
</div>

Convert wrap to line ends

2021-07-09T14:28:21Z

Idmadmin:

[[Category:Format tab]]
Use this command to convert the existing [[word wrap]] in the file or selection to actual line terminator characters, or "hard returns" (CR/LF, or DOS/Windows based line terminators). If a space is found at the position of the wrap, it is removed.

This command will open a dialog allowing you to set the wrap parameters. By default, the text will be wrapped based on the current view of the file – in other words, the hard returns will be inserted precisely where the existing word wrap occurs as shown on the screen. However, you can select '''Add returns at column #''' and then specify a column number to insert the hard returns at this column number instead of the current word wrap locations.

This feature works on the complete file if no text is selected. If a selection is made, the feature only converts the selected area.

<div class="idm-see-also">
See also:
* [[Convert line ends to wrap]]
* [[Settings:Editor:Word_wrap_/_tab_settings|Settings » Editor » Word wrap/tab settings]]
</div>

Astyle reformat

2021-04-22T13:02:29Z

Idmadmin:

[[Category:Coding tab]]
The '''Astyle reformat''' option in the "Coding" tab opens the '''Artistic Style Formatter''' dialog. Here you can adjust artistic style settings before reformatting / beautifying the active source file according to the parameters you set. The number of indent spaces passed to Artistic Style is based on the '''Indent spaces''' value set in [[Settings:Editor:Word_wrap_/_tab_settings|Settings » Editor » Word wrap/tab settings]] (based upon extension of active file).
The '''Reformat''' button will apply the selected options/settings and reformat and beautify the active source file.

[[File:Ultraedit artistic style.png]]

===Indentation===
The following indentation options are available:

{|
!Control
!Function
|-
|Case
|indents 'case X:' blocks from the 'case X:' headers. Case statements not enclosed in blocks are NOT indented.

<pre>switch (foo)
{
case 1:
a += 1;
break;
case 2:
{
a += 2;
break;
}
}</pre>

becomes:

<pre>switch (foo)
{
case 1:
a += 1;
break;
case 2:
{
a += 2;
break;
}
}</pre>
|-
|Class
|indents 'class' and 'struct' blocks so that the blocks 'public:', 'protected:' and 'private:' are indented. The struct blocks are indented only if an access modifier is declared somewhere in the struct. The entire block is indented. This option is effective for C++ files only.

<pre>class Foo
{
public:
Foo();
virtual ~Foo();
};</pre>

becomes:

<pre>class Foo
{
public:
Foo();
virtual ~Foo();
};</pre>
|-
|Inline comments
|indents C++ comments beginning in column one. By default C++ comments beginning in column one are not indented. This option will allow the comments to be indented with the code.

<pre>void Foo()
{
// comment
if (isFoo)
bar();
}</pre>

becomes:

<pre>void Foo()
{
// comment
if (isFoo)
bar();
}</pre>
|-
|Label
|adds extra indentation to labels so they appear 1 indent less than the current indentation, rather than being flushed to the left (the default).

<pre>void Foo() {
while (isFoo) {
if (isFoo)
goto error;
...
error:
...
}
}</pre>

becomes (with indented 'error:'):

<pre>void Foo() {
while (isFoo) {
if (isFoo)
goto error;
...
error:
...
}
}</pre>
|-
|Namespace
|adds extra indentation to namespace blocks. This option has no effect on Java files.

<pre>namespace foospace
{
class Foo
{
public:
Foo();
virtual ~Foo();
};
}</pre>

becomes:

<pre>namespace foospace
{
class Foo
{
public:
Foo();
virtual ~Foo();
};
}</pre>
|-
|Preprocessor
|indents multi-line preprocessor definitions ending with a backslash. Should be used with '''Tabs -> Spaces''' for proper results. Does a pretty good job, but cannot perform miracles in obfuscated preprocessor definitions. Without this option the preprocessor statements remain unchanged.

<pre>#define Is_Bar(arg,a,b) \
(Is_Foo((arg), (a)) \
|| Is_Foo((arg), (b)))</pre>

becomes:

<pre>#define Is_Bar(arg,a,b) \
(Is_Foo((arg), (a)) \
|| Is_Foo((arg), (b)))</pre>
|-
|Switch
|indents 'switch' blocks so that the 'case X:' statements are indented in the switch block. The entire case block is indented.

<pre>switch (foo)
{
case 1:
a += 1;
break;
case 2:
{
a += 2;
break;
}
}</pre>

becomes:

<pre>switch (foo)
{
case 1:
a += 1;
break;
case 2:
{
a += 2;
break;
}
}</pre>
|-
|Max. instatement indent
|sets the maximum of # spaces to indent a continuation line. The # indicates a number of columns and must not be greater than 120. If no # is set, the default value of 40 will be used. A maximum of less than two indent lengths will be ignored. This option will prevent continuation lines from extending too far to the right. Setting a larger value will allow the code to be extended further to the right.

<pre>fooArray[] = { red,
green,
blue };
fooFunction(barArg1,
barArg2,
barArg3);</pre>

becomes (with larger value):

<pre>fooArray[] = { red,
green,
blue };
fooFunction(barArg1,
barArg2,
barArg3);</pre>
|-
|Min. conditional indent
|sets the minimal indent that is added when a header is built of multiple lines. This indent helps to easily separate the header from the command statements that follow. The value indicates a number of indents and is a minimum value. The indent may be greater to align with the data on the previous line.

The valid values are:

* '''0''': no minimal indent. The lines will be aligned with the parenthesis on the preceding line.
* '''1''': indent at least one additional indent.
* '''2''': indent at least two additional indents.
* '''3''': indent at least one-half an additional indent. This is intended for large indents (e.g. 8).

The default value is '''2''', two additional indents.

<pre>// default setting makes this non-bracketed code clear
if (a < b
|| c > d)
foo++;

// but creates an exaggerated indent in this bracketed code
if (a < b
|| c > d)
{
foo++;
}</pre>

becomes (when setting min. conditional indent = 0):

<pre>// setting makes this non-bracketed code less clear
if (a < b
|| c > d)
foo++;

// but makes this bracketed code clearer
if (a < b
|| c > d)
{
foo++;
}</pre>
|}

===Style===

One of sixteen possible styles may be selected using the Style dropdown ( allman, ansi, bsd, break, java, attach, kr, stroustrup, whitesmith, banner, gnu, linux, hortsmann, otbs, pico, lisp).

{|
|default
|If no bracket style option is set, the opening brackets will not be changed and closing brackets will be broken from the preceding line.
|-
|
* allman
* ansi
* bsd
* break

Allman style formatting/indenting uses broken brackets.
|
<pre>int Foo(bool isBar)
{
if (isBar)
{
bar();
return 1;
}
else
return 0;
}</pre>
|-
|
* java
* attach
|Java style formatting/indenting uses attached brackets.

<pre>int Foo(bool isBar) {
if (isBar) {
bar();
return 1;
} else
return 0;
}</pre>
|-
|kr (Kernighan & Ritchie)
|Kernighan & Ritchie style formatting/indenting uses linux brackets. Brackets are broken from namespaces, classes, and function definitions. Brackets are attached to statements within a function.

<pre>int Foo(bool isBar)
{
if (isBar) {
bar();
return 1;
} else
return 0;
}</pre>
|-
|stroustrup
|Stroustrup style formatting/indenting uses stroustrup brackets. Brackets are broken from function definitions only. Brackets are attached to namespaces, classes, and statements within a function. This style frequently is used with an indent of 5 spaces.

<pre>int Foo(bool isBar)
{
if (isBar) {
bar();
return 1;
} else
return 0;
}</pre>
|-
|whitesmith
|Whitesmith style formatting/indenting uses broken, indented brackets. Class blocks and switch blocks are indented to prevent a 'hanging indent' with switch statements and C++ class modifiers (public, private, protected).

<pre>int Foo(bool isBar)
{
if (isBar)
{
bar();
return 1;
}
else
return 0;
}</pre>
|-
|banner
|Banner style formatting/indenting uses attached, indented brackets. Class blocks and switch blocks are indented to prevent a 'hanging indent' with switch statements and C++ class modifiers (public, private, protected).

<pre>int Foo(bool isBar) {
if (isBar) {
bar();
return 1;
}
else
return 0;
}</pre>
|-
|gnu
|GNU style formatting/indenting uses broken brackets and indented blocks. This style frequently is used with an indent of 2 spaces.

Extra indentation is added to blocks '''within a function'''. The opening bracket for namespaces, classes, and functions is not indented.

<pre>int Foo(bool isBar)
{
if (isBar)
{
bar();
return 1;
}
else
return 0;
}</pre>
|-
|linux
|Linux style formatting/indenting uses linux brackets. Brackets are broken from namespace, class, and function definitions. Brackets are attached to statements within a function. '''Min. conditional indent''' is one-half indent. If you want a different minimum conditional indent use the K&R style instead. This style works best with a large indent. It frequently is used with an indent of 8 spaces.

Also known as Kernel Normal Form (KNF) style, this is the style used in the Linux kernel.

<pre>int Foo(bool isBar)
{
if (isFoo) {
bar();
return 1;
} else
return 0;
}</pre>
|-
|horstmann
|Horstmann style formatting/indenting uses run-in brackets, brackets are broken and allow run-in statements. Switches are indented to allow a run-in to the opening switch block. This style frequently is used with an indent of 3 spaces.

<pre>int Foo(bool isBar)
{ if (isBar)
{ bar();
return 1;
} else
return 0;
}</pre>
|-
|otbs
|"One True Brace Style" formatting/indenting uses linux brackets and adds brackets to unbracketed one line conditional statements. In the following example brackets have been added to the "return 0;" statement. The option '''add one line brackets''' can also be used with this style.

<pre>int Foo(bool isBar)
{
if (isFoo) {
bar();
return 1;
} else {
return 0;
}
}</pre>
|-
|pico
|Pico style formatting/indenting uses run-in brackets, opening brackets are broken and allow run-in statements. The closing bracket is attached to the last line in the block. Switches are indented to allow a run-in to the opening switch block. The style implies '''keep one line blocks''' and '''keep one line statements'''. This style does not support multiple-line brackets. If '''add brackets''' is used they will be added as '''one line brackets'''. This style frequently is used with an indent of 2 spaces.

<pre>int Foo(bool isBar)
{ if (isBar)
{ bar();
return 1; }
else
return 0; }</pre>
|-
|lisp
|Lisp style formatting/indenting uses attached brackets, opening brackets are attached at the end of the statement. The closing bracket is attached to the last line in the block. The style implies '''keep one line statements''' but NOT '''keep one line blocks'''. This style does not support one line brackets. If '''add one line brackets''' is used they will be added as multiple-line brackets.

<pre>int Foo(bool isBar) {
if (isBar) {
bar()
return 1; }
else
return 0; }</pre>
|}

===Mode===

This option is usually set from the file extension for each file. You can override the setting with this entry. It will be used for all files regardless of the file extension. It allows the formatter to identify language specific syntax such as C++ classes, templates, and keywords.

{|
|c
|indents a C or C++ file
|-
|cs
|indents a C# file
|-
|java
|indents a Java file
|}

===Options file===

An '''optional''' default options file may be used to supplement or replace the dialog options. The dialog options have precedence. If there is a conflict between a dialog option and an option in the default options file, the dialog option will be used.

Artistic Style looks for this file in the following locations (in order):
# the file indicated by the '''--options=''' command line option as used if an options file is set in the dialog;
# the file and directory indicated by the environment variable '''ARTISTIC_STYLE_OPTIONS''' (if it exists);
# the file named '''.astylerc''' in the directory pointed to by the '''HOME''' environment variable (e.g. "$HOME/.astylerc" on Linux);
# the file named '''astylerc''' in the directory pointed to by the '''USERPROFILE''' environment variable (e.g. "%USERPROFILE%\astylerc" on Windows).

===Formatting===

The following formatting options are available:

{|
!Control
!Function
|-
|Add brackets
|adds brackets to unbracketed one line conditional statements (e.g. 'if', 'for', 'while', ...). The statement must be on a single line. The brackets will be added according to the currently requested predefined style or bracket type. If no style or bracket type is requested the brackets will be attached. If '''add one line brackets''' is also used the result will be one line brackets.

<pre>if (isFoo)
isFoo = false;</pre>

becomes:

<pre>if (isFoo) {
isFoo = false;
}</pre>
|-
|Add one line brackets
|adds one line brackets to unbracketed one line conditional statements (e.g. 'if', 'for', 'while', ...). The statement must be on a single line. The option implies '''keep one line blocks''' and will not break the one line blocks.

<pre>if (isFoo)
isFoo = false;</pre>

becomes:

<pre>if (isFoo)
{ isFoo = false; }</pre>
|-
|Align pointer
|attaches a pointer or reference operator (*, &, or ^) to either the variable type (left) or variable name (right), or place it between the type and name (middle). The spacing between the type and name will be preserved, if possible. This option is for C/C++, C++/CLI, and C# files. To format references separately use the following '''align''' reference option.

<pre>char* foo1;
char & foo2;
String ^s1;</pre>

becomes (with align pointer = type):

<pre>char* foo1;
char& foo2;
String^ s1;</pre>

<pre>char* foo1;
char & foo2;
String ^s1;</pre>

becomes (with align pointer = middle):

<pre>char * foo1;
char & foo2;
String ^ s1;</pre>

<pre>char* foo1;
char & foo2;
String ^s1;</pre>

becomes (with align pointer = name):

<pre>char *foo1;
char &foo2;
String ^s1;</pre>
|-
|Align reference
|aligns references separate from pointers. Pointers are not changed by this option. If pointers and references are to be aligned the same, use the previous '''align pointer''' option. The align reference option with value none will not change the reference alignment. The other options are the same as for '''align pointer'''. This option is for C/C++, C++/CLI, and C# files.

<pre>char &foo1;</pre>

becomes (with align reference = type):

<pre>char& foo1;</pre>

<pre>char& foo2;</pre>

becomes (with align reference = middle):

<pre>char & foo2;</pre>

<pre>char& foo3;</pre>

becomes (with align reference = name):

<pre>char &foo3;</pre>
|-
|Break after logical
|The option '''max. code length''' will break a line if the code exceeds # characters. The valid values are '''50''' thru '''200'''. Lines without logical conditionals will break on a logical conditional (<nowiki>||</nowiki> , &&, ...), comma, parenthesis, semicolon, or space.

Some code will not be broken, such as comments, quotes, and arrays. If used with '''keep one line blocks''' or '''add one line brackets''' the blocks will NOT be broken. If used with keep one line statements the statements will be broken at a semicolon if the line goes over the maximum length. If there is no available break point within the max code length, the line will be broken at the first available break point after the max code length.

By default logical conditionals will be placed first on the new line. The option '''break after logical''' will cause the logical conditionals to be placed last on the previous line. This option has no effect without '''max. code length'''.

<pre>if (thisVariable1 == thatVariable1 || thisVariable2 == thatVariable2 || thisVariable3 == thatVariable3)
bar();</pre>

becomes:

<pre>if (thisVariable1 == thatVariable1
|| thisVariable2 == thatVariable2
|| thisVariable3 == thatVariable3)
bar();</pre>

becomes (with break after logical):

<pre>if (thisVariable1 == thatVariable1 ||
thisVariable2 == thatVariable2 ||
thisVariable3 == thatVariable3)
bar();</pre>
|-
|Break else if()
|breaks 'else if' header combinations into separate lines. This option has no effect if '''keep one line statements''' is used, the 'else if' statements will remain as they are. If this option is NOT used, 'else if' header combinations will be placed on a single line.

<pre>if (isFoo) {
bar();
}
else if (isFoo1()) {
bar1();
}
else if (isFoo2()) {
bar2;
}</pre>

becomes:

<pre>if (isFoo) {
bar();
}
else
if (isFoo1()) {
bar1();
}
else
if (isFoo2()) {
bar2();
}</pre>
|-
|Break blocks
|The '''default''' option pads empty lines around header blocks (e.g. 'if', 'for', 'while', ...).

<pre>isFoo = true;
if (isFoo) {
bar();
} else {
anotherBar();
}
isBar = false;</pre>

becomes:

<pre>isFoo = true;

if (isFoo) {
bar();
} else {
anotherBar();
}

isBar = false;</pre>

The '''all''' option pads empty lines around header blocks (e.g. 'if', 'for', 'while', ...). Treat closing header blocks (e.g. 'else', 'catch') as stand-alone blocks.

<pre>isFoo = true;
if (isFoo) {
bar();
} else {
anotherBar();
}
isBar = false;</pre>

becomes:

<pre>isFoo = true;

if (isFoo) {
bar();

} else {
anotherBar();
}

isBar = false;</pre>
|-
|Close templates
|closes whitespace in the angle brackets of template definitions. Closing the ending angle brackets is now allowed by the C++11 standard. Be sure your compiler supports this before making the changes.

<pre>Stack< int,List< int > > stack1;</pre>

becomes:

<pre>Stack<int,List<int>> stack1;</pre>
|-
|Empty lines
|The delete option deletes empty lines within a function or method. Empty lines outside of functions or methods are NOT deleted. If used with '''break blocks''' with '''default''' or '''all''' it will delete all lines EXCEPT the lines added by the '''break blocks''' options.

<pre>void Foo()
{

foo1 = 1;

foo2 = 2;

}</pre>

becomes:

<pre>void Foo()
{
foo1 = 1;
foo2 = 2;
}</pre>

The fill option fills empty lines with the white space of the previous line.
|-
|Keep one line blocks
|will not break one line blocks.

<pre>if (isFoo)
{ isFoo = false; cout << isFoo << endl; }</pre>

remains unchanged.
|-
|Keep one line statements
|will not break complex statements and multiple statements residing on a single line.

<pre>if (isFoo)
{
isFoo = false; cout << isFoo << endl;
}</pre>

remains unchanged.

<pre>if (isFoo) DoBar();</pre>

remains also unchanged.
|-
|Max code length
|The option '''max code length''' will break a line if the code exceeds # characters. The valid values are 50 thru 200. Lines without logical conditionals will break on a logical conditional (<nowiki>||</nowiki>, &&, ...), comma, parenthesis, semicolon, or space.

Some code will not be broken, such as comments, quotes, and arrays. If used with '''keep one line blocks''' or '''add one line brackets''' the blocks will NOT be broken. If used with '''keep one line statements''' the statements will be broken at a semicolon if the line goes over the maximum length. If there is no available break point within the max code length, the line will be broken at the first available break point after the max code length.
|-
|Space padding
|There are several padding options available:

'''first-paren-out'''<br>
inserts space padding around the first parenthesis in a series on the outside only. Any end of line comments will remain in the original column, if possible. This can be used with '''unpad-paren''' below to remove unwanted spaces. If used with '''pad-paren''' or '''pad-paren-out''', this option will be ignored. If used with '''pad-paren-in''', the result will be the same as '''pad-paren'''.

<pre>if (isFoo((a+2), b))
bar(a, b);</pre>

becomes:

<pre>if (isFoo ((a+2), b))
bar (a, b);</pre>

'''oper'''<br>
inserts space padding around operators. Any end of line comments will remain in the original column, if possible. Note that there is no option to unpad. Once padded, they stay padded.

<pre>if (foo==2)
a=bar((b-c)*a,d--);</pre>

becomes:

<pre>if (foo == 2)
a = bar((b - c) * a, d--);</pre>

'''paren'''<br>
inserts space padding around parenthesis on both the outside and the inside. Any end of line comments will remain in the original column, if possible.

<pre>if (isFoo((a+2), b))
bar(a, b);</pre>

becomes:

<pre>if ( isFoo ( ( a+2 ), b ) )
bar ( a, b );</pre>

'''paren-in'''<br>
inserts space padding around parenthesis on the '''inside''' only. Any end of line comments will remain in the original column, if possible. This can be used with unpad-paren below to remove unwanted spaces.

<pre>if (isFoo((a+2), b))
bar(a, b);</pre>

becomes:

<pre>if ( isFoo( ( a+2 ), b ) )
bar( a, b );</pre>

'''paren-out'''<br>
inserts space padding around parenthesis on the '''outside''' only. Any end of line comments will remain in the original column, if possible. This can be used with '''unpad-paren''' below to remove unwanted spaces.

<pre>if (isFoo((a+2), b))
bar(a, b);</pre>

becomes:

<pre>if (isFoo ( (a+2), b) )
bar (a, b);</pre>

'''header'''<br>
inserts space padding after parenthesis headers only (e.g. 'if', 'for', 'while', ...). Any end of line comments will remain in the original column, if possible. This can be used with '''unpad-paren''' to remove unwanted spaces.

<pre>if(isFoo((a+2), b))
bar(a, b);</pre>

becomes:

<pre>if (isFoo((a+2), b))
bar(a, b);</pre>

'''unpad-paren'''<br>
removes extra space padding around parenthesis on the inside and outside. Any end of line comments will remain in the original column, if possible. This option can be used in combination with the parenthesis padding options '''paren''', '''paren-out''', '''paren-in''', and '''header''' above. Only padding that has not been requested by other options will be removed.

For example, if a source has parenthesis padded on both the inside and outside, and you want inside only. You need to use '''unpad-paren''' to remove the outside padding, and '''paren-in''' to retain the inside padding. Using only '''paren-in''' would not remove the outside padding.

<pre>if ( isFoo( ( a+2 ), b ) )
bar ( a, b );</pre>

becomes (with no padding option requested):

<pre>if(isFoo((a+2), b))
bar(a, b);</pre>
|-
|Tabs -> Spaces
|converts tabs into spaces in the non-indentation part of the line. The number of spaces inserted will maintain the spacing of the tab. The current setting for spaces per tab is used. It may not produce the expected results if this option is used when changing spaces per tab. Tabs are not replaced in quotes.
|}

Converting file encoding

2020-10-29T12:23:24Z

Idmadmin:

[[Category:Advanced tab]]
The '''Conversions''' drop down in the [[:Category:Advanced tab|Advanced tab]] offers the following conversion options related to [https://en.wikipedia.org/wiki/Character_encoding file encoding] for the active file.

{|
!Conversion
!Description
|-
|Unix / Mac (legacy) to DOS
|Converts all occurrences of Unix line terminators (hex 0A, or LF), and all occurrences of Mac (legacy) line terminators (hex 0D, or CR) with Windows / DOS style line terminators (hex 0D 0A, or CR/LF).
|-
|DOS to Mac (legacy)
|Converts all occurrences of DOS style line terminators to Mac (legacy) line terminators.
|-
|DOS to Unix
|Converts all occurrences of DOS style line terminators to Unix line terminators.
|-
|EBCDIC to ASCII
|Converts the complete file from [https://en.wikipedia.org/wiki/EBCDIC EBCDIC encoding] to ASCII. For example, files from the IBM mainframe system will often be in EBCDIC format.
|-
|ASCII to EBCDIC
|Converts the complete file from ASCII encoding to EBCDIC.
|-
|OEM to ANSI
|Converts the complete file from OEM encoding to ANSI. This command assumes that the file's underlying encoding is using the OEM format. OEM is typically used with much older DOS systems.
|-
|OEM to EBCDIC
|Converts the complete file from OEM encoding to EBCDIC.
|-
|ASCII to Unicode
|Converts the complete file from ASCII encoding to Unicode (16-bit wide characters, also known as "UTF-16"). The conversion uses the active ASCII code page as the source encoding, which is visible in the status bar. Unless you've manually changed this, this will be the default ASCII code page for the operating system. After conversion, the status bar shows a "U-" in front of the line terminator type to indicate the file is Unicode.
|-
|UTF-8 to Unicode
|Converts the complete file from UTF-8 encoding to Unicode (16-bit wide characters, also known as "UTF-16"). After conversion, the status bar will show a "U-" in front of the line terminator type to indicate the file is Unicode.
|-
|Unicode to ASCII
|Converts the complete file from Unicode (UTF-16) encoding to ASCII. The conversion uses the active ASCII code page as the source encoding, which is visible in the status bar. Unless you've manually changed this, this will be the default ASCII code page for the operating system. Because the Unicode character set supports far more characters and glyphs than ASCII, it's possible not all characters can be converted. In these cases, a question mark "?" is substituted in for these characters. For Unicode files the status bar shows a "U-" in front of line terminator type to indicate the file is Unicode, but following this conversion, no indicator is present.
|-
|UTF-8 to ASCII
|Converts the complete file from UTF-8 encoding to ASCII. The conversion uses the active ASCII code page as the source encoding, which is visible in the status bar. Unless you've manually changed this, this will be the default ASCII code page for the operating system. Because the Unicode character set supports far more characters and glyphs than ASCII, it's possible not all characters can be converted. In these cases, a question mark "?" is substituted in for these characters. For UTF-8 files the status bar shows a "U8-" in front of line terminator type to indicate the file is UTF-8, but following this conversion, no indicator is present.
|-
|ASCII to UTF-8
|Converts the complete file from ASCII encoding to UTF-8. After conversion, the status bar will show a "U8-" in front of the line terminator type to indicate the file is UTF-8.
|-
|Unicode/UTF-8 to UTF-8 (Unicode editing)
|Converts the complete file from Unicode (UTF-16) or UTF-8 (ASCII representation) encoding to UTF-8. After conversion, the status bar will show a "U8-" in front of the line terminator type to indicate the file is UTF-8.
|-
|Unicode/ASCII/UTF-8 to UTF-8 (Unicode editing)
|Converts the complete file from Unicode (UTF-16), ASCII, or UTF-8 (ASCII representation) encoding to UTF-8. The file will however not be internally handled as Unicode and as such the multi-byte UTF-8 characters will display as upper ASCII characters and not the UTF-8 character they represent. The status bar will not indicate this file format as it has no different structure from an ASCII file.
|-
|Unicode to Unicode big-endian
|Converts the complete file from Unicode (UTF-16) encoding to Unicode big-endian encoding. Endian refers to the order in which bytes are stored. On Windows, which uses the little endian format of Unicode, UTF-16LE is just called "Unicode" or "UTF-16" and UTF-16BE is called "Unicode (big endian)".
|-
|Unicode big-endian to Unicode
|Converts the complete file from Unicode (big-endian) encoding to Unicode (UTF-16) encoding. Endian refers to the order in which bytes are stored. On Windows, which are mostly little endian, UTF-16LE is just called "Unicode" or "UTF-16" and UTF-16BE is just called "Unicode (big endian)".
|-
|Unicode to ASCII-escaped Unicode
|Converts the complete file from Unicode (UTF-16) to ASCII-escaped Unicode, which allows the file to maintain its Unicode bytes while in ASCII format.
|-
|Unicode to ASCII-escaped Unicode
|Converts the complete file from ASCII-escaped Unicode to Unicode (UTF-16).
|}

<div class="idm-see-also">
See also:
* [[Settings:File handling:Encoding|Settings » File handling » Encoding]]
</div>

Git

2020-10-05T18:59:23Z

Idmadmin: /* Using the Git sub-menu in the Explorer / Project panes */

[[Category:Project tab]]
<span class="idm-uestudio-only">''This feature is available in [https://www.ultraedit.com/products/uestudio/ UEStudio] only.''</span>

Git is a very popular distributed version control system. UEStudio offers robust Git integration so that you can directly interact with Git repositories from within the application. You can learn more about Git and read over its full documentation at the [https://git-scm.com/ official Git website].

In order to use Git with UEStudio, you need to have a Git client installed. [https://git-scm.com/download/win Git for Windows] is recommended.

If you already have Git for Windows installed on your system, then on first run UEStudio will detect this and prompt you to import your Git credentials. Otherwise, you can configure Git in UEStudio's settings under [[Settings:Integrated applications:Version control systems:Git|Integrated applications » Version control systems » Git]].

[[File:UEStudio_Git_autodetection.png]]

==Using Git==
[[File:UEStudio_Git_integration_in_Workspace_Manager.png|right]]
Once Git is properly configured on your system, you can then begin interacting with repositories and objects through four different methods:

# Via the [[#Using the Git sub-menu in the Explorer / Project panes|Git context menu]] for Git repositories in the "Explorer" or "Project" tab of the [[File view|Workspace Manager]].
# Through the Git commands in the "Version control" group of the [[:Category:Project tab|Project tab]].
# Through the Git [[Branch manager]].
# Through the [[Git shell]].

In both cases (if Git integration is configured in UEStudio properly) UEStudio will display the repo folder with a special Git icon overlay. If in a project, UEStudio will display the current branch and commits ahead / behind directly beneath the folder name.

Additionally, a special "Git" sub-menu is available in the context menu for files / folders under Git in the "Explorer" and "Project" tabs. This sub-menu contains many commands for interacting with the Git repository.

===Creating and cloning repositories===
* To '''create a new Git repository''', right-click on the folder where you want to initialize the repository, and select '''Git''' » '''Create/initialize repository here'''. The hidden ".git" subfolder will be created, and you can begin adding, staging, and committing files.
* To '''clone an existing Git repository''', right-click on the folder where you want to clone the repository and select '''Git''' » '''Clone repository...''' This will open the "Clone repository" dialog where you can enter the full path or the URL (SSH or HTTP[S]) to the repository. This dialog also contains the following options:
** '''Branch'''<br>This option allows you to specify which branch to switch to when cloning a repository. If left empty, or if a branch is provided that doesn't exist, this will default to the HEAD branch.
** '''Depth'''<br>This option allows you to create a '''shallow''' clone where the repository history is truncated to the specified number of revisions. For example, if you enter "2" here, the history for only the last 2 revisions will be available in your locally checked out repository.
** '''No checkout'''<br>This option will clone the repository ''without'' checking out a branch, essentially creating a disconnected Git branch.
** '''Recursive'''<br>This option will clone the repository along with any sub-modules contained within it.

===Using the Git sub-menu in the Explorer / Project panes===
The "Git" sub-menu in the context menu of the "Explorer" and "Project" pane of the [[File view|Workspace Manager]] includes the following options.

'''For top-level repository folders:'''

{|
|'''Branch manager'''
|Opens the Git [[Branch manager|branch manager]] window.
|-
|'''Status'''
|Updates status of Git repository, shown in [[Git shell]] window.
|-
|'''Show log'''
|Outputs history log for entire repository to [[Git shell]] window.
|-
|'''Add all new files'''
|Adds all new files in the folder to the Git repository.
|-
|'''Commit'''
|Commits all staged changes to the Git repository.
|-
|'''Resume merge'''
|Attempts to resume merge after conflicts have been manually resolved by user. (This option is only available after all conflict files have been marked "Resolved" by the user.)
|-
|'''Abort merge'''
|Aborts the merge that caused conflicts and restores local repository to state it was in prior to the pull / merge attempt. (This option is only available when one or more files in the repository is in a conflict state.)
|-
|'''Resume rebase'''
|Attempts to resume rebase after conflicts have been manually resolved by user. (This option is only available after all conflict files have been marked "Resolved" by the user.)
|-
|'''Abort rebase'''
|Aborts the rebase that caused conflicts and restores local repository to state it was in prior to the rebase attempt. (This option is only available when one or more files in the repository is in a conflict state.)
|-
|'''Reapply stash'''
|Opens the "Apply stash" dialog where you can choose a pre-existing stash to apply to the current branch.
|-
|'''Push'''
|Pushes the locally committed objects to the associated remote repository.
|-
|'''Pull'''
|Pulls all objects from associated remote repository to local repository.
|-
|'''Launch shell'''
|Opens the [[Git shell]] window.
|-
|'''Sort files by Git status'''
|Shows files with a "modified" or "conflict" status to be moved to the top of the file list. (Available for "Explorer" pane only.)
|-
|'''Config » Open .gitignore'''
|Opens repository's ".gitignore" file for editing.
|-
|'''Config » Open config file'''
|Opens repository's local ".git\config" file for editing.
|}

'''For repository files:'''

{|
|'''Add » ''file name'''''
|Adds selected file to the repository. (This option is only available if the file has not yet been added to the repository.)
|-
|'''Add » ''file extension'''''
|Adds all new files with the selected file's extension to the repository. (This option is only available if the file has not yet been added to the repository.)
|-
|'''Add to ignore list » ''file name'''''
|Adds the selected file to the repository's .gitignore file and excludes it from the repository. (This option is only available if the file has not yet been added to the repository.)
|-
|'''Add to ignore list » ''file extension'''''
|Adds the selected file's extension only to the repository's .gitignore file. All files matching this extension will be excluded from the repository. (This option is only available if the file has not yet been added to the repository.)
|-
|'''Commit this file only'''
|Allows you to commit just the selected file to the repository. (This option is only available if the file is modified.)
|-
|'''Mark resolved'''
|Allows you to set the selected conflict file to "resolved" to resume the merge / rebase. (This option is only available if the file is in a conflict state.)
|-
|'''Diff'''
|Shows Git diff output for the selected file in [[Git shell]] window. (This option is only available if the file is modified.)
|-
|'''Diff with UltraCompare'''
|Sends modified and repository versions of the selected file to UltraCompare Professional for text compare. (This option is only available if the file is modified.)
|-
|'''Revert'''
|Reverts all uncommitted changes and restores repository version of the selected file. (This option is only available if the file is modified.)
|-
|'''Show log'''
|Outputs history log for the selected file to [[Git shell]] window.
|-
|'''Blame'''
|Shows what revision and author last modified each line of the selected file.
|}

===Git file icon overlays in the Explorer / Project panes===
Git repositories that have been added to a project are shown in the "Project" pane with the current branch name and commits ahead / behind directly beneath them. The color used also indicates the state of the repository:
* If '''green''', there are no uncommitted changes in the local Git repository.
* If '''orange''', there are uncommitted changes in the local Git repository.
* If '''red''', there are conflicts in the local Git repository that need to be resolved.

UEStudio will show the following icon overlays for files and folders that are part of a Git repository:

{|
!Icon
!Meaning
|-
|[[File:Git-icon-folder-updated.png]]
|The folder and all its contents are up-to-date; all changes are committed to the repository.
|-
|[[File:Git-icon-file-updated.png]]
|The file is up-to-date and committed to the repository.
|-
|[[File:Git-icon-folder-modified.png]]
|One or more files in the folder has uncommitted changes.
|-
|[[File:Git-icon-file-modified.png]]
|The file has uncommitted changes.
|-
|[[File:Git-icon-file-added.png]]
|The file has been newly added to the repostiory but has not yet been committed.
|-
|[[File:Git-icon-folder-unknown.png]]
|The folder and all its contents are not a part of the Git repository.
|-
|[[File:Git-icon-file-unknown.png]]
|The file is not a part of the Git repository.
|-
|[[File:Git-icon-folder-conflict.png]]
|One or more files in the folder is in a conflict state as a result of an automatic merge or rebase.
|-
|[[File:Git-icon-file-conflict.png]]
|The file is in a conflict state as a result of an automatic merge or rebase and must be manually resolved.
|-
|[[File:Git-icon-folder-ignored.png]]
|The folder and all its contents are ignored from the Git repository due to an ignore rule in the ".gitignore" file.
|-
|[[File:Git-icon-file-ignored.png]]
|The file is ignored from the Git repository due to an ignore rule in the ".gitignore" file.
|}

<div class="idm-see-also">
See also:
* [[Branch manager]]
* [[Git shell]]
* [[Settings:Integrated_applications:Version_control_systems:Git|Settings » Integrated applications » Integrated applications » VCS » Git]]
</div>

Settings:Cloud services

2020-09-02T16:27:46Z

Idmadmin:

[[Category:Settings]]The '''Cloud services''' branch of [[:Category:Settings|Settings]] includes the following options.

<h2 class="setting">Macro directory / Script directory</h2>
These fields set the path to the directory Cloud Sync will check when sharing macros or scripts with other systems. Any macros and scripts will only be synced if they are saved in these folders.

If macros or scripts are loaded with the application but ''not'' saved in the directories set here, they will not be detected when data is shared with other systems. The '''Browse''' button will allow you to browse to and select the folder you'd like to use for this purpose.

<h2 class="setting">Restore from local backup</h2>
Every time you sync a system, a local backup of settings is created before cloud settings are pulled down. This button allows you to access one of those local backups in case you need to revert to a previous point in time. These backups are created using the [[Backup / restore user customizations]] system.

<div class="idm-see-also">
See also:
* [[Cloud sync]]
</div>

Category:Layout tab

2020-09-02T16:11:55Z

Idmadmin: /* Views */

[[Category:Ribbon commands]]
===Look and feel===

{|
|Layout drop down
|Allows you to select a different layout for UltraEdit or UEStudio
|-
|[[Manage layouts]]
|Opens "Layout manager" dialog where user may specify active layout (menus/toolbars/dockable windows)
|-
|Themes drop down
|Allows you to select a different color theme for UltraEdit or UEStudio
|-
|[[Manage themes]]
|Opens "Manage themes" dialog where you can create new themes or modify existing ones
|-
|[[File tabs]]
|Shows or hides the open file tabs
|-
|[[Status bar]]
|Shows or hides the status bar
|-
|[[Bookmark gutter]]
|Shows or hides the bookmark gutter in line number margin
|}

===Views===
{|
|[[File view]]
|Shows or hides the file tree view (Workspace Manager in UEStudio)
|-
|[[Function list]]
|Shows or hides the function list
|-
|[[Output window]]
|Shows or hides the output window
|-
|[[JSON manager]]
|Shows or hides the JSON manager used for browsing and navigating JSON structures in JSON files
|-
|[[XML manager]]
|Shows or hides the XML Manager used for browsing and navigating XML structures in XML files
|-
|[[Template list]]
|Shows or hides the template list
|-
|[[Macro list]]
|Shows or hides listing of all currently loaded macros
|-
|[[Script list]]
|Shows or hides listing of all currently loaded scripts
|-
|[[Bookmark Viewer|Bookmarks]]
|Shows or hides the Bookmark viewer
|-
|[[Tag List]]
|Shows or hides the tag list
|-
|[[ASCII table]]
|Shows or hides the dockable ASCII table
|-
|[[Clipboard history]]
|Shows or hides the clipboard history list
|-
|[[Cloud sync|Cloud Services]]
|Shows or hides the Cloud Services window (cloud sync)
|-
|Other windows - [[Find string list]]
|Shows or hides the Find String List
|-
|Gather windows
|Automatically moves all undocked child windows within the visible area of the monitor. This is helpful if one ore more of the child windows has been positioned off of the visible area of the screen.
|}

Category:Home tab

2020-09-02T15:58:29Z

Idmadmin: /* Extras */

[[Category:Ribbon commands]]
=== Clipboard ===
{|
|Paste
|pastes data from the clipboard into the document
|-
|Paste & copy
|pastes the clipboard text to the selection (replacing it) and copies the selected text to the clipboard
|-
|Paste column
|pastes selected text at caret position as if in column mode without toggling column mode
|-
|Paste special
|presents a submenu where users may select an option to paste either HTML Source or Raw RTF rather than the selected text only
|-
|Copy
|copies selected text to clipboard
|-
|Copy & append
|adds selected text to end of clipboard (preserving existing clipboard contents)
|-
|Copy special
|opens submenu where you can select an option to copy a selection as a complete HTML document, HTML, or RTF. These options export syntax highlighting and font styling information for the selection.
|-
|Cut
|copies selected text to clipboard and then deletes selection
|-
|Cut & append
|adds selected text to end of clipboard (preserving existing clipboard contents) and then deletes selection
|-
|Clipboard selector drop down
|allows you to set the active clipboard. UltraEdit supports the standard OS clipboard and then 9 user clipboards. See [[Clipboards]] help topic.
|}

=== Search ===
{|
|[[Find]]
|Opens Find dialog, allowing you to search active file for a string, with various search options and settings.
|-
|[[Replace]]
|Opens Replace dialog, allowing you to replace one string in the active file or all open files with another.
|-
|[[Find previous|Previous]]
|Searches backward from current caret location in active file for last searched string.
|-
|[[Find next|Next]]
|Searches forward from current caret location in active file for last searched string.
|-
|[[Filter on selection]]
|Filters active file to show only lines containing the selected text.
|-
|[[Find in files]]
|Opens Find in Files dialog, allowing you to search for a string across multiple files, with various search options and settings.
|-
|[[Replace in files]]
|Opens Replace in Files dialog, allowing you to replace a string across multiple files, with various search options and settings.
|}

=== Navigate ===
{|
|[[Goto]]
|positions the caret at the specified line/column number, page break (or file position in HEX mode), or bookmark
|-
|[[Back and forward|Back]]
|goes to last position editing/repositioning occurred
|-
|[[Back and forward|Forward]]
|goes to next position editing/repositioning occurred (after using Back command)
|-
|Last change
|goes to previous line with unsaved changes
|-
|Next change
|goes to next line with unsaved changes
|}

=== Bookmarks ===
{|
|[[Bookmarks|Toggle bookmark]]
|Toggles a bookmark at the current line.
|-
|[[Bookmarks|Clear all bookmarks]]
|Clears all bookmarks in the active file.
|-
|[[Bookmarks|Clear Find bookmarks]]
|Clears all bookmarks set by the "Bookmark matching lines" option in the [[Find]] dialog.
|-
|Edit bookmarks
|Opens dialog allowing you to set and name a bookmark at the active line.
|-
|Copy all bookmarked lines
|Copies all bookmarked lines in active file to clipboard.
|-
|Cut all bookmarked lines
|Cuts all bookmarked lines in active file to clipboard.
|-
|Delete all bookmarked lines
|Removes all bookmarked lines from active file.
|-
|[[Bookmarks|Previous]]
|Moves the caret to the previous bookmark.
|-
|[[Bookmarks|Next]]
|Moves the caret to the next bookmark.
|}

=== Extras ===
{|
|[[Open from FTP]]
|opens an existing document from an FTP site
|-
|[[Save to FTP]]
|saves an opened document to a specified file name on an FTP site
|-
|[[FTP Browser]]
|presents FTP/SFTP Browser
|-
|[[FTP Accounts|Accounts...]]
|shows or hides the FTP/SFTP Account Manager
|-
|[[Cloud sync|Cloud Services]]
|opens Cloud Services window where you can access cloud sync
|-
|Compare
|opens dialog for comparison of 2 or 3 files or folders with UltraCompare
|-
|UltraFinder
|invokes UltraFinder for Find files and Find duplicates operations
|-
|UltraFTP
|invokes UltraFTP for (S)FTP transfers
|}

=== Active file ===
{|
|Show in default app
|invokes default application to display active file
|-
|Copy path/name
|copies the full path and name of the active file to the clipboard
|-
|Delete
|Deletes the active file from disk. This command prompts you to confirm the file should really be deleted. If the file is deleted from the disk, it is no longer available. '''This is a permanent file-level delete (not a relocation to the Trash or Recycle Bin), so USE THIS COMMAND WITH CARE.'''
|-
|Rename
|Allows you to rename the active file by prompting you for the new name. Only the name should be entered, as the path will be the same as the existing path.
|-
|Email
|Attaches the active file to a new email message using your default email application. This feature is only supported on systems with an email application installed that supports MAPI.
|}

Cloud sync

2020-09-02T15:56:09Z

Idmadmin: Created page with "Category:Home tab Cloud sync in UltraEdit '''Cloud sync''' is a feature of [http..."

[[Category:Home tab]]

[[File:UltraEdit cloud sync.png|right|200px|alt=screenshot of cloud sync in UltraEdit|Cloud sync in UltraEdit]]

'''Cloud sync''' is a feature of [https://www.ultraedit.com/products/cloud-services.html Cloud Services], an optional add-on with subscription licenses. With cloud sync, you can share settings between multiple connected systems over the cloud. service that allows users to share settings and files between systems. You can open the cloud sync window by either clicking the '''Cloud services''' icon in the [[:Category:Home tab|Home tab]], or checking the '''Cloud services''' checkbox in the [[:Category:Layout tab|Layout tab]].

== Logging in ==
To use cloud sync, you must have a subscription license that includes Cloud Services, and then you must login with an existing identity provider (Google account, Github account, or Microsoft account). Use the same credentials on your other systems where you've activated the license.

== Syncing systems ==
The system on which you first log into cloud sync is set as "Master," meaning this is the system that you can push settings to the cloud from. All other systems you log into are considered secondary, meaning you can pull settings from Master onto them.

In the "Sync" tab on the '''Master''' system, you'll see a list of all syncable settings / files as well as a '''PUSH''' button at the bottom. Here you can check or uncheck the settings and categories you wish to sync to other systems. Once you click the '''PUSH''' button, these settings are pushed to the cloud.

Note that macros and scripts are synced ''only'' from the "Macro directory" and "Script directory" paths set in [[Settings:Cloud services|Settings » Cloud services]].

In the "Sync" tab on '''secondary''' systems, you'll see the same list of syncable settings as well as a '''PULL''' button at the bottom. You can check or uncheck the settings and categories you wish to sync on this system only. For example, even if the Master system has pushed all settings to the cloud, you might only want to sync the FTP / SSH accounts to this secondary system.

If a new sync is available on the cloud, a green notification will appear above the '''PULL''' button. Once you click the '''PULL''' button, all selected categories are synced down to the secondary system, overwriting the existing settings.

== Cloud contents ==
You can review what is currently on the cloud by clicking the "Cloud" tab. All categories are shown here as well as the origin system and the last time they were synced.

At the bottom of this list is a '''Delete Cloud Contents''' button where you can delete all settings, data, and files that are stored on the cloud with your sync account.

== Settings ==
You can click the "'''⚙'''" tab to access settings related to your sync systems:

'''Make Master'''<br>
This allows you to set the current system as Master. This button is unavailable if the system is already set as Master.

'''Edit Nickname'''<br>
This allows you to rename the current system within Cloud Services. By default the machine name is used, but providing a more descriptive name makes management of instances much easier.

'''Remove system'''<br>
This allows you to remove the current system from the sync account completely. This action will also sign you out of your sync account.

'''Reset system'''<br>
As shown in this button's caption, this option will reset the local system to the settings that are currently on the cloud. This is useful on the Master system, for example, where it's only possible to push settings to the cloud on the "Sync" tab. '''Caution:''' It's important to understand that this option is potentially destructive: With the '''PULL''' option, the local system's settings and data will never be overwritten with nothing (effectively deleted), however in the case of '''Reset System''', cloud sync ''will'' overwrite all local system settings to match the ''exact'' state of data and settings on the cloud. This means that if one settings category doesn't ''exist'' on the cloud, that category will be '''reset to defaults''' locally.

== Undoing a sync ==
All local settings are backed up each time you pull settings to a secondary system. If wish to undo a pull, you can access and restore from these backups by going to [[Settings:Cloud services|Settings » Cloud services]] and clicking the '''Restore from local backup''' button.

== Manage account ==
The cloud sync interface provides account management features. To see all instances (systems) in your sync account including which is Master, from the sync home, click the '''←''' button at the top left. To go back to the sync home, click the '''→''' icon next to your active system's name. You can also open the menu at top-left and click '''Sync Home'''.

Within the instances view, you can also click the '''⚙''' icon next to the current system name to jump to its settings page.

To see your user settings, open the menu at top-left and select "User Settings". Here you can delete your entire cloud account, reload (refresh) cloud sync, or sign out of your account on the active system.

<div class="idm-see-also">
See also:
* [[Settings:Cloud services|Settings » Cloud services]]
</div>

File:UltraEdit cloud sync.png

2020-09-02T15:48:03Z

Idmadmin: