Se si intende utilizzare il codice di esempio SDK per le macro, è necessarie effettuare alcune modifiche.
Revit SDK include due cartelle di esempi:
\Revit SDK <release>\Software Development Kit\Samples\...
\Revit SDK <versione>\Software Development Kit\Macro Samples\...
Nei programmi che si trovano nella cartella \Samples\ di SDK viene utilizzata l'API standard di Revit. In questo documento tali esempi vengono identificati come codice di esempio SDK per distinguerli dagli esempi di Revit Macro.
Seguire le procedure riportate in questa sezione. Il linguaggio di programmazione a cui si fa riferimento è C#. Tuttavia, queste istruzioni sono valide anche per le versioni VB.NET degli esempi SDK.
Procedura iniziale
La procedura iniziale per la migrazione di esempi API standard da SDK al progetto di Revit Macro IDE è simile a quella descritta nella sezione Integrazione di macro in Revit IDE. La sola differenza è rappresentata dal fatto che anziché copiare i file dalle cartelle \Macro Samples\<nome-esempio>\... di SDK, è necessario copiarli dalle cartelle \Samples\<nome-esempio>\... di SDK.
La procedura è la seguente:
- In IDE, aggiungere i riferimenti necessari.
- In IDE, creare le cartelle per gli esempi SDK che si intende migrare.
- In Esplora risorse, copiare i file degli esempi API standard di SDK nelle cartelle del file system corrispondenti.
- In IDE, aggiungere i file esistenti al progetto macro.
Aggiornamento del codice degli esempi SDK
In Revit Macro IDE, l'interfaccia IExternalCommand non è disponibile né utilizzata. Nel codice di esempio API standard di SDK, è necessario aggiornare la classe ereditata da tale interfaccia:
- Rimuovere i parametri di metodo e il valore restituito con il metodo Execute
- Aggiornare altro codice relativo a ExternalCommandData.
Esempio di codice prima delle modifiche
Il seguente frammento di codice è quello di un programma che utilizza l'API di Revit standard:
Esempio di codice dopo le modifiche
In Revit Macro IDE, è necessario aggiornare il codice come descritto di seguito. L'esempio è relativo ad una macro a livello di applicazione. In questo esempio di macro viene utilizzato il metodo RunSampleRooms(). Osservare l'utilizzo del puntatore this in sostituzione di commandData.Application.
Ulteriori note sulla migrazione per gli esempi API standard di SDK
- Per default, il namespace degli esempi SDK è Revit.SDK.Samples.<SampleName>.CS. Quando si modifica il codice di esempio degli esempi API standard di SDK, assicurarsi di modificare lo spazio dei nomi per Revit IDE. Ad esempio, in ThisApplication.cs:
namespace AppCSharp.csproj
- I progetti di Revit IDE includono solo riferimenti di default di base, ad esempioRevit.Proxy. Ricordarsi di aggiungere gli altri riferimenti necessari. Per esempio, è necessario aggiungere riferimenti System.Windows.Forms e System.Drawing quando si eseguono esempi che presentano un'interfaccia utente.
- Alcuni di questi, tra cui GridCreation, includono risorse che devono essere definite nel file resources.resx. Se si esegue la migrazione dell'esempio API standard di SDK per GridCreation in Revit IDE, assicurarsi di impostare la proprietàresx.
- La dipendenza da generazione di progetto non è supportata in Revit Macro IDE. Se si intende utilizzare altre DLL, quel progetto di esempio dipendente non deve essere compilato all'interno di Revit Macro IDE. Vari esempi API standard di SDK sono correlati a visualizzatori, come AnalyticalViewer e RoomViewer, che dipendono dai riferimenti a RevitViewer.
Nell'esempio non è tuttavia possibile impostare la dipendenza di progetto a causa di un limite di Revit IDE e non è possibile migrare l'esempio RevitViewer. Di conseguenza, è necessario compilare RevitViewer come esempio SDK indipendente e quindi aggiungere la relativa DLL come riferimento nel progetto Revit IDE.
- Quando si esegue la migrazione degli esempi API standard di SDK in Revit IDE, non i copiare file di soluzione (*.sln*) o i file di progetto esistenti (*.csproj o *.vbproj).
- Esempi correlati alla barra degli strumenti non sono disponibili in Revit IDE.