# cp.choices.builder

Choices Builder Module.

# API Overview

Functions - API calls offered directly by the extension

new

Methods - API calls which can only be made on an object returned by a constructor

id
image
params
subText
text

# API Documentation

# Functions

# new


Signature	`cp.choices.builder.new(choiceType) -> builder`
Type	Function
Description	Creates a new choice builder instance.
Parameters	`choice` - The choice instance to configure.
Returns	The new choice builder.
Notes	None
Examples	None
Source	src/extensions/cp/choices/init.lua line 7

# Methods

# id


Signature	`cp.choices.builder:id(value) -> builder`
Type	Method
Description	Sets the ID of the choice.
Parameters	`value` - The ID.
Returns	The choice builder.
Notes	None
Examples	None
Source	src/extensions/cp/choices/init.lua line 53

# image


Signature	`cp.choices.builder:image(value) -> builder`
Type	Method
Description	Sets the image of the choice.
Parameters	value - A `hs.image` image object that will be displayed next to the choice
Returns	The choice builder.
Notes	None
Examples	None
Source	src/extensions/cp/choices/init.lua line 67

# params


Signature	`cp.choices.builder:params(value) -> builder`
Type	Method
Description	Specifies a table of parameter values for the choice. These values need to be simple - text, numbers, booleans, or tables.
Parameters	`value` - The table of parameters.
Returns	The choice builder, added to the choices set.
Notes	None
Examples	None
Source	src/extensions/cp/choices/init.lua line 83

# subText


Signature	`cp.choices.builder:subText(value) -> builder`
Type	Method
Description	Specifies the `subText` value for the choice being built.
Parameters	`value` - The subText title for the choice.
Returns	The choice builder.
Notes	None
Examples	None
Source	src/extensions/cp/choices/init.lua line 39

# text


Signature	`cp.choices.builder:text(value) -> builder`
Type	Method
Description	Specifies the text value for the choice being built.
Parameters	`value` - The text title for the choice.
Returns	The choice builder, added to the choices set.
Notes	None
Examples	None
Source	src/extensions/cp/choices/init.lua line 25