DynaPDF.CreateGroupField
------------------------

Creates a group field. A group field is a simple array of fields which can be used to separate fields into several groups.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [DynaPDF](component_DynaPDF.md) | [4.2](newinversion42.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "DynaPDF.CreateGroupField"; PDF; Name; Parent ) 

**MBS**( **"DynaPDF.CreateGroupField";** /\* Creates a group field. A group field is a simple array of fields which can be used to separate fields into several groups. \*/  
**$PDF**; /\* The PDF reference returned from [DynaPDF.New](DynaPDFNew.md). \*/   
**$Name**; /\* Name of the fielde.g. "Hello" \*/   
**$Parent**) /\* Parent group field if any or -1.e.g. -1 \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| PDF | The PDF reference returned from [DynaPDF.New](DynaPDFNew.md). | $pdf |
| Name | Name of the field | "Hello" |
| Parent | Parent group field if any or -1. | -1 |

### Result

Returns handle or error.

### Description

Creates a group field. A group field is a simple array of fields which can be used to separate fields into several groups.   
The field itself has no appearance, it is invisible.  
  
For example, if an interactive form contains fields for private personal data and fields for company data in any kind, the fields can be structured into two base parts: PersonalData and CompanyData. The field names of each part must be unique inside its own hierarchy. However, duplicate field names of fields of the same type are still allowed.  
  
Field names and Group fields  
  
The name of a specific interactive form field is the partial field name. The fully qualified name is not explicitly defined, but is constructed from the partial field name of the field and all of its ancestors.  
For a field with no parent, the partial field name and the fully qualified name are the same; for a field that is the child of a parent (group) field, the fully qualified name is formed by appending the child field's partial name to the parent's fully qualified name, separated by a period (.):  
  
parent\_field\_name.child\_partial\_name  
  
For example, if a group field with the partial field name PersonalData has a child whose partial field name is Address, which in turn has a child with the partial field name ZipCode, then the fully qualified name of this last field would be  
PersonalData.Address.ZipCode  
  
Thus all fields descended from a common ancestor will share the ancestor's fully qualified field name as a common prefix in their own fully qualified names.  
  
The naming scheme must be taken into account when accessing fields of a group in [JavaScript](component_JavaScript.md) functions.  
  
Acrobat 4 does not support group fields inside a hide or form action. For example, if a group field will be added to a hide action, the entire group becomes invisible if the action is executed in Acrobat 5 or higher. Acrobat 4 ignores the group field; each field of the group must be manually added to the hide action.  
See also [CreateGroupField](https://www.monkeybreadsoftware.com/DynaPDF-Manual/CreateGroupField.shtml) function in DynaPDF manual.

### See also

- [DynaPDF.CreateButton](DynaPDFCreateButton.md)
- [DynaPDF.CreateComboBox](DynaPDFCreateComboBox.md)
- [DynaPDF.CreateListBox](DynaPDFCreateListBox.md)
- [DynaPDF.CreateSigField](DynaPDFCreateSigField.md)
- [DynaPDF.CreateSigFieldAP](DynaPDFCreateSigFieldAP.md)
- [DynaPDF.CreateTextField](DynaPDFCreateTextField.md)
- [DynaPDF.New](DynaPDFNew.md)

### Blog Entries

- [MBS Filemaker Plugin, version 4.2pr5](https://www.mbsplugins.de/archive/2014-05-10/MBS_Filemaker_Plugin_version_4/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 18th August 2014 , last changed 21st October 2014

  
[DynaPDF.CreateGoToRActionEx](DynaPDFCreateGoToRActionEx.md) - [DynaPDF.CreateICCBasedColorSpace](DynaPDFCreateICCBasedColorSpace.md)

[HTML Version](DynaPDFCreateGroupField.shtml)