Aspose::Words::Fields::DropDownItemCollection класс

Коллекция строк, представляющих все элементы выпадающего поля формы. Чтобы узнать больше, посетите статью документации Working with Fields.

class DropDownItemCollection : public System::Collections::Generic::IEnumerable<System::String>,
                               public Aspose::Words::IComplexAttr

Методы

МетодОписание
Add(const System::String&)Добавляет строку в конец коллекции.
begin()
begin() const
cbegin() const
cend() const
Clear()Удаляет все элементы из коллекции.
Contains(const System::String&)Определяет, содержит ли коллекция указанное значение.
end()
end() const
get_Count()Получает количество элементов, содержащихся в коллекции.
GetEnumerator() overrideВозвращает объект‑перечислитель, который можно использовать для перебора всех элементов в коллекции.
GetType() const override
idx_get(int32_t)Получает или задает элемент по указанному индексу.
idx_set(int32_t, const System::String&)Получает или задает элемент по указанному индексу.
IndexOf(const System::String&)Возвращает нулевой индекс указанного значения в коллекции.
Insert(int32_t, const System::String&)Вставляет строку в коллекцию по указанному индексу.
Is(const System::TypeInfo&) const override
Remove(const System::String&)Удаляет указанное значение из коллекции.
RemoveAt(int32_t)Удаляет значение по указанному индексу.
static Type()
virtualizeBeginConstIterator() const override
virtualizeBeginIterator() override
virtualizeEndConstIterator() const override
virtualizeEndIterator() override

Typedefs

Типовое определениеОписание
const_iterator
iterator
iterator_holder_type
virtualized_iterator
virtualized_iterator_element

Примеры

Показывает, как вставить поле комбинированного списка и отредактировать элементы в его коллекции.

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

// Вставьте комбинированный список, а затем проверьте его коллекцию раскрывающихся элементов.
// В Microsoft Word пользователь щелкнет по комбинированному списку,
// а затем выберет один из текстовых элементов в коллекции для отображения.
System::ArrayPtr<System::String> items = System::MakeArray<System::String>({u"One", u"Two", u"Three"});
System::SharedPtr<Aspose::Words::Fields::FormField> comboBoxField = builder->InsertComboBox(u"DropDown", items, 0);
System::SharedPtr<Aspose::Words::Fields::DropDownItemCollection> dropDownItems = comboBoxField->get_DropDownItems();

ASSERT_EQ(3, dropDownItems->get_Count());
ASSERT_EQ(u"One", dropDownItems->idx_get(0));
ASSERT_EQ(1, dropDownItems->IndexOf(u"Two"));
ASSERT_TRUE(dropDownItems->Contains(u"Three"));

// Существует два способа добавить новый элемент в существующую коллекцию элементов раскрывающегося списка.
// 1 -  Добавить элемент в конец коллекции:
dropDownItems->Add(u"Four");

// 2 -  Вставить элемент перед другим элементом по указанному индексу:
dropDownItems->Insert(3, u"Three and a half");

ASSERT_EQ(5, dropDownItems->get_Count());

// Итерировать коллекцию и вывести каждый элемент.
{
    System::SharedPtr<System::Collections::Generic::IEnumerator<System::String>> dropDownCollectionEnumerator = dropDownItems->GetEnumerator();
    while (dropDownCollectionEnumerator->MoveNext())
    {
        std::cout << dropDownCollectionEnumerator->get_Current() << std::endl;
    }
}

// Существует два способа удаления элементов из коллекции раскрывающихся элементов.
// 1 -  Удалить элемент, содержимое которого равно переданной строке:
dropDownItems->Remove(u"Four");

// 2 -  Удалить элемент по индексу:
dropDownItems->RemoveAt(3);

ASSERT_EQ(3, dropDownItems->get_Count());
ASSERT_FALSE(dropDownItems->Contains(u"Three and a half"));
ASSERT_FALSE(dropDownItems->Contains(u"Four"));

doc->Save(get_ArtifactsDir() + u"FormFields.DropDownItemCollection.html");

// Очистить всю коллекцию раскрывающихся элементов.
dropDownItems->Clear();

См. также

Класс Aspose::Words::Fields::ComparisonExpression Aspose::Words::Fields::Field class