/// <summary>
/// This method implements the external command within
/// Revit.
/// </summary>
/// <param name="commandData">An ExternalCommandData
/// object which contains reference to Application and
/// View needed by external command.</param>
/// <param name="message">Error message can be returned
/// by external command. This will be displayed only if
/// the command status was "Failed". There is a limit
/// of 1023 characters for this message; strings longer
/// than this will be truncated.</param>
/// <param name="elements">Element set indicating
/// problem elements to display in the failure dialog.
/// This will be used only if the command status was
/// "Failed".</param>
/// <returns>The result indicates if the execution
/// fails, succeeds, or was canceled by user. If it
/// does not succeed, Revit will undo any changes made
/// by the external command.</returns>
Result IExternalCommand.Execute(
ExternalCommandData commandData, ref string message
, ElementSet elements)
{
ResourceManager res_mng = new ResourceManager(
GetType());
ResourceManager def_res_mng = new ResourceManager(
typeof(Properties.Resources));
Result result = Result.Failed;
try {
UIApplication ui_app = commandData?.Application
;
UIDocument ui_doc = ui_app?.ActiveUIDocument;
Application app = ui_app?.Application;
Document doc = ui_doc?.Document;
/* Wrap all transactions into the transaction
* group. At first we get the transaction group
* localized name. */
var tr_gr_name = UIBuilder.GetResourceString(
GetType(), typeof(Properties.Resources),
"_transaction_group_name");
using (var tr_gr = new TransactionGroup(doc,
tr_gr_name)) {
if (TransactionStatus.Started == tr_gr
.Start())
{
/* Here do your work or the set of
* works... */
if (DoWork(commandData, ref message,
elements))
{
tr_gr.Assimilate();
tr_gr.Commit();
result = Result.Succeeded;
}
else
{
tr_gr.RollBack();
}
}
}
}
catch (Exception ex) {
TaskDialog.Show(def_res_mng.GetString("_Error")
, ex.Message);
result = Result.Failed;
}
finally {
res_mng.ReleaseAllResources();
def_res_mng.ReleaseAllResources();
}
return(result);
}
