| public static UpdateDoorsInfo ( System.Windows.Forms.Document doc, bool onlyUpdateSelect, bool showUpdateResultMessage, string &message ) : Autodesk.Revit.UI.Result | ||
| doc | System.Windows.Forms.Document | Revit project. |
| onlyUpdateSelect | bool | /// true means only update selected doors' information otherwise false. /// |
| showUpdateResultMessage | bool | /// this parameter is used for invoking this method in Application's events (document save and document saveAs). /// update door infos in Application level events should not show unnecessary messageBox. /// |
| message | string | |
| return | Autodesk.Revit.UI.Result | |
public static Autodesk.Revit.UI.Result UpdateDoorsInfo(Document doc, bool onlyUpdateSelect,
bool showUpdateResultMessage, ref string message)
{
if ((!AssignedAllRooms(doc)) && showUpdateResultMessage)
{
DialogResult dialogResult = MessageBox.Show("One or more eligible areas of this level " +
"have no assigned room(s). Doors bounding these areas " +
"will be designated as external doors. Proceed anyway?",
"Door Swing", MessageBoxButtons.YesNo);
if (DialogResult.No == dialogResult)
{
message = "Update cancelled. Please assign rooms for all eligible areas first.";
return Autodesk.Revit.UI.Result.Cancelled;
}
}
// begin update door parameters.
IEnumerator iter;
int doorCount = 0;
bool checkSharedParameters = false;
if (onlyUpdateSelect) // update doors in select elements
{
UIDocument newUIdoc = new UIDocument(doc);
iter = newUIdoc.Selection.Elements.GetEnumerator();
}
else // update all doors in current Revit project.
{
ElementClassFilter familyInstanceFilter = new ElementClassFilter(typeof(FamilyInstance));
ElementCategoryFilter doorsCategoryfilter = new ElementCategoryFilter(BuiltInCategory.OST_Doors);
LogicalAndFilter doorInstancesFilter = new LogicalAndFilter(familyInstanceFilter, doorsCategoryfilter);
iter = new FilteredElementCollector(doc).WherePasses(doorInstancesFilter).GetElementIterator();
}
iter.Reset();
while (iter.MoveNext())
{
// find door instance
FamilyInstance door = iter.Current as FamilyInstance;
if (onlyUpdateSelect)
{
if (null == door)
{
continue;
}
if (null == door.Category)
{
continue;
}
if (!door.Category.Name.Equals("Doors"))
{
continue;
}
}
// check if has needed parameters.
if (!checkSharedParameters)
{
checkSharedParameters = true;
if (!(door.Symbol.ParametersMap.Contains("BasalOpening") &&
door.ParametersMap.Contains("InstanceOpening") &&
door.ParametersMap.Contains("Internal Door")))
{
message = "Cannot update door parameters. Please customize door opening expression first.";
return Autodesk.Revit.UI.Result.Failed;
}
}
// get one door.
doorCount++;
// update one door's Opening parameter value.
if (UpdateOpeningFeatureOfOneDoor(door) == Autodesk.Revit.UI.Result.Failed)
{
message = "Cannot update door parameters. Please customize door opening expression first.";
return Autodesk.Revit.UI.Result.Failed;
}
// update one door's from/to room.
UpdateFromToRoomofOneDoor(door, false);
// update one door's internalDoor flag
UpdateInternalDoorFlagFeatureofOneDoor(door);
}
if (showUpdateResultMessage)
{
if (onlyUpdateSelect)
{
System.Windows.Forms.MessageBox.Show("Updated all selected doors of " + doc.Title +
" (" + doorCount + " doors).\r\n (Selection may " +
"include miscellaneous elements.)","Door Swing");
}
else
{
System.Windows.Forms.MessageBox.Show("Updated all doors of " + doc.Title + " (" +
doorCount + " doors).", "Door Swing");
}
}
return Autodesk.Revit.UI.Result.Succeeded;
}
/// <summary>
/// Implement this method as an external command for Revit.
/// </summary>
/// <param name="commandData">An object that is passed to the external application
/// which contains data related to the command,
/// such as the application object and active view.</param>
/// <param name="message">A message that can be set by the external application
/// which will be displayed if a failure or cancellation is returned by
/// the external command.</param>
/// <param name="elements">A set of elements to which the external application
/// can add elements that are to be highlighted in case of failure or cancellation.</param>
/// <returns>Return the status of the external command.
/// A result of Succeeded means that the API external method functioned as expected.
/// Cancelled can be used to signify that the user cancelled the external operation
/// at some point. Failure should be returned if the application is unable to proceed with
/// the operation.</returns>
public Autodesk.Revit.UI.Result Execute(ExternalCommandData commandData,
ref string message,
ElementSet elements)
{
Autodesk.Revit.UI.Result returnCode = Autodesk.Revit.UI.Result.Cancelled;
Transaction tran = new Transaction(commandData.Application.ActiveUIDocument.Document, "Initialize Command");
tran.Start();
try
{
// one instance of DoorSwingData class.
DoorSwingData databuffer = new DoorSwingData(commandData.Application);
using (InitializeForm initForm = new InitializeForm(databuffer))
{
// Show UI
DialogResult dialogResult = initForm.ShowDialog();
if (DialogResult.OK == dialogResult)
{
databuffer.DeleteTempDoorInstances();
// update door type's opening feature based on family's actual geometry and
// country's standard.
databuffer.UpdateDoorFamiliesOpeningFeature();
// update each door instance's Opening feature and internal door flag
returnCode = DoorSwingData.UpdateDoorsInfo(commandData.Application.ActiveUIDocument.Document, false, true, ref message);
}
}
}
catch (Exception ex)
{
// if there is anything wrong, give error information and return failed.
message = ex.Message;
returnCode = Autodesk.Revit.UI.Result.Failed;
}
if (Autodesk.Revit.UI.Result.Succeeded == returnCode)
{
tran.Commit();
}
else
{
tran.RollBack();
}
return(returnCode);
}
