A concrete {@link QuickInput } to let the user pick an item from a list of items of type T. The items can be filtered through a filter text field and there is an option {@link QuickPick.canSelectMany canSelectMany} to allow for selecting multiple items.
Note that in many cases the more convenient {@link window.showQuickPick } is easier to use. {@link window.createQuickPick } should be used when {@link window.showQuickPick } does not offer the required flexibility.
A concrete {@link QuickInput } to let the user pick an item from a list of items of type T. The items can be filtered through a filter text field and there is an option {@link QuickPick.canSelectMany canSelectMany} to allow for selecting multiple items. Note that in many cases the more convenient {@link window.showQuickPick } is easier to use. {@link window.createQuickPick } should be used when {@link window.showQuickPick } does not offer the required flexibility.
(active-items quick-pick)
Active items. This can be read and updated by the extension.
Active items. This can be read and updated by the extension.
(busy? quick-pick)
If the UI should show a progress indicator. Defaults to false.
Change this to true, e.g., while loading more data or validating user input.
If the UI should show a progress indicator. Defaults to false. Change this to true, e.g., while loading more data or validating user input.
(buttons quick-pick)
Buttons for actions in the UI.
Buttons for actions in the UI.
(can-select-many? quick-pick)
If multiple items can be selected at the same time. Defaults to false.
If multiple items can be selected at the same time. Defaults to false.
(dispose quick-pick)
Dispose of this input UI and any associated resources. If it is still visible, it is first hidden. After this call the input UI is no longer functional and no additional methods or properties on it should be accessed. Instead a new input UI should be created.
Returns: void
Dispose of this input UI and any associated resources. If it is still visible, it is first hidden. After this call the input UI is no longer functional and no additional methods or properties on it should be accessed. Instead a new input UI should be created. **Returns:** `void`
(enabled? quick-pick)
If the UI should allow for user input. Defaults to true.
Change this to false, e.g., while validating user input or loading data for the next step in user input.
If the UI should allow for user input. Defaults to true. Change this to false, e.g., while validating user input or loading data for the next step in user input.
(hide quick-pick)
Hides this input UI. This will also fire an {@link QuickInput.onDidHide } event.
Returns: void
Hides this input UI. This will also fire an {@link QuickInput.onDidHide } event. **Returns:** `void`
(ignore-focus-out? quick-pick)
If the UI should stay open even when loosing UI focus. Defaults to false. This setting is ignored on iPad and is always false.
If the UI should stay open even when loosing UI focus. Defaults to false. This setting is ignored on iPad and is always false.
(items quick-pick)
Items to pick from. This can be read and updated by the extension.
Items to pick from. This can be read and updated by the extension.
(keep-scroll-position? quick-pick)
An optional flag to maintain the scroll position of the quick pick when the quick pick items are updated. Defaults to false.
An optional flag to maintain the scroll position of the quick pick when the quick pick items are updated. Defaults to false.
(match-on-description? quick-pick)
If the filter text should also be matched against the description of the items. Defaults to false.
If the filter text should also be matched against the description of the items. Defaults to false.
(match-on-detail? quick-pick)
If the filter text should also be matched against the detail of the items. Defaults to false.
If the filter text should also be matched against the detail of the items. Defaults to false.
(on-did-accept quick-pick)
(on-did-accept quick-pick listener)
(on-did-accept quick-pick listener this-args)
(on-did-accept quick-pick listener this-args disposables)
An event signaling when the user indicated acceptance of the selected item(s).
Parameters:
listener
: (e: T) => any
- The listener function will be called when the event happens.this-args
: any
- The this
-argument which will be used when calling the event listener.disposables
: Disposable[] | undefined
- An array to which a {@link Disposable } will be added.Returns: Disposable
- A disposable which unsubscribes the event listener.
An event signaling when the user indicated acceptance of the selected item(s). **Parameters:** - `listener`: `(e: T) => any` - The listener function will be called when the event happens. - `this-args`: `any` - The `this`-argument which will be used when calling the event listener. - `disposables`: `Disposable[] | undefined` - An array to which a {@link Disposable } will be added. **Returns:** `Disposable` - A disposable which unsubscribes the event listener.
(on-did-change-active quick-pick)
(on-did-change-active quick-pick listener)
(on-did-change-active quick-pick listener this-args)
(on-did-change-active quick-pick listener this-args disposables)
An event signaling when the active items have changed.
Parameters:
listener
: (e: T) => any
- The listener function will be called when the event happens.this-args
: any
- The this
-argument which will be used when calling the event listener.disposables
: Disposable[] | undefined
- An array to which a {@link Disposable } will be added.Returns: Disposable
- A disposable which unsubscribes the event listener.
An event signaling when the active items have changed. **Parameters:** - `listener`: `(e: T) => any` - The listener function will be called when the event happens. - `this-args`: `any` - The `this`-argument which will be used when calling the event listener. - `disposables`: `Disposable[] | undefined` - An array to which a {@link Disposable } will be added. **Returns:** `Disposable` - A disposable which unsubscribes the event listener.
(on-did-change-selection quick-pick)
(on-did-change-selection quick-pick listener)
(on-did-change-selection quick-pick listener this-args)
(on-did-change-selection quick-pick listener this-args disposables)
An event signaling when the selected items have changed.
Parameters:
listener
: (e: T) => any
- The listener function will be called when the event happens.this-args
: any
- The this
-argument which will be used when calling the event listener.disposables
: Disposable[] | undefined
- An array to which a {@link Disposable } will be added.Returns: Disposable
- A disposable which unsubscribes the event listener.
An event signaling when the selected items have changed. **Parameters:** - `listener`: `(e: T) => any` - The listener function will be called when the event happens. - `this-args`: `any` - The `this`-argument which will be used when calling the event listener. - `disposables`: `Disposable[] | undefined` - An array to which a {@link Disposable } will be added. **Returns:** `Disposable` - A disposable which unsubscribes the event listener.
(on-did-change-value quick-pick)
(on-did-change-value quick-pick listener)
(on-did-change-value quick-pick listener this-args)
(on-did-change-value quick-pick listener this-args disposables)
An event signaling when the value of the filter text has changed.
Parameters:
listener
: (e: T) => any
- The listener function will be called when the event happens.this-args
: any
- The this
-argument which will be used when calling the event listener.disposables
: Disposable[] | undefined
- An array to which a {@link Disposable } will be added.Returns: Disposable
- A disposable which unsubscribes the event listener.
An event signaling when the value of the filter text has changed. **Parameters:** - `listener`: `(e: T) => any` - The listener function will be called when the event happens. - `this-args`: `any` - The `this`-argument which will be used when calling the event listener. - `disposables`: `Disposable[] | undefined` - An array to which a {@link Disposable } will be added. **Returns:** `Disposable` - A disposable which unsubscribes the event listener.
(on-did-hide quick-pick)
(on-did-hide quick-pick listener)
(on-did-hide quick-pick listener this-args)
(on-did-hide quick-pick listener this-args disposables)
An event signaling when this input UI is hidden.
There are several reasons why this UI might have to be hidden and the extension will be notified through {@link QuickInput.onDidHide }. (Examples include: an explicit call to {@link QuickInput.hide }, the user pressing Esc, some other input UI opening, etc.)
Parameters:
listener
: (e: T) => any
- The listener function will be called when the event happens.this-args
: any
- The this
-argument which will be used when calling the event listener.disposables
: Disposable[] | undefined
- An array to which a {@link Disposable } will be added.Returns: Disposable
- A disposable which unsubscribes the event listener.
An event signaling when this input UI is hidden. There are several reasons why this UI might have to be hidden and the extension will be notified through {@link QuickInput.onDidHide }. (Examples include: an explicit call to {@link QuickInput.hide }, the user pressing Esc, some other input UI opening, etc.) **Parameters:** - `listener`: `(e: T) => any` - The listener function will be called when the event happens. - `this-args`: `any` - The `this`-argument which will be used when calling the event listener. - `disposables`: `Disposable[] | undefined` - An array to which a {@link Disposable } will be added. **Returns:** `Disposable` - A disposable which unsubscribes the event listener.
(on-did-trigger-button quick-pick)
(on-did-trigger-button quick-pick listener)
(on-did-trigger-button quick-pick listener this-args)
(on-did-trigger-button quick-pick listener this-args disposables)
An event signaling when a button in the title bar was triggered. This event does not fire for buttons on a {@link QuickPickItem }.
Parameters:
listener
: (e: T) => any
- The listener function will be called when the event happens.this-args
: any
- The this
-argument which will be used when calling the event listener.disposables
: Disposable[] | undefined
- An array to which a {@link Disposable } will be added.Returns: Disposable
- A disposable which unsubscribes the event listener.
An event signaling when a button in the title bar was triggered. This event does not fire for buttons on a {@link QuickPickItem }. **Parameters:** - `listener`: `(e: T) => any` - The listener function will be called when the event happens. - `this-args`: `any` - The `this`-argument which will be used when calling the event listener. - `disposables`: `Disposable[] | undefined` - An array to which a {@link Disposable } will be added. **Returns:** `Disposable` - A disposable which unsubscribes the event listener.
(on-did-trigger-item-button quick-pick)
(on-did-trigger-item-button quick-pick listener)
(on-did-trigger-item-button quick-pick listener this-args)
(on-did-trigger-item-button quick-pick listener this-args disposables)
An event signaling when a button in a particular {@link QuickPickItem } was triggered. This event does not fire for buttons in the title bar.
Parameters:
listener
: (e: T) => any
- The listener function will be called when the event happens.this-args
: any
- The this
-argument which will be used when calling the event listener.disposables
: Disposable[] | undefined
- An array to which a {@link Disposable } will be added.Returns: Disposable
- A disposable which unsubscribes the event listener.
An event signaling when a button in a particular {@link QuickPickItem } was triggered. This event does not fire for buttons in the title bar. **Parameters:** - `listener`: `(e: T) => any` - The listener function will be called when the event happens. - `this-args`: `any` - The `this`-argument which will be used when calling the event listener. - `disposables`: `Disposable[] | undefined` - An array to which a {@link Disposable } will be added. **Returns:** `Disposable` - A disposable which unsubscribes the event listener.
(placeholder quick-pick)
Optional placeholder shown in the filter textbox when no filter has been entered.
Optional placeholder shown in the filter textbox when no filter has been entered.
(selected-items quick-pick)
Selected items. This can be read and updated by the extension.
Selected items. This can be read and updated by the extension.
(set-active-items! quick-pick value)
Active items. This can be read and updated by the extension.
Active items. This can be read and updated by the extension.
(set-busy! quick-pick value)
If the UI should show a progress indicator. Defaults to false.
Change this to true, e.g., while loading more data or validating user input.
If the UI should show a progress indicator. Defaults to false. Change this to true, e.g., while loading more data or validating user input.
(set-buttons! quick-pick value)
Buttons for actions in the UI.
Buttons for actions in the UI.
(set-can-select-many! quick-pick value)
If multiple items can be selected at the same time. Defaults to false.
If multiple items can be selected at the same time. Defaults to false.
(set-enabled! quick-pick value)
If the UI should allow for user input. Defaults to true.
Change this to false, e.g., while validating user input or loading data for the next step in user input.
If the UI should allow for user input. Defaults to true. Change this to false, e.g., while validating user input or loading data for the next step in user input.
(set-ignore-focus-out! quick-pick value)
If the UI should stay open even when loosing UI focus. Defaults to false. This setting is ignored on iPad and is always false.
If the UI should stay open even when loosing UI focus. Defaults to false. This setting is ignored on iPad and is always false.
(set-items! quick-pick value)
Items to pick from. This can be read and updated by the extension.
Items to pick from. This can be read and updated by the extension.
(set-keep-scroll-position! quick-pick value)
An optional flag to maintain the scroll position of the quick pick when the quick pick items are updated. Defaults to false.
An optional flag to maintain the scroll position of the quick pick when the quick pick items are updated. Defaults to false.
(set-match-on-description! quick-pick value)
If the filter text should also be matched against the description of the items. Defaults to false.
If the filter text should also be matched against the description of the items. Defaults to false.
(set-match-on-detail! quick-pick value)
If the filter text should also be matched against the detail of the items. Defaults to false.
If the filter text should also be matched against the detail of the items. Defaults to false.
(set-on-did-hide! quick-pick value)
An event signaling when this input UI is hidden.
There are several reasons why this UI might have to be hidden and the extension will be notified through {@link QuickInput.onDidHide }. (Examples include: an explicit call to {@link QuickInput.hide }, the user pressing Esc, some other input UI opening, etc.)
An event signaling when this input UI is hidden. There are several reasons why this UI might have to be hidden and the extension will be notified through {@link QuickInput.onDidHide }. (Examples include: an explicit call to {@link QuickInput.hide }, the user pressing Esc, some other input UI opening, etc.)
(set-placeholder! quick-pick value)
Optional placeholder shown in the filter textbox when no filter has been entered.
Optional placeholder shown in the filter textbox when no filter has been entered.
(set-selected-items! quick-pick value)
Selected items. This can be read and updated by the extension.
Selected items. This can be read and updated by the extension.
(set-step! quick-pick value)
An optional current step count.
An optional current step count.
(set-title! quick-pick value)
An optional title.
An optional title.
(set-total-steps! quick-pick value)
An optional total step count.
An optional total step count.
(set-value! quick-pick value)
Current value of the filter text.
Current value of the filter text.
(show quick-pick)
Makes the input UI visible in its current configuration. Any other input UI will first fire an {@link QuickInput.onDidHide } event.
Returns: void
Makes the input UI visible in its current configuration. Any other input UI will first fire an {@link QuickInput.onDidHide } event. **Returns:** `void`
(step quick-pick)
An optional current step count.
An optional current step count.
(total-steps quick-pick)
An optional total step count.
An optional total step count.
(value quick-pick)
Current value of the filter text.
Current value of the filter text.
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close