jQWidgets jqxListBox uncheckIndex() 方法

简介

jQWidgets jqxListBox uncheckIndex() 方法是 jQWidgets jqxListBox 组件提供的一个方法，用于取消选择列表中指定索引的项。该方法可以通过调用 jQWidgets jqxListBox 实例的 uncheckIndex() 方法来实现。

方法签名

uncheckIndex(index: number): void;

参数说明

• index: number：要取消选择的项的索引（从 0 开始计数）。

返回值

• 该方法没有返回值。

使用示例

// 获取 jQWidgets jqxListBox 实例
const listBox = $('#listBox').jqxListBox({});

// 取消选择列表中第 2 个索引处的项
listBox.uncheckIndex(1);

注意事项

• 调用该方法时，只有当列表中指定索引处的项处于选中状态时，才能取消选择该项。
• 在使用该方法时，需要保证传入的索引值参数有效。如果参数不合法（比如传入了负数或者超出列表索引范围的值），会导致程序出错。因此，在使用该方法前应该先对索引范围进行判断或者在程序中使用 try-catch 语句对错误进行处理。
• jQWidgets jqxListBox 组件中，也提供了其他类似的方法，比如 checkIndex() 用于选择指定索引处的项、checkAll() 用于选择所有项、uncheckAll() 用于取消选择所有项等，可根据实际需求选择使用。