Управление элементами управления
Введение
Разработчики могут добавлять различные графические объекты, такие как текстовые поля, флажки, переключатели, комбинированные поля выбора, ярлыки, кнопки, линии, прямоугольники, дуги, овалы, спиннеры, полосы прокрутки, групповые рамки и т. д. Aspose.Cells предоставляет пространство имен Aspose.Cells.Drawing, которое содержит все графические объекты. Однако есть несколько графических объектов или форм, которые пока не поддерживаются. Создайте эти графические объекты в электронной таблице дизайнера с помощью Microsoft Excel, а затем импортируйте электронную таблицу дизайнера в Aspose.Cells. Aspose.Cells позволяет загружать эти графические объекты из электронной таблицы дизайнера и записывать их в созданный файл.
Добавление элемента управления текстовым полем на лист
Один из способов выделить важную информацию в отчете - это использование текстового поля. Например, добавьте текст для выделения названия компании или для указания географического региона с самыми высокими продажами и т. д. Aspose.Cells предоставляет класс TextBoxCollection, используемый для добавления нового текстового поля в коллекцию. Есть еще один класс, TextBox, который представляет текстовое поле, используемое для определения всех типов настроек. У него есть несколько важных членов:
- Свойство TextFrame возвращает объект MsoTextFrame, используемый для настройки содержимого текстового поля.
- Свойство Placement определяет тип размещения.
- Свойство Font определяет атрибуты шрифта.
- Метод AddHyperlink добавляет гиперссылку для текстового поля.
- Свойство FillFormat возвращает объект MsoFillFormat, используемый для установки формата заливки для текстового поля.
- Свойство LineFormat возвращает объект MsoLineFormat, обычно используемый для стиля и толщины линии текстового поля.
- Свойство Text определяет входной текст для текстового поля.
В следующем примере создаются два текстовых поля на первом листе книги. Первое текстовое поле хорошо оборудовано различными настройками формата. Второе является простым.
Манипулирование элементами управления текстовыми полями в электронных таблицах дизайнера
Aspose.Cells также позволяет вам получать доступ к текстовым полям в электронных таблицах дизайнера и манипулировать ими. Используйте свойство Worksheet.TextBoxes, чтобы получить коллекцию текстовых полей на листе.
В следующем примере используется файл Microsoft Excel, созданный в вышеприведенном примере. Он получает текстовые строки двух текстовых полей и изменяет текст второго текстового поля для сохранения файла.
Добавление элемента управления флажком на лист
Флажки удобны, если вы хотите предоставить пользователю возможность выбрать между двумя вариантами, например, true или false; да или нет. Aspose.Cells позволяет использовать флажки на листах. Например, вы можете создать рабочую книгу с финансовым прогнозом, в которой нужно учесть определенное приобретение или нет. В этом случае вы можете разместить флажок наверху листа. Затем вы можете связать состояние этого флажка с другой ячейкой, чтобы, если флажок выбран, значение ячейки будет True; если он не выбран, значение ячейки будет False.
Использование Microsoft Excel
Чтобы разместить элемент управления флажком на вашем листе, выполните следующие шаги:
- Убедитесь, что отображается панель инструментов Формы.
- Нажмите на инструмент Флажок на панели инструментов Формы.
- В области вашего листа нажмите и перетащите, чтобы определить прямоугольник, в котором будет размещен флажок и метка рядом с флажком.
- После размещения флажка перейдите курсором мыши в область метки и измените метку.
- В поле Cell Link укажите адрес ячейки, к которой должен быть привязан этот флажок.
- Нажмите на ОК.
Использование Aspose.Cells
Aspose.Cells предоставляет класс CheckBoxCollection, который используется для добавления нового флажка в коллекцию. Еще один класс, Aspose.Cells.Drawing.CheckBox, представляет флажок. Он имеет некоторые важные члены:
- Cвойство LinkedCell указывает ячейку, с которой связан флажок.
- Cвойство Text указывает текстовую строку, связанную с флажком. Это метка флажка.
- Cвойство Value указывает, отмечен ли флажок.
В следующем примере показано, как добавить флажок на лист.
Добавление элемента управления кнопкой радио на лист
Кнопка радио или кнопка опции — это элемент управления в форме круглого фрагмента, пользователь принимает решение, выбирая круглый фрагмент. Кнопка радио обычно, если не всегда, сопровождается другими. Такие кнопки радио отображаются и действуют как группа. Пользователь определяет, какая кнопка является действительной, выбирая только одну из них. При выборе одной кнопки она заполняется. Когда выбрана одна кнопка из группы, кнопки той же группы остаются пустыми.
Использование Microsoft Excel
Для размещения элемента управления кнопкой радио на листе выполните следующие шаги:
- Убедитесь, что панель Формы отображается.
- Нажмите инструмент Кнопка опции.
- На листе щелкните и перетащите для определения прямоугольника, который будет содержать кнопку опции и метку рядом с кнопкой опции.
- После размещения кнопки радио на листе перейдите курсором мыши в область метки и измените метку.
- В поле Cell Link укажите адрес ячейки, к которой должна быть привязана эта кнопка радио.
- Нажмите ОК.
Использование Aspose.Cells
Класс Aspose.Cells.Drawing.ShapeCollection предоставляет метод с именем AddRadioButton, который используется для добавления элемента управления кнопкой радио на лист. Метод возвращает объект Aspose.Cells.Drawing.RadioButton. КлассAspose.Cells.Drawing.RadioButton представляет кнопку опции. Он имеет некоторые важные члены:
- Cвойство LinkedCell указывает ячейку, с которой связана кнопка радио.
- Cвойство Text указывает текстовую строку, связанную с кнопкой радио. Это метка кнопки радио.
- Cвойство IsChecked указывает, выбрана ли кнопка радио или нет.
- Свойство FillFormat определяет формат заполнения переключателя.
- Свойство LineFormat определяет стили формата линии переключателя.
В следующем примере показано, как добавить переключатели на рабочий лист. Пример добавляет три радиокнопки, представляющие возрастные группы.
Добавление элемента управления ‘Комбинированный список’ на рабочий лист
Для упрощения ввода данных или ограничения ввода определенных элементов, можно создать комбинированный список или раскрывающийся список допустимых записей, которые собраны из ячеек в другом месте рабочего листа. Когда вы создаете раскрывающийся список для ячейки, рядом с этой ячейкой отображается стрелка. Чтобы ввести информацию в эту ячейку, щелкните стрелку, а затем щелкните нужную запись.
Использование Microsoft Excel
Чтобы разместить элемент управления ‘Комбинированный список’ на рабочем листе, выполните следующие шаги:
- Убедитесь, что панель Формы отображается.
- Щелкните инструмент Комбинированный список.
- В области рабочего листа нажмите и перетащите, чтобы определить прямоугольник, который будет содержать комбинированный список.
- Как только комбинированный список размещен на рабочем листе, щелкните правой кнопкой мыши по элементу управления и выберите Формат элемента управления, чтобы указать диапазон ввода.
- В поле Связь с ячейкой укажите адрес ячейки, к которой должен быть привязан этот комбинированный список.
- Нажмите на ОК.
Использование Aspose.Cells
Класс Aspose.Cells.Drawing.ShapeCollection предоставляет метод с именем AddComboBox, который используется для добавления элемента управления ‘Комбинированный список’ на рабочий лист. Метод возвращает объект Aspose.Cells.Drawing.ComboBox. Класс Aspose.Cells.Drawing.ComboBox представляет комбинированный список. У него есть некоторые важные члены:
- Свойство LinkedCell определяет ячейку, которая привязана к комбинированному списку.
- Свойство InputRange определяет диапазон ячеек рабочего листа, используемых для заполнения комбинированного списка.
- Свойство DropDownLines определяет количество строк списка, отображаемых в раскрывающейся части комбинированного списка.
- Свойство Shadow указывает, имеет ли комбинированный список 3D-теневую окраску.
В следующем примере показано, как добавить комбинированный список на рабочий лист.
Добавление элемента управления ‘Метка’ на рабочий лист
Метки - это средство предоставления пользователям информации о содержании таблицы. Aspose.Cells позволяет добавлять и управлять метками на рабочем листе. Класс ShapeCollection предоставляет метод с именем AddLabel, используемый для добавления элемента управления ‘Метка’ на рабочий лист. Метод возвращает объект Label. Класс Label представляет метку на рабочем листе. У него есть некоторые важные члены:
- Метод Text указывает строку заголовка метки.
- Метод Placement указывает PlacementType - способ прикрепления метки к ячейкам в листе.
В следующем примере показано, как добавить метку на лист.
Добавление элемента управления список на листе
Элемен управления список создает элемент управления, который позволяет выбирать один или несколько элементов.
Использование Microsoft Excel
Чтобы разместить элемент управления список на листе:
- Убедитесь, что панель Формы отображается.
- Нажмите кнопку Элемент управления список.
- В области вашего листа щелкните и перетащите, чтобы определить прямоугольник, который будет содержать список.
- Как только элемент управления списка размещен на листе, щелкните правой кнопкой мыши на элементе управления и щелкните Форматировать элемент управления, чтобы указать диапазон ввода.
- В поле Связь с ячейкой укажите адрес ячейки, с которой должен быть связан этот список, и установите атрибут типа выбора (Одиночный, Множественный, Расширенный)
- Нажмите ОК.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddListBox, который используется для добавления элемента управления списка на лист. Метод возвращает объект Aspose.Cells.Drawing.ListBox. Класс ListBox представляет список. У него есть несколько важных членов:
- Метод LinkedCell указывает ячейку, которая связана с элементом управления списка.
- Метод InputRange указывает диапазон ячеек листа, использующихся для заполнения списка.
- Метод SelectionType указывает режим выбора элементов списка.
- Метод Shadow указывает, имеет ли список 3D-затенение.
В следующем примере показано, как добавить список на лист.
Добавление элемента управления кнопка на лист
Кнопки полезны для выполнения некоторых действий. Иногда полезно назначить макрос VBA на кнопку или назначить гиперссылку для открытия веб-страницы.
Использование Microsoft Excel
Чтобы разместить элемент управления кнопка на вашем листе:
- Убедитесь, что панель Формы отображается.
- Щелкните инструмент Кнопка.
- В области вашего листа щелкните и перетащите для определения прямоугольника, который будет содержать кнопку.
- Как только список размещен на листе, щелкните правой кнопкой мыши на элементе управления и выберите Формат управления, затем укажите VBA-макрос и атрибуты, касающиеся шрифта, выравнивания, размера, полей и т. д.
- Нажмите на ОК.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddButton, используемый для добавления элемента управления кнопкой на лист. Метод возвращает объект Aspose.Cells.Drawing.Button. Класс Aspose.Cells.Drawing.Button представляет кнопку. У него есть некоторые важные члены:
- Свойство Text определяет заголовок кнопки.
- Свойство Font определяет атрибуты шрифта для подписи элемента управления кнопкой.
- Свойство Placement определяет PlacementType, способ, которым кнопка присоединена к ячейкам на листе.
- Свойство AddHyperlink добавляет гиперссылку для элемента управления кнопкой. При нажатии на кнопку будет выполнено переход по связанному URL.
Приведенный ниже пример показывает, как добавить кнопку на лист.
Добавление линейного элемента управления на лист
Использование Microsoft Excel
- На панели инструментов Рисование щелкните Автофигуры, наведите указатель на Линии и выберите стиль линии.
- Перетащите для создания линии.
- Выполните одно или оба из следующего:
- Для ограничения углов рисования линии под углом 15 градусов от начальной точки удерживайте клавишу SHIFT при перетаскивании.
- Чтобы удлинить линию в противоположных направлениях от первой конечной точки, удерживайте клавишу CTRL при перетаскивании.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddLine, который используется для добавления формы линии на лист. Метод возвращает объект LineShape. Класс LineShape представляет линию. У него есть некоторые важные члены:
- Метод LineFormat определяет формат линии.
- Метод Placement определяет PlacementType, способ, которым линия присоединена к ячейкам на листе.
Следующий пример показывает, как добавить линии на лист. Создаются три линии с разными стилями.
Добавление стрелки к линии
Aspose.Cells также позволяет вам рисовать стрелки. Возможно добавление стрелки к линии и форматирование линии. Например, вы можете изменить цвет линии или указать ее толщину и стиль.
Следующий пример показывает, как добавить стрелку к линии.
Добавление прямоугольного контроля на лист
Aspose.Cells позволяет вам рисовать прямоугольные формы в ваших листах. Вы можете создать прямоугольник, квадрат и т. д. Вы также можете форматировать цвет заливки и цвет граничной линии контроля. Например, вы можете изменить цвет прямоугольника, задать цвет заливки, указать толщину и стиль прямоугольника по вашему усмотрению.
Использование Microsoft Excel
- На панели Рисование щелкните Прямоугольник.
- Перетащите, чтобы нарисовать прямоугольник.
- Выполните одно или оба из следующего:
- Чтобы ограничить прямоугольник и нарисовать квадрат от его начальной точки, удерживайте клавишу SHIFT во время перетаскивания.
- Чтобы нарисовать прямоугольник из центральной точки, удерживайте клавишу CTRL во время перетаскивания.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddRectangle, который используется для добавления прямоугольной формы на лист. Метод возвращает объект Aspose.Cells.Drawing.RectangleShape. Класс Aspose.Cells.Drawing.RectangleShape представляет прямоугольник. У него есть несколько важных членов:
- Свойство LineFormat указывает атрибуты форматирования линии прямоугольника.
- Свойство Placement указывает PlacementType, способ, которым прямоугольник прикреплен к ячейкам на листе.
- Свойство FillFormat указывает стили форматирования заливки прямоугольника.
Следующий пример показывает, как добавить прямоугольник на лист.
Добавление дугового контроля на лист
Aspose.Cells позволяет вам рисовать дуговые формы на ваших листах. Вы можете создавать простые и заполненные дуги. Вы можете форматировать цвет заливки и цвет граничной линии контроля. Например, вы можете указать / изменить цвет дуги, установить цвет заливки, указать толщину и стиль формы по вашему усмотрению.
Использование Microsoft Excel
- На панели Рисование щелкните Дуга в Автофигуры.
- Перетащите, чтобы нарисовать дугу.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddArc, который используется для добавления формы дуги на лист. Метод возвращает объект Aspose.Cells.Drawing.ArcShape. Класс Aspose.Cells.Drawing.ArcShape представляет дугу. У него есть некоторые важные члены:
- Свойство LineFormat определяет атрибуты формата линии формы дуги.
- Свойство Placement определяет PlacementType, способ, которым дуга присоединена к ячейкам на листе.
- Свойство FillFormat определяет стили формата заливки формы.
- Свойство LowerRightRow определяет индекс строки нижнего правого угла.
- Свойство LowerRightColumn определяет индекс столбца нижнего правого угла.
В следующем примере показано, как добавить формы дуг на лист. Пример создает две формы дуги: одну заполненную, а другую простую.
Добавление овального элемента управления на лист
Aspose.Cells позволяет вам рисовать овальные формы на листах. Создайте простые и закрашенные овальные формы и отформатируйте цвет заливки и цвет граничной линии элемента управления. Например, вы можете указать / изменить цвет овала, установить цвет закрашивания, указать вес и стиль формы.
Использование Microsoft Excel
- На панели инструментов Рисование щелкните Овал.
- Перетащите, чтобы нарисовать овал.
- Выполните одно или оба следующих действия:
- Чтобы ограничить овал и нарисовать круг из его начальной точки, зажмите клавишу SHIFT при перетаскивании.
- Чтобы нарисовать овал из центральной точки, удерживайте клавишу CTRL при перетаскивании.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddOval, который используется для добавления овальной формы на лист. Метод возвращает объект Aspose.Cells.Drawing.Oval. Класс Aspose.Cells.Drawing.Oval представляет овальную форму. У него есть некоторые важные члены:
- Свойство LineFormat определяет атрибуты формата линии овальной формы.
- Свойство Placement определяет PlacementType, способ, которым овал присоединен к ячейкам на листе.
- Свойство FillFormat определяет стили формата заливки формы.
- Свойство LowerRightRow определяет индекс строки нижнего правого угла.
- Свойство LowerRightColumn определяет индекс столбца нижнего правого угла.
В следующем примере показано, как добавить овальные формы на лист. Пример создает две овальные формы: одна заполнена, а другая представляет собой просто кружок.
Добавление элемента управления спинбокс на лист
Спинбокс - это текстовое поле, присоединенное к кнопке (называемой спинкнопка), состоящей из стрелки вверх и стрелки вниз, по которой вы щелкаете для пошагового изменения значения в текстовом поле. Используя спинбоксы, вы можете видеть, как изменения ввода влияют на модель вывода в вашей финансовой модели. Вы можете присоединить спинкнопку к определенной ячейке ввода. Когда вы нажимаете на стрелку вверх или вниз на спинкнопке, целочисленное значение в целевой ячейке ввода увеличивается или уменьшается. Aspose.Cells позволяет вам создавать спинбоксы на ваших листах.
Использование Microsoft Excel
Чтобы разместить элемент управления спинбокс на листе:
- Убедитесь, что отображается панель инструментов Формы.
- Щелкните инструмент Спиннер.
- В области вашего листа щелкните и перетащите, чтобы определить прямоугольник, который будет содержать спиннер.
- Как только спиннер размещен на листе, щелкните правой кнопкой мыши по элементу управления и выберите Форматировать элемент управления и укажите максимальное, минимальное и инкрементальное значения.
- В поле Связь с ячейкой укажите адрес ячейки, к которой должен быть привязан этот спинбокс.
- Щелкните OK.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddSpinner, который используется для добавления элемента управления спинбокс на лист. Метод возвращает объект Aspose.Cells.Drawing.Spinner. Класс Aspose.Cells.Drawing.Spinner представляет собой спинбокс. Он имеет некоторые важные члены:
- Свойство LinkedCell указывает на ячейку, которая привязана к спинбоксу.
- Свойство Max указывает максимальное значение для диапазона спинбокса.
- Свойство Min указывает минимальное значение для диапазона спинбокса.
- Свойство IncrementalChange указывает значение инкремента для построчной прокрутки спиннера.
- Свойство Shadow указывает, имеет ли спинбокс трехмерную тень.
- Свойство CurrentValue указывает текущее значение спинбокса.
В следующем примере показано, как добавить спинбокс на лист.
Добавление полосы прокрутки на лист
Элемент управления полосой прокрутки используется для выбора данных на листе аналогичным образом спинбоксу. Добавляя элемент управления к листу и привязывая его к ячейке, можно вернуть числовое значение текущего положения элемента управления.
Использование Microsoft Excel
- Чтобы добавить полосу прокрутки в Excel 2003 и более ранних версиях, щелкните кнопку Полоса Прокрутки на панели Формы и затем создайте полосу прокрутки, которая занимает ячейки B2:B6 по высоте и примерно четверть ширины столбца.
- Чтобы добавить полосу прокрутки в Excel 2007, щелкните вкладку Разработчик, затем Вставка и выберите Полоса Прокрутки в разделе Элементы управления формы.
- Щелкните правой кнопкой мыши на полосе прокрутки, затем выберите Формат управления.
- Введите следующую информацию и нажмите OK:
- В поле Текущее значение введите 1.
- В поле Минимальное значение введите 1. Это значение ограничивает верхнюю границу полосы прокрутки первым элементом в списке.
- В поле Максимальное значение введите 20. Это число указывает максимальное количество записей в списке.
- В поле Инкрементное изменение введите 1. Это значение управляет количеством чисел, на которое элемент управления полосой прокрутки приращивает текущее значение.
- В поле Изменение страницы введите 5. Эта запись управляет тем, насколько увеличится текущее значение при щелчке внутри полосы прокрутки с обеих сторон ползунка.
- Чтобы поместить числовое значение в ячейку G1 (в зависимости от выбранного элемента в списке), введите G1 в поле Ссылка на ячейку.
- Щелкните на любой ячейке, чтобы полоса прокрутки не была выбрана.
Когда вы щелкаете на управление вверх или вниз на полосе прокрутки, ячейка G1 обновляется числом, указывающим текущее значение полосы прокрутки плюс или минус инкрементальное изменение полосы прокрутки.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddScrollBar, который используется для добавления элемента управления полосой прокрутки на лист. Метод возвращает объект Aspose.Cells.Drawing.ScrollBar. Класс Aspose.Cells.Drawing.ScrollBar представляет полосу прокрутки. Он имеет некоторые важные члены:
- Свойство LinkedCell указывает на ячейку, которая связана с полосой прокрутки.
- Свойство Max устанавливает максимальное значение для диапазона полосы прокрутки.
- Свойство Min устанавливает минимальное значение для диапазона полосы прокрутки.
- Свойство IncrementalChange указывает количество значений, на которое увеличится полоса прокрутки линейного прокрутки.
- Свойство Shadow указывает, есть ли на полосе прокрутки 3D теневые эффекты.
- Свойство CurrentValue устанавливает текущее значение полосы прокрутки.
- Свойство PageChange указывает, насколько увеличится текущее значение, если вы щелкнете внутри полосы прокрутки с обеих сторон ползунка.
Приведенный пример показывает, как добавить полосу прокрутки на листе.
Добавление элемента управления GroupBox в элементы управления на листе
Иногда вам необходимо реализовать радиокнопки или другие элементы управления, которые принадлежат определенной группе, это можно сделать, включив в группу элемент управления GroupBox или прямоугольник. Любой из этих двух объектов будет служить разделителем группы. После добавления одной из этих форм, можно добавить две или более радиокнопок или других объектов группы.
Использование Microsoft Excel
Чтобы разместить элемент управления GroupBox на листе и разместить в нем элементы управления:
- Чтобы запустить форму, на главной панели меню щелкните Просмотр, а затем Панели инструментов и Формы.
- На панели инструментов Формы щелкните GroupBox и нарисуйте прямоугольник на листе.
- Введите строку заголовка для рамки.
- На панели инструментов Формы щелкните Option Button и щелкните внутри элемента GroupBox прямо под строкой заголовка.
- Снова на панели инструментов Формы щелкните Option Button и щелкните внутри Group Box под первой радиокнопкой.
- Еще раз на панели инструментов Формы щелкните Option Button и щелкните внутри Group Box под предыдущей радиокнопкой.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddGroupBox, который используется для добавления элемента управления GroupBox на лист. Метод возвращает объект Aspose.Cells.Drawing.GroupBox. Кроме того, метод Group класса ShapeCollection группирует формы, он принимает массив Shape в качестве параметра и возвращает объект GroupShape. Класс Aspose.Cells.Drawing.GroupBox представляет элемент управления GroupBox. У него есть некоторые важные члены:
- Свойство Text указывает строку заголовка элемента управления GroupBox.
- Свойство Shadow указывает, имеет ли элемент управления GroupBox трехмерную затененность.
Приведенный пример показывает, как добавить элемент управления GroupBox и сгруппировать элементы управления на листе.