Sign in Join
Wiki copytemporary

IDE Window: Object Inspector: what changed

Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.

Title: IDE Window: Object Inspector

OldNewLine
1+## Contents
2+
3+ * 1 Object Inspector
4+ * 2 Keyboard Shortcuts
5+ * 3 Object Inspector Popup Menu
6+ * 3.1 Set to default
7+ * 3.2 Add to Favorites
8+ * 3.3 View restricted properties
9+ * 3.4 Undo
10+ * 3.5 Jump to declaration of...
11+ * 3.6 Show Component Tree
12+ * 3.7 Show Property Filter
13+ * 3.8 Show hints
14+ * 3.9 Show Information Box
15+ * 3.10 Show Status Bar
16+ * 3.11 Options
17+
18+# Object Inspector
19+
20+[![ObjectInspectormacOS.png](/wiki-images/b/ba/ObjectInspectormacOS.png)](</File:ObjectInspectormacOS.png>)
21+
22+The "Object Inspector" window allows you to explore and edit the properties of objects. Objects here are TPersistent descendants like a TForm or a TButton or a TOpenDialog.
23+
24+On the top there is a tree showing the components of the currently edited designer form (or datamodule or frame or whatever).
25+
26+The biggest part of the Object Inspector are the 3 property grids called 'Properties', 'Events' and 'Favorites'. Each property grid show a subset of the published properties of the selected components.
27+
28+The Object Inspector is a useful tool for debugging your own programs. How to add the Object Inspector to your own programs is demonstrated in examples/objectinspector.
29+
30+# Keyboard Shortcuts
31+
32+Shortcut | Description
33+---|---
34+Up, Down | Navigate rows
35+Alt + Left | Collapse level
36+Alt + Right | Expand level
37+Ctrl + Enter | Cycle enumerated values
38+
39+You can use keyboard for fast Property Name search and edit.
40+
41+Let's assume you want to modify Form's Caption and Width properties
42+```
43+- Click Form.
44+ - Go to Object inspector (caret is on Property Value column).
45+ - Press Tab to switch to Property Name column (caret will disappear from Value column).
46+ - Type "caption". Property row "Caption" will be found.
47+ - Press Tab or Enter to go to Property Value and edit it.
48+```
49+```
50+- Press Tab to switch to Property Name column again.
51+ - Type "width". Width row will be found.
52+ - Press Tab or Enter and edit it.
53+```
54+
55+If you misspelled property name you can press Esc and retype it. Or you can use Backspace to remove few last chars.
56+
57+# Object Inspector Popup Menu
58+
59+[![ObjectInspectorPopupMenu.png](/wiki-images/6/65/ObjectInspectorPopupMenu.png)](</File:ObjectInspectorPopupMenu.png>)
60+
61+Right-click in the Properties tab of the Object Inspector to get the Object Inspector's Popup Menu. The items on the Popup Menu are described below.
62+
63+## Set to default
64+
65+Set the property value to the default value. For example:
66+```
67+property Position: TPosition read FPosition write SetPosition default poDesigned;
68+```
69+
70+Here poDesigned is the default.
71+
72+Note: Not every property has a default value. Default values defined by the **stored** functions are ignored by this function.
73+
74+## Add to Favorites
75+
76+Add the property to the Favorites tab of the Object Inspector.
77+
78+## View restricted properties
79+
80+Opens the [[IDE Window: Restriction Browser|Restriction Browser]].
81+
82+## Undo
83+
84+Discard changes to the property edit field and restore the value of the current property. Do not confuse this with the value from the disk.
85+
86+## Jump to declaration of...
87+
88+Jump to the source declaration of the property. This will be the last one. For example TForm.Left is published in the class TForm and defined in TControl. You can jump easily to the other declaration, by doing a find declaration on the name again and again, until you are the lowest definition (Alt+Up or Ctrl+LeftClick). You can jump back with Ctrl+H.
89+
90+## Show Component Tree
91+
92+Show or hide the component tree at the top of the Object Inspector.
93+
94+## Show Property Filter
95+
96+Show or hide the Properties (filter) edit field above the Properties tab of the Object Inspector.
97+
98+## Show hints
99+
100+Enable or disable the showing of hints. Hints are shown, when the mouse stops for a few seconds over a property.
101+
102+## Show Information Box
103+
104+Enable or disable the showing of the yellow background Information Box at the bottom of the Object Inspector. The Information Box describes the currently highlighted property and may contain links to related properties and the package to which the component belongs. If the box is not big enough to show the full description, it can be scrolled.
105+
106+## Show Status Bar
107+
108+Enable or disable the showing of the Status Bar on the last line at the bottom of the Object Inspector.
109+
110+## Options
111+
112+Configure some options of the Object Inspector including the colours used.
113+
114+---
115+*From the Free Pascal wiki, page "IDE Window: Object Inspector", as the Internet Archive kept it on 2024-01-21. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).*

Back to history