Properties page

From Appmethod Topics
Jump to: navigation, search

Go Up to Object Inspector

The Properties page of the Object Inspector enables you to set design-time properties for components on your form, and for the form itself. By setting properties at design time you are defining the initial state of a component. You can set runtime properties by writing source code within event handlers.

The Properties page displays the properties of the component that is selected on the form.

If the Properties are arranged by name (the default), the first column on the Property page lists the names of the selected component’s published properties as follows:

  • If a plus sign (+) appears beside a property name, you can click the (+) to display the subproperties of that property. The list can include the possible values when the property represents a set of flags (the value column lists the set enclosed in square brackets []), or subproperties if the property represents an object (the value column gives the name of the object, enclosed in parentheses).
  • Similarly, if a minus sign (-) appears, you can click the (-) to collapse the subproperties. When a property has focus, you can also use the keyboard + and – keys to expand or collapse properties.

The second column on the Property page displays the property values as follows:

  • When the property is selected, the value changes to an edit control where you can type a new value.
  • If the value can be set using a dialog, an Ellipsis ellipsis button appears when the property is selected. Click this button to display a dialog where you can set the property. You can also display the dialog by double-clicking the value column.
  • If the value is an enumerated type, a ProjectOptionsDownArrow2.jpg drop-down button appears when the property is selected. Click this button to display a drop-down list that you can use to set the property. You can see images in the drop-down lists for properties that include images such as cursors, brush types, colors, and image lists. To view images referenced by the ImageIndex property, you need to set the property that holds the image list to the image list containing the images.
  • If the value is another component, you can shift the Object Inspector's focus to that component by holding down the Ctrl key while double-clicking. For example, if the DataSet property of a data source is set to Table1, Ctrl-double-click on Table1 in the value column displays Table1's properties in the Object Inspector.

If you arrange the properties by category (right-click, Arrange | by Category), the categories are listed alphabetically. You can view properties associated with each category by clicking the + sign. For more information, see Property and event categories in the Object Inspector.

The Properties page displays the properties of the selected component. For more information, see How the Object Inspector Displays Properties.

Properties that are dark red in color by default are component references, which are properties that can be components as well.

See Also