| Control | pyRevit Function | Purpose | |---------|----------------|---------| | TextBox | forms.TextBox | Single-line text/number input | | ComboBox | forms.Combobox | Dropdown selection | | ListBox | forms.ListBox | Multi-item selectable list | | CheckBox | forms.CheckBox | Boolean option | | RadioButton | forms.RadioButton | Mutually exclusive options | | Button | forms.Button | Action trigger |
These forms are highly effective for choosing specific Revit elements from a list: pyrevit forms
Comprehensive Guide to pyRevit Forms pyRevit is a submodule designed to simplify the creation of User Interfaces (UI) within the Autodesk Revit environment. It allows developers to quickly gather user input through pre-built dialogs or custom-designed Windows Presentation Foundation (WPF) windows. Standard Input Forms | Control | pyRevit Function | Purpose |
Here is how easy it is to let a user pick multiple sheets from a searchable list in just a few lines: You write a killer script that automates a
| Practice | Rationale | |----------|-----------| | – one task per dialog | Reduces user error | | Provide defaults | Speeds repetitive tasks | | Validate early | Prevents API exceptions | | Use progress bars for >2s operations | Manages user expectations | | Make dialogs cancellable | Allows graceful exit | | Match Revit terminology | Familiarity & consistency | | Test with high DPI scaling | Ensures readability |
with forms.ProgressBar(title="Processing", cancellable=True) as pb: for i, element in enumerate(elements): if pb.cancelled: break pb.update_progress(i, len(elements)) # Process element
We’ve all been there. You write a killer script that automates a tedious task, but the user interaction is stuck in the year 2005.
