Lo primero de lo que debemos ser conscientes es que con la API de Revit se pueden hacer b\u00e1sicamente dos tipos de Add-ins: Aplicaciones Externas y Comandos Externos. La diferencia b\u00e1sica entre ambas es el momento en que se ejecuta el c\u00f3digo que contienen.<\/p>\n
En las Aplicaciones externas, el c\u00f3digo se ejecuta al abrir Revit y durante el tiempo en que \u00e9ste est\u00e9 abierto, por lo que este tipo de Add-in ser\u00e1 \u00fatil para generar nuestros propios botones en la interface de Revit y gestionar eventos que se produzcan mientras trabajamos en el programa (un evento es, por ejemplo, la creaci\u00f3n de un nuevo elemento, la aparici\u00f3n de un mensaje de advertencia, etc).<\/p>\n
Por otra parte, el c\u00f3digo contenido en los Comandos Externos se ejecuta \u00fanicamente cuando \u00e9ste es invocado. Por tanto, este tipo de Add-in es adecuado cuando queremos realizar acciones sobre nuestro documento de Revit en un momento determinado (por ejemplo: seleccionar todas las columnas visibles en una vista).<\/p>\n
Comenzaremos por generar un Comando Externo que seleccione todas las columnas presentes en la vista que tenemos activa y nos muestre el recuento de estas. Partiendo del nuevo proyecto de MS Visual C# con las referencias de Revit cargadas, el siguiente paso es invocar los Namespaces<\/a> que vamos a necesitar. En este caso los Namespaces son: Autodesk.Revit.DB y Autodesk.Revit.UI. Vamos a llamar al comando “SelectorCol” y para definirlo como tal emplearemos “:IExternalCommand”. Al namespace en el que estar\u00e1 incluido lo llamamos “SeleccionColumnas”. Adem\u00e1s vamos a definir que las transacciones est\u00e9n en modo autom\u00e1tico.\u00a0Las transacciones son \u00a0elementos que nos permiten realizar modificaciones en el modelo (cambiar estilos de l\u00edneas, cambiar tipos, crear elementos, etc) y, de momento, con saber que existen es suficiente.<\/p>\n Una vez hecho esto, podemos generar la estructura b\u00e1sica del comando haciendo click con el bot\u00f3n derecho encima de “IExternalCommand” \u00a0y seleccionando -> Implement Interface -> Implement Interface. Se nos generar\u00e1n las l\u00edneas de c\u00f3digo que definen el espacio en el que podemos definir las acciones a realizar por el comando. Podemos suprimir ”\u00a0throw new NotImplementedException();\u00a0” y sustituirla por “return Result.Succeeded;”.\u00a0De los tres inputs que contiene la interface generada, el que m\u00e1s nos va a interesar es “commandData”, pues de \u00e9l podemos extraer informaci\u00f3n del modelo. Vamos a crear una variable de clase “Document” que contenga el documento que tenemos abierto en Revit al ejecutar el Plug-In y otra variable de clase “View” que contenga la vista activa. A ambas se accede desde commandData, pero una vez creada la variable “documentoAbierto” podemos acceder a la vista activa desde \u00e9sta.<\/p>\n El siguiente paso es crear una lista que contenga todas las columnas visibles en la vista en la que nos encontramos. Para ello necesitaremos incluir el namespace “System.Collections.Generic” junto con el resto de namespaces, ya que en \u00e9l est\u00e1n contenidas las clases de tipo “lista”. Para seleccionar las columnas emplearemos un filtro de selecci\u00f3n “FilteredElementCollector” al que debemos darle como input el documento y la vista sobre la que queremos aplicar el filtro. Adem\u00e1s debemos usar el m\u00e9todo “OfCategory”, que nos permite discriminar seg\u00fan la categor\u00eda del elemento. Por \u00faltimo, emplearemos el m\u00e9todo “ToElements” para que el filtro devuelva la lista de elementos. En definitiva, esto ser\u00eda:<\/p>\n Para seleccionar las columnas, debemos incluir en la selecci\u00f3n del ActiveUIDocument cada uno de los elementos incluidos en la lista creada. Para ello, se ha creado un bucle “foreach”. El acceso a la selecci\u00f3n se realiza por medio del\u00a0ActiveUIDocument, es decir: \u00a0“commandData.Application.ActiveUIDocument.Selection”. A\u00f1adidos los elementos a la selecci\u00f3n, s\u00f3lo queda hacer el recuento de las columnas y mostrar en pantalla el resultado. Para lo primero, se crea una variable tipo string que contendr\u00e1 el recuento de elementos de la lista columnasEnVista. \u00a0Para lo segundo, es necesario crear un “TaskDialog” que muestre el texto que queremos que acompa\u00f1e al recuento de columnas y la variable creada para contener el n\u00famero de columnas. Con el m\u00e9todo “TaskDialog.Show” en el primer input introducimos el encabezado de la ventana y en el segundo el contenido principal de la ventana.<\/p>\n Una vez hecho esto, nuestro c\u00f3digo deber\u00eda tener un aspecto similar a este:<\/p>\n Tras haber definido las acciones a realizar por nuestra aplicaci\u00f3n, queda compilar el c\u00f3digo para generar el archivo de extensi\u00f3n .dll que emplear\u00e1 Revit. Para ello, en el MS Visual C# vamos al men\u00fa Build y seleccionamos “Build SeleccionColumnas” (es decir, Build + Nombre de la soluci\u00f3n en la que estemos trabajando). Se generar\u00e1 entonces el archivo .dll en la subcarpeta binRelease ubicada en la misma ruta que el archivo de MS VIsual C# en el que estamos trabajando (que por defecto ser\u00e1 el definido por MS Visual C#:<\/p>\n “C:UsersTU_NOMBRE_DE_USUARIODocumentsVisual Studio 2010ProjectsSeleccionColumnasSeleccionColumnas”.<\/p>\n Por \u00faltimo, es necesario crear un “manifest file” que d\u00e9 a Revit las se\u00f1as b\u00e1sicas de la aplicaci\u00f3n que hemos creado. Este archivo puede crearse a con el block de notas, cambiando posteriormente su extensi\u00f3n. El archivo tiene el siguiente aspecto:<\/p>\n Puesto que hemos implementado un comando, en el “AddIn Type” tendr\u00e1 que ser Command. En “Assembly” debemos especificar la ruta en la que se encuentra el .dll generado al compilar en Visual Studio. Para el AddInId debemos emplear un GUID<\/a> que podemos generar con “guidgen.exe” una aplicaci\u00f3n para generar guids que trae por defecto Visual C#.<\/p>\n En FullClassName debemos especificar el camino hasta el comando, que en nuestro caso ser\u00e1 SeleccionColumnas.SelectorCol (que indica el namespace en el que est\u00e1 incluido el comando y el nombre del mismo.<\/p>\n Por \u00faltimo, tenemos tres campos relativos a la descripci\u00f3n del Addin: “Text” (que indica el texto que mostrar\u00e1 el bot\u00f3n de nuestro comando), “Vendor” (es un campo a rellenar que no tiene incidencia en la interface) y “Description”(contiene la informaci\u00f3n que se mostrar\u00e1 cuando el cursor se quede encima del bot\u00f3n sin pulsarlo).<\/p>\n Si has llegado hasta aqu\u00ed, puede que te interese descargar el archivo enlazado aqu\u00ed<\/a>, que contiene los ficheros de Microsoft Visual Studio y el manifest file para su descarga y consulta.<\/p>\nusing System;\r\nusing System.Collections.Generic;\r\nusing Autodesk.Revit.DB;\r\nusing Autodesk.Revit.UI;\r\n\r\nnamespace SeleccionColumnas\r\n{\r\n\t[Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Automatic)]\r\n\r\n\tpublic class SelectorCol:IExternalCommand\r\n\t{\r\n\r\n\t}\r\n\r\n}\r\n<\/pre>\nusing System;\r\nusing System.Collections.Generic;\r\nusing Autodesk.Revit.DB;\r\nusing Autodesk.Revit.UI;\r\n\r\nnamespace SeleccionColumnas\r\n{\r\n\t[Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Automatic)]\r\n\r\n\tpublic class SelectorCol:IExternalCommand\r\n\t{\r\n\t\tpublic Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)\r\n\t\t{\r\n\t\t\tDocument documentoAbierto = commandData.Application.ActiveUIDocument.Document;\r\n\t\t\tView vistaActiva = documentoAbierto.ActiveView;\r\n\t\t\treturn Result.Succeeded;\r\n\t\t}\r\n\t}\r\n}\r\n<\/pre>\n \r\nIList columnasEnVista = new FilteredElementCollector(documentoAbierto, vistaActiva.Id).OfCategory(BuiltInCategory.OST_StructuralColumns).ToElements();\r\n<\/pre>\n
using System;\r\nusing System.Collections.Generic;\r\nusing Autodesk.Revit.DB;\r\nusing Autodesk.Revit.UI;\r\n\r\nnamespace SeleccionColumnas\r\n{\r\n\t[Autodesk.Revit.Attributes.Transaction(Autodesk.Revit.Attributes.TransactionMode.Automatic)]\r\n\r\n\tpublic class SelectorCol:IExternalCommand\r\n\t{\r\n\t\tpublic Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)\r\n\t\t{\r\n\t\t\tDocument documentoAbierto = commandData.Application.ActiveUIDocument.Document;\r\n\t\t\tView vistaActiva = documentoAbierto.ActiveView;\r\n\r\n\t\t\t\/\/Filtro de selecci\u00f3n y almacenamiento de todas las columnas\r\n\t\t\tIList columnasEnVista = new FilteredElementCollector(documentoAbierto, vistaActiva.Id).OfCategory(BuiltInCategory.OST_StructuralColumns).ToElements();\r\n\r\n\t\t\t\/\/A\u00f1adimos a la selecci\u00f3n todas las columnas almacenadas en columnasEnVista para que queden resaltadas una vez termine el comando\r\n\t\t\tforeach (Element el in columnasEnVista)\r\n\t\t\t{\r\n\t\t\t\tcommandData.Application.ActiveUIDocument.Selection.Elements.Add(el);\r\n\t\t\t}\r\n\r\n\t\t\t\/\/Recuento del n\u00famero de columnas presentes en la vista\r\n\t\t\tstring numeroColumnas = columnasEnVista.Count.ToString();\r\n\r\n\t\t\t\/\/Mostramos un cuadro con la informaci\u00f3n recogida\r\n\t\t\tTaskDialog.Show(\"MODELICAL\", \"Mi primera aplicaci\u00f3n que cuenta el n\u00famero de columnas en esta vista nn N\u00famero de columnas en la vista: \" + numeroColumnas);\r\n\r\n\t\t\treturn Result.Succeeded;\r\n\t\t}\r\n\t}\r\n}\r\n<\/pre>\n\r\n\r\nC:UsersGizenemDocumentsVisual Studio 2010ProjectsSeleccionColumnasSeleccionColumnasbinReleaseSeleccionColumnas.dll\r\n137DABDC-2B70-4807-A9F9-3C64EEE3AC14\r\nSeleccionColumnas.SelectorCol\r\n Cuenta Columnas\r\nModelical\r\nTutorial para hacer tu primera aplicaci\u00f3n que cuenta columnas\r\n<\/pre>\n
![\"IMG](\"https:\/\/www.modelical.com\/wp-content\/uploads\/2014\/01\/IMG-4.png\")
<\/p>\n