ListCollection indexer

__getitem__(index)

Gets a list by index.

def __getitem__(self, index: int):
    ...
ParameterTypeDescription
indexint

Examples

Shows how to apply list formatting of an existing list to a collection of paragraphs.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)
builder.writeln('Paragraph 1')
builder.writeln('Paragraph 2')
builder.write('Paragraph 3')
paras = [node.as_paragraph() for node in doc.get_child_nodes(aw.NodeType.PARAGRAPH, True)]
self.assertEqual(0, len([p for p in paras if p.list_format.is_list_item]))
doc.lists.add(aw.lists.ListTemplate.NUMBER_DEFAULT)
list = doc.lists[0]
for paragraph in paras:
    paragraph.list_format.list = list
    paragraph.list_format.list_level_number = 2
self.assertEqual(3, len([p for p in paras if p.list_format.is_list_item]))

Shows how to verify owner document properties of lists.

doc = aw.Document()
lists = doc.lists
self.assertEqual(doc, lists.document)
list = lists.add(aw.lists.ListTemplate.BULLET_DEFAULT)
self.assertEqual(doc, list.document)
print('Current list count:', lists.count)
print('Is the first document list:', lists[0] is list)
print('List id:', list.list_id)
print('List is the same by list_id:', lists.get_list_by_list_id(1) is list)

See Also

ListCollection.count property