ISControl.GetParentForm

Description

This function returns the parent form of the specified control.

Syntax

object.GetParentForm( [aFormTypeName])

Part	Attribute	Type	Description
`object`	Required	ISControl	The `object` always implements the ISControl interface
`aFormTypeName`	Optional	string	The name of the form type

Return Value

ISProfileForm

Returns the parent form of the specified control.

Example

Display the short name of the form for the control and some information of all parent controls in the hierarchical tree starting from the specified control.

sub main()
  Dim aControl
  Dim aControlInfo
  Dim aForm

  Set aControl = Form.Controls_("chkMV")

  set aForm = aControl.GetParentForm("TIVisualForm")
  aControlInfo = "Form: " & aForm.ShortName  & vbNewLine & vbNewLine

  do while not aControl is nothing
    aControlInfo = aControlInfo &_
      "ShortName: " & aControl.ShortName & vbNewLine &_
      "TypeName: " & aControl.TypeName & vbNewLine &_
      "---------" & vbNewLine
    set aControl = aControl.Parent
  loop  
  
  Profile.MsgBox(aControlInfo)
end sub

Note: This macro should be executed in any event handler of the form control.

In Profile Client v8 on User Interface Parent Form can be found in Maintain/Templates/Health Record Collection Templates/Open the selected form template/Open form editor/Object Inspector.

Version information

Added in v7.8.0