Skip to content

Creating Live Templates

Los Code Templates o Plantillas de Códigos, fueron agregados al IDE, allá por la versión 3 de Delphi y C++ Builder (año 1998) junto a las nuevas características de Code Insight.

Estas nuevas características fueron agregadas para impulsar la productividad del programador, aunque en sus comienzos, las plantillas de códigos se pasaban por alto, se comenzaron a utilizar al convertirse en Live Templates.

Actualmente, es normal que todo IDE de programación posean sus Live Templates, por lo que no todo programador sabe es que en Delphi podemos crear nuestras propias Live Templates.

Crear Live Templates

Para crear un Live Template en Delphi vamos al menú File->New->Other Se nos abrirá la ventana New Items y sobre el panel izquierdo seleccionamos Other y sobre el panel derecho seleccionamos Code Template.

Presionamos el botón Ok y Delphi nos creará automáticamente el Template como mostramos a continuación:

<?xml version="1.0" encoding="utf-8" ?>
<codetemplate	xmlns="http://schemas.borland.com/Delphi/2005/codetemplates"
				version="1.0.0">
	<template name="" invoke="manual">
		<description>

		</description>
		<author>

		</author>
		<code language=""><![CDATA[]]>
		</code>
	</template>
</codetemplate>

Completando campos de Live Template xml

Los campos que debemos completar son los siguientes:

name

Como su nombre lo indica, es el nombre de la plantilla, la palabra clave con la cual se invoca al Template

invoke

manual = se invoca presionando Tab

auto = se invoca presionando Space o Tab

none = se invoca con Ctrl + J, Ctrl + Space o con la ventana Template

description

Ingresamos una descripción del Template solo para saber de que trata

author

Su nombre lo dice todo, autor del Template

Point Name

Luego del Autor, debemos agregar los Point Name, tantos como necesitemos, en la plantilla inicial no figuran, pero es muy simple anexarlos, simplemente presionamos Ctrl + J y se anexará la plantilla correspondiente como mostramos a continuación:

<?xml version="1.0" encoding="utf-8" ?>
<codetemplate	xmlns="http://schemas.borland.com/Delphi/2005/codetemplates"
				version="1.0.0">
	<template name="" invoke="manual">
    
		<description>

		</description>
		<author>

		</author>

     <point name="PointName">
         <text>
             PointName
         </text>
         <hint>
             PointHint
         </hint>
     </point>
        
		<code language=""><![CDATA[]]>
		</code>
	</template>
</codetemplate>

Por cada Point, se definen atributos como el Name, el Text (la descripción que se muestra en la ventana de plantillas) y un Hint (que aparece cuando pasa el mouse sobre una plantilla en la ventana de plantillas)

code language

En el code language, deberemos completar el lenguaje de programación al cual estará preparada la plantilla, como por ejemplo Delphi, C, XML, HTML, etc. (cualquier lenguaje que soporte el IDE).

<![CDATA[]]>

Dentro de los corchetes anidados de la sentencia CDATA, deberemos escribir el código del Template. Dicho código queda a su entera imaginación para crear la plantilla que desees. Te dejamos un ejemplo de la plantilla If que seguramente as utilizado hasta el artazgo:

<?xml version="1.0" encoding="utf-8" ?>

<codetemplate	xmlns="http://schemas.borland.com/Delphi/2005/codetemplates"
				version="1.0.0">
	<template name="ifb" surround="true" invoke="manual">
		<point name="expr">
			<script language="Delphi">
				InvokeCodeCompletion;
			</script>
			<hint>
				conditional expression
			</hint>
			<text>
				True
			</text>
		</point>
		<description>
			if statement
		</description>
		<author>
			Embarcadero
		</author>
		<code language="Delphi" context="methodbody" delimiter="|"><![CDATA[if |expr| then
begin
|selected||*||end|
end;]]>
		</code>
	</template>
</codetemplate>

Donde guardar el Template

Para que el template comience a funcionar, lo deberemos guardar en <path de instalación>\ObjRepos\en\Code_Templates\<lenguaje>

Delphi

<path de instalación>\ObjRepos\en\Code_Templates\delphi

HTML

<path de instalación>\ObjRepos\en\Code_Templates\HTML

XML

<path de instalación>\ObjRepos\en\Code_Templates\XML

Si necesitas más información, puedes consultar el siguiente link https://delphi.fandom.com/wiki/Live_Templates_Technical_Info