Browsing Property Updates

Use the Property Updates Browser to view where a property is being updated in the code.

The Property Update Browser Options pane enables you to configure preferences and filter settings for searching within the Property Updates Browser. For details, see "Browser Options Pane", later in this chapter.

To open the Property Updates Browser for a property

Select the property in the Properties List and then select the Property Updates Browser command from the Properties menu.
Right‑click on a property in the Properties List and then select the Property Updates Browser command from the popup menu that is then displayed.

The Property Updates Browser is then displayed at the right of the Editor pane, as shown in the following image.

The Property Updates tab is displayed if you have multiple‑sheet functionality enabled. For details, see "Displaying Multiple Sheets in the Editor Pane", earlier in this chapter.

Any property updates are displayed in a hierarchical list in the Property Updates Browser, allowing you to track the property update chain to the origin.

If you view the property updates for a different property, the details are displayed in another sheet in the Property Updates Browser. Click the tab of the sheet whose property updates you want to view. To close a sheet, right‑click on that tab and then select the Close Tab command from the popup menu that is displayed. Alternatively, middle‑click with your mouse on that tab.

Select an element in the hierarchy list to display details in a read‑only editor; for example, if you select a property, its details are displayed and if you select a method, the editor displays where the property is updated.

In the hierarchy list, property updates are displayed as children of the selected entry. If you expand an entry, the search continues until the maximum depth is met, the maximum results are met, or an end node is met.

Click the Expand all nodes button at the right of the Property Updates Browser to expand all of the nodes in the property updates hierarchy list.

To search the property update list that you are currently viewing

In the Search Property Updates search box, enter some or all of the text for which you want to search.
Click the Search button or press Enter.

Elements in the property update list that contain the text are then highlighted using the Selection Background color specified on the Editor sheet of the User Preferences dialog (for details, see "Maintaining the Editor Display", in Chapter 2). In addition, the status line displays the search term and the number of matching results. If no match is found, (not found) is displayed at the right of the search term in the status bar.

Click the Refresh button to clear the current list box and perform the same search again. This is useful if the view of the first search is now outdated (as a result of class, method, property or schema deletions).

The following table lists the commands that can be displayed when you right‑click on an element in the Property Updates Browser list.

Command	Opens...
Begin new search	A new sheet in the Property Updates Browser with the selected property as the root object. This command is available only if a property is selected.
References	The References window for the selected property or method.
Update References	The Update References window for the selected property.
Read References	The Read References window for the selected property.
Implementors	The Implementors window for the selected method.
Implementor References	The Implementors References window for the selected method.
Open in new browser	A new Property Updates Browser and selects that property or method.

The commands that are displayed depend on the selected element. If the selected element is a local variable or a literal, only the Begin new search and Open in new browser commands are displayed and they are disabled.

Click the Menu button at the upper left of the Property Updates Browser and then select one of the following commands as required.

Clear, to clear the all of the property updates from the Property Updates Browser.
Close, to close the Property Updates Browser. Alternatively, middle‑click with your mouse on the browser tab.
Extract to file, to extract your current view to a text file (.txt) file.

The file name has the format PropertyUpdates_<schema‑name>-<class‑name>-<property‑name>.txt; for example:
```
PropertyUpdates_ErewhonModelSchema-AddressTA-fax.txt
```
Copy, to copy your current view to the clipboard.

2025.0.01 and higher