Differenza fra la proprietà ".Children" e la proprietà ".Controls" di un oggetto

La guida ci dice che la Proprietà

.Children

si riferisce a tutti gli Oggetti inclusi nel solo Contenitore che possiede tale Proprietà.

Invece la Proprietà

.Controls

si riferisce a tutti gli Oggetti comunque contenuti alla finestra del Contenitore che possiede tale Proprietà.

La differenza sta nel fatto che la Proprietà ".Children " restituirà un vettore degli Oggetti contenuti nel solo Contenitore, del quale stiamo utilizzando quella proprietà, escludendo gli eventuali Oggetti contenuti in altri Contenitori del suo medesimo rango gerarchico.
Se, dunque, per esempio su un Form abbiamo due Contenitori di tipo "Panel", i quali contengono al loro interno uno o più Oggetti, la Proprietà ".Children " di un "Panel" restituirà soltanto gli Oggetti Figli di questo "Panel", ossia da esso contenuti.

Invece la Proprietà ".Controls " restituirà un vettore di tutti gli Oggetti comunque contenuti all'interno del Contenitore. Così, se nelContenitore sono stati posti degli Oggetti, e fra essi anche dei Contenitori che a loro volta contengono Oggetti alcuni dei quali che siano magari anche altri Contenitori contenenti Oggetti (insomma tutto in una gerarchia parentale discendente), ebbene, la Proprietà .Controls del Contenitore principale prenderà in considerazione tutti gli Oggetti comunque in esso presenti (anche se sono contenuti in Contenitori Figli del Contenitore principale, purché ovviamente tali Contenitori appartengano in rapporto gerarchico al Contenitore principale).
Pertanto, riprendendo l'esempio precedente, la Proprietà ".Controls " del Form prenderà in considerazione non solo i due Oggetti di tipo "Panel", ma anche gli Oggetti contenuti in questi due "Panel".

Facciamo un esempio codificato, nel quale poniamo su un Form un Button ed una Label. Poniamo anche un Contenitore Frame all'interno del quale saranno posti una TextArea, un Dial ed un Contenitore Panel. Nel Panel porremo una TextLabel ed una Label.
Il codice Gambas sarà poi il seguente:

Public Sub Form_Open()

 Dim ob As Object
   
 Print "Oggetti visti dalla proprietà '.Children':"
 For Each ob In FMain.Children
   Print ob.Name
 Next
 Print "---------------------"

 Print "Oggetti visti dalla proprietà '.Controls':"
 For Each ob In FMain.Controls
   Print ob.Name
 Next

End

Il risultato finale in console sarà il seguente:
Oggetti visti dalla proprietà '.Children':
Label1
Button1
Frame1
---------------------
Oggetti visti dalla proprietà '.Controls':
Label1
Button1
Frame1
TextArea1
Dial1
Panel1
TextLabel1
Label2

La Proprietà ".Children " dell'Oggetto Contenitore "Form" ha preso in considerazione soltanto gli Oggetti strettamente considerati Figli del "Form". Invece la proprietà ".Controls " ha preso in considerazione tutti gli Oggetti situati a qualsiasi titolo - ossia anche se Figli di altri Contenitori (purché posti nel "Form") - sul "Form".