Overview

A builder that constructs RowSection instances.

Upon building, this class validates the following:

• If this section is set as a selection group, the given initialSelectedIndex cannot be greater than the size of the list (unless the list is empty, in which case this value is ignored)
• If this section is set as a selection group, none of the added Rows can have a Row.Builder.setToggle(Toggle) set
• Each Row must conform to RowConstraints.ROW_CONSTRAINTS_FULL_LIST

Summary

Constructors

Create a new RowSection builder.

Create a new RowSection builder, copying values from an existing instance.

Methods

Sets this entire RowSection as a selection group when passed a non-negative integer correlating to a valid index within the list of items added. The UI behaves equivalently to a radio button group where a single item is called out (either by an actual radio button, or through some other highlighting). The host will initially highlight the initialSelectedIndex's item and automatically update the highlight to other items if selected by the user. The app should handle user selections via Row.Builder.setOnClickListener(OnClickListener).

This cannot be used in conjunction with Row.Builder.setToggle(Toggle).

Parameters:

initialSelectedIndex: the index of the item to be selected when the template is first rendered

Unsets this RowSection from being shown as a selection group. See RowSection.Builder.setAsSelectionGroup(int).

Constructs a new RowSection from the current state of this builder, throwing exceptions for any invalid state.

See also: for the list of validation logic