Sunday, May 29, 2022

Name property

Applies to

AccessObject Object

CodeProject Object

Form Object

ObjectFrame Object

Reference Object

SubForm Object

AccessObjectProperty Object

ComboBox Object

Image Object

OptionButton Object

Report Object

TabControl Collection

AdditionalData Object

CommandButton Object

Label Object

OptionGroup Object

Section Object

TextBox Object

Application Object

CurrentProject Object

Line Object

Page Object

SmartTag Object

ToggleButton Object

BoundObjectFrame Object

CustomControl Object

ListBox Object

PageBreak Object

SmartTagAction Object

CheckBox Object

DataAccessPage Object

Module Object

Rectangle Object

SmartTagProperty Object

You can use the Name property to specify or determine the string expression that identifies the name of an object. Read/write String for the following objects: AdditionalData, BoundObjectFrame, CheckBox, ComboBox, CommandButton, CustomControl, Form, Image, Label, Line, ListBox, Module, ObjectFrame, OptionButton, OptionGroup, Page, PageBreak, Rectangle, Report, Section, SmartTagProperty, SubForm, TabControl, TextBox, and ToggleButton. Read-only String for the following objects: AccessObject, AccessObjectProperty, Application, CodeProject, CurrentProject, DataAccessPage, Reference, SmartTag, and SmartTagAction.

expression.Name

expression Required. An expression that returns one of the above objects.

Remarks

A valid name must conform to the standard naming conventions for Microsoft Office Access 2007. For Microsoft Access objects, the name may be up to 64 characters long. For controls, the name may be as long as 255 characters.

For new objects, set the Name property by clicking Save on the Quick Access Toolbar and entering a valid name. To change the name of an existing object in the Navigation pane, right-click the name, then click Rename. To change the name of an existing object when the object is open, click Save As on the Quick Access Toolbar.

For a section or control, you can set this property by using the property sheet, a macro, or Visual Basic for Applications (VBA) code. You can use the Name property in expressions for objects.

The default name for new objects is the object name plus a unique integer. For example, the first new form is Form1, the second new form is Form2, and so on. A form can't have the same name as another system object, such as the Screen object.

For an unbound control, the default name is the type of control plus a unique integer. For example, if the first control you add to a form is a text box, its Name property setting is Text1.

For a bound control, the default name is the name of the field in the underlying source of data. If you create a control by dragging a field from the field list, the field's FieldName property setting is copied to the control's Name property box.

You can't use "Form" or "Report" to name a control or section.

Controls on the same form, report, or data access page can't have the same name, but controls on different forms, reports or data access pages can have the same name. A control and a section on the same form can't share the same name.

Example

The following example returns the Name property for the first form in the Forms collection.

Dim strFormName As String

strFormName = Forms(0).Name

No comments:

Post a Comment