Sets the string that is associated with the on state of a radio button or checkbox control.
- macOS 10.5–10.12Deprecated
Required for controls of types
PDFAnnotation, the value of
name describes the on state of the control (the off state is always labeled “Off”). Although “On” is an acceptable string for the on state of a single checkbox, a group of two or more radio buttons should have a unique string associated with each control.
For example, a form might display a group of 3 radio buttons that allow users to indicate an account type, such as savings, checking, or investment. The strings associated with the on states of these buttons could be “Savings,“ “Checking,“ and “Investment.“ In this example, these 3 radio buttons also would share a field name string, such as “AccountType.“