Skip to main content

Interface: QuickPickItem

Represents an item that can be selected from a list of items.

Properties​

alwaysShow?​

optional alwaysShow: boolean

Always show this item.

Note: this property is ignored when kind is set to QuickPickItemKind.Separator

Defined in​

packages/extension-api/src/extension-api.d.ts:1555

buttons?​

optional buttons: readonly QuickInputButton[]

Optional buttons that will be rendered on this particular item. These buttons will trigger an QuickPickItemButtonEvent when clicked. Buttons are only rendered when using a quickpick created by the window.createQuickPick createQuickPick() API. Buttons are not rendered when using the showQuickPick() API.

Note: this property is ignored when kind is set to QuickPickItemKind.Separator

Defined in​

packages/extension-api/src/extension-api.d.ts:1565

description?​

optional description: string

A human-readable string which is rendered less prominent in the same line. Supports rendering of ThemeIcon theme icons via the $(<name>)-syntax.

Note: this property is ignored when kind is set to QuickPickItemKind.Separator

Defined in​

packages/extension-api/src/extension-api.d.ts:1527

detail?​

optional detail: string

A human-readable string which is rendered less prominent in a separate line. Supports rendering of ThemeIcon theme icons via the $(<name>)-syntax.

Note: this property is ignored when kind is set to QuickPickItemKind.Separator

Defined in​

packages/extension-api/src/extension-api.d.ts:1535

kind?​

optional kind: QuickPickItemKind

The kind of QuickPickItem that will determine how this item is rendered in the quick pick. When not specified, the default is QuickPickItemKind.Default.

Defined in​

packages/extension-api/src/extension-api.d.ts:1519

label​

label: string

A human-readable string which is rendered prominent. Supports rendering of ThemeIcon theme icons via the $(<name>)-syntax.

Defined in​

packages/extension-api/src/extension-api.d.ts:1513

picked?​

optional picked: boolean

Optional flag indicating if this item is picked initially. This is only honored when using the showQuickPick() API. To do the same thing with the window.createQuickPick createQuickPick() API, simply set the QuickPick.selectedItems to the items you want picked initially. (Note: This is only honored when the picker allows multiple selections.)

See​

QuickPickOptions.canPickMany

Note: this property is ignored when kind is set to QuickPickItemKind.Separator

Defined in​

packages/extension-api/src/extension-api.d.ts:1548