# ParameterControlProperty

The control of a parameter that users can interact with in a dashboard or an analysis.

This is a union type structure. For this structure to be valid, only one of the attributes can be defined.

- Source: Generated code
- Type last changed: v2.93.0 · 23 Aug 2023

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_quicksight as quicksight } from 'aws-cdk-lib';
const parameterControlProperty: quicksight.CfnAnalysis.ParameterControlProperty = {
  dateTimePicker: {
    parameterControlId: 'parameterControlId',
    sourceParameterName: 'sourceParameterName',
    title: 'title',

    // the properties below are optional
    displayOptions: {
      dateIconVisibility: 'dateIconVisibility',
      dateTimeFormat: 'dateTimeFormat',
      helperTextVisibility: 'helperTextVisibility',
      infoIconLabelOptions: {
        infoIconText: 'infoIconText',
        visibility: 'visibility',
      },
      titleOptions: {
        customLabel: 'customLabel',
        fontConfiguration: {
          fontColor: 'fontColor',
          fontDecoration: 'fontDecoration',
          fontFamily: 'fontFamily',
          fontSize: {
            absolute: 'absolute',
            relative: 'relative',
          },
          fontStyle: 'fontStyle',
          fontWeight: {
            name: 'name',
          },
        },
        visibility: 'visibility',
      },
    },
  },
  dropdown: {
    parameterControlId: 'parameterControlId',
    sourceParameterName: 'sourceParameterName',
    title: 'title',

    // the properties below are optional
    cascadingControlConfiguration: {
      sourceControls: [{
        columnToMatch: {
          columnName: 'columnName',

          // the properties below are optional
          dataSetIdentifier: 'dataSetIdentifier',
          topicIdentifier: 'topicIdentifier',
        },
        sourceSheetControlId: 'sourceSheetControlId',
      }],
    },
    commitMode: 'commitMode',
    displayOptions: {
      infoIconLabelOptions: {
        infoIconText: 'infoIconText',
        visibility: 'visibility',
      },
      selectAllOptions: {
        visibility: 'visibility',
      },
      titleOptions: {
        customLabel: 'customLabel',
        fontConfiguration: {
          fontColor: 'fontColor',
          fontDecoration: 'fontDecoration',
          fontFamily: 'fontFamily',
          fontSize: {
            absolute: 'absolute',
            relative: 'relative',
          },
          fontStyle: 'fontStyle',
          fontWeight: {
            name: 'name',
          },
        },
        visibility: 'visibility',
      },
    },
    selectableValues: {
      linkToDataSetColumn: {
        columnName: 'columnName',

        // the properties below are optional
        dataSetIdentifier: 'dataSetIdentifier',
        topicIdentifier: 'topicIdentifier',
      },
      values: ['values'],
    },
    type: 'type',
  },
  list: {
    parameterControlId: 'parameterControlId',
    sourceParameterName: 'sourceParameterName',
    title: 'title',

    // the properties below are optional
    cascadingControlConfiguration: {
      sourceControls: [{
        columnToMatch: {
          columnName: 'columnName',

          // the properties below are optional
          dataSetIdentifier: 'dataSetIdentifier',
          topicIdentifier: 'topicIdentifier',
        },
        sourceSheetControlId: 'sourceSheetControlId',
      }],
    },
    displayOptions: {
      infoIconLabelOptions: {
        infoIconText: 'infoIconText',
        visibility: 'visibility',
      },
      searchOptions: {
        visibility: 'visibility',
      },
      selectAllOptions: {
        visibility: 'visibility',
      },
      titleOptions: {
        customLabel: 'customLabel',
        fontConfiguration: {
          fontColor: 'fontColor',
          fontDecoration: 'fontDecoration',
          fontFamily: 'fontFamily',
          fontSize: {
            absolute: 'absolute',
            relative: 'relative',
          },
          fontStyle: 'fontStyle',
          fontWeight: {
            name: 'name',
          },
        },
        visibility: 'visibility',
      },
    },
    selectableValues: {
      linkToDataSetColumn: {
        columnName: 'columnName',

        // the properties below are optional
        dataSetIdentifier: 'dataSetIdentifier',
        topicIdentifier: 'topicIdentifier',
      },
      values: ['values'],
    },
    type: 'type',
  },
  slider: {
    maximumValue: 123,
    minimumValue: 123,
    parameterControlId: 'parameterControlId',
    sourceParameterName: 'sourceParameterName',
    stepSize: 123,
    title: 'title',

    // the properties below are optional
    displayOptions: {
      infoIconLabelOptions: {
        infoIconText: 'infoIconText',
        visibility: 'visibility',
      },
      titleOptions: {
        customLabel: 'customLabel',
        fontConfiguration: {
          fontColor: 'fontColor',
          fontDecoration: 'fontDecoration',
          fontFamily: 'fontFamily',
          fontSize: {
            absolute: 'absolute',
            relative: 'relative',
          },
          fontStyle: 'fontStyle',
          fontWeight: {
            name: 'name',
          },
        },
        visibility: 'visibility',
      },
    },
  },
  textArea: {
    parameterControlId: 'parameterControlId',
    sourceParameterName: 'sourceParameterName',
    title: 'title',

    // the properties below are optional
    delimiter: 'delimiter',
    displayOptions: {
      infoIconLabelOptions: {
        infoIconText: 'infoIconText',
        visibility: 'visibility',
      },
      placeholderOptions: {
        visibility: 'visibility',
      },
      titleOptions: {
        customLabel: 'customLabel',
        fontConfiguration: {
          fontColor: 'fontColor',
          fontDecoration: 'fontDecoration',
          fontFamily: 'fontFamily',
          fontSize: {
            absolute: 'absolute',
            relative: 'relative',
          },
          fontStyle: 'fontStyle',
          fontWeight: {
            name: 'name',
          },
        },
        visibility: 'visibility',
      },
    },
  },
  textField: {
    parameterControlId: 'parameterControlId',
    sourceParameterName: 'sourceParameterName',
    title: 'title',

    // the properties below are optional
    displayOptions: {
      infoIconLabelOptions: {
        infoIconText: 'infoIconText',
        visibility: 'visibility',
      },
      placeholderOptions: {
        visibility: 'visibility',
      },
      titleOptions: {
        customLabel: 'customLabel',
        fontConfiguration: {
          fontColor: 'fontColor',
          fontDecoration: 'fontDecoration',
          fontFamily: 'fontFamily',
          fontSize: {
            absolute: 'absolute',
            relative: 'relative',
          },
          fontStyle: 'fontStyle',
          fontWeight: {
            name: 'name',
          },
        },
        visibility: 'visibility',
      },
    },
  },
};
```

## Properties

- `dateTimePicker`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAnalysis.ParameterDateTimePickerControlProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_quicksight.CfnAnalysis.ParameterDateTimePickerControlProperty.html) — A control from a date parameter that specifies date and time.

- `dropdown`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAnalysis.ParameterDropDownControlProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_quicksight.CfnAnalysis.ParameterDropDownControlProperty.html) — A control to display a dropdown list with buttons that are used to select a single value.

- `list`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAnalysis.ParameterListControlProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_quicksight.CfnAnalysis.ParameterListControlProperty.html) — A control to display a list with buttons or boxes that are used to select either a single value or multiple values.

- `slider`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAnalysis.ParameterSliderControlProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_quicksight.CfnAnalysis.ParameterSliderControlProperty.html) — A control to display a horizontal toggle bar.

  This is used to change a value by sliding the toggle.

- `textArea`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAnalysis.ParameterTextAreaControlProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_quicksight.CfnAnalysis.ParameterTextAreaControlProperty.html) — A control to display a text box that is used to enter multiple entries.

- `textField`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAnalysis.ParameterTextFieldControlProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_quicksight.CfnAnalysis.ParameterTextFieldControlProperty.html) — A control to display a text box that is used to enter a single entry.