How to Use Collection Array Property for Object Container

• Microsoft Visual FoxPro for Windows, version 3.0

SUMMARY

In Visual FoxPro, all the object containers in a form have a collection property associated with them. The collection property is an array that references each container object. You can reference properties and methods by using the collection array property rather than a specific object name.

For example, the collection array property for a CommandGroup button is buttons(). The following example changes the caption of the first command button in the CommandGroup named CommandGroupName:

    CommandGroupName.Buttons(1).Caption = "New"

MORE INFORMATION

The following table lists the object containers that create an array property when the object containers are created.

   Object Container       Collection Property
   ------------------------------------------
   Formsets               Forms
   Forms                  Controls
   PageFrame              Pages
   Page                   Controls
   CommandGroup           Buttons
   OptionGroup            Buttons
   Grid                   Controls
   Column                 Controls

'Collection Properties'.

Sample Code

The following example toggles the enabled property of all text boxes on a form to the inverse of the value of its current enabled property. In other words, if the text box enabled property is equal to true (.T.), the code set it to false (.F.):

   FOR icount = 1 TO Thisform.controlcount
      IF UPPER(Thisform.Controls(icount).Class) = "TEXTBOX"
         Thisform.Controls(icount).Enabled = ;
            !Thisform.Controls(icount).Enabled
      ENDIF
   ENDFOR