Управление элементами управления

Contents
[ ]

Введение

Разработчики могут добавлять различные графические объекты, такие как текстовые поля, флажки, переключатели, комбинированные поля выбора, ярлыки, кнопки, линии, прямоугольники, дуги, овалы, спиннеры, полосы прокрутки, групповые рамки и т. д. Aspose.Cells предоставляет пространство имен Aspose.Cells.Drawing, которое содержит все графические объекты. Однако есть несколько графических объектов или форм, которые пока не поддерживаются. Создайте эти графические объекты в электронной таблице дизайнера с помощью Microsoft Excel, а затем импортируйте электронную таблицу дизайнера в Aspose.Cells. Aspose.Cells позволяет загружать эти графические объекты из электронной таблицы дизайнера и записывать их в созданный файл.

Добавление элемента управления текстовым полем на листе

Один из способов выделить важную информацию в отчете - использовать текстовое поле. Например, добавьте текст для выделения названия компании или для обозначения географического региона с наивысшими продажами и т. д. Aspose.Cells предоставляет класс TextBoxes, используемый для добавления нового текстового поля в коллекцию. Есть еще один класс, TextBox, который представляет текстовое поле для определения всех типов настроек. У него есть несколько важных членов:

  • Метод getTextFrame возвращает объект MsoTextFrame, используемый для корректировки содержимого текстового поля.
  • Метод setPlacement указывает тип размещения.
  • Метод setFont указывает атрибуты шрифта.
  • Метод addHyperlink добавляет гиперссылку для текстового поля.
  • Свойство FillFormat возвращает объект MsoFillFormat, используемый для установки формата заливки для текстового поля.
  • Свойство LineFormat возвращает объект MsoLineFormat, обычно используемый для стиля и толщины линии текстового поля.
  • Метод setText устанавливает входной текст для текстового поля.

В следующем примере создаются два текстовых поля на первом листе книги. Первое текстовое поле хорошо оборудовано различными настройками формата. Второе является простым.

Следующий вывод генерируется выполнением кода:

На рабочем листе создано два текстовых поля

todo:image_alt_text

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingTextBoxControl.class) + "DrawingObjects/";
// Instantiate a new Workbook.
Workbook workbook = new Workbook();
// Get the first worksheet in the book.
Worksheet worksheet = workbook.getWorksheets().get(0);
// Get the textbox object.
int textboxIndex = worksheet.getTextBoxes().add(2, 1, 160, 200);
TextBox textbox0 = worksheet.getTextBoxes().get(textboxIndex);
// Fill the text.
textbox0.setText("ASPOSE______The .NET & JAVA Component Publisher!");
// Set the placement.
textbox0.setPlacement(PlacementType.FREE_FLOATING);
// Set the font color.
textbox0.getFont().setColor(Color.getBlue());
// Set the font to bold.
textbox0.getFont().setBold(true);
// Set the font size.
textbox0.getFont().setSize(14);
// Set font attribute to italic.
textbox0.getFont().setItalic(true);
// Add a hyperlink to the textbox.
textbox0.addHyperlink("http://www.aspose.com/");
// Get the filformat of the textbox.
FillFormat fillformat = textbox0.getFill();
// Set the fillcolor.
fillformat.setOneColorGradient(Color.getSilver(), 1, GradientStyleType.HORIZONTAL, 1);
// Get the lineformat type of the textbox.
LineFormat lineformat = textbox0.getLine();
// Set the line style.
lineformat.setDashStyle(MsoLineStyle.THIN_THICK);
// Set the line weight.
lineformat.setWeight(6);
// Set the dash style to squaredot.
lineformat.setDashStyle(MsoLineDashStyle.SQUARE_DOT);
// Get the second textbox.
TextBox textbox1 = (com.aspose.cells.TextBox) worksheet.getShapes().addShape(MsoDrawingType.TEXT_BOX, 15, 0, 4,
0, 85, 120);
// Input some text to it.
textbox1.setText("This is another simple text box");
// Set the placement type as the textbox will move and resize with cells.
textbox1.setPlacement(PlacementType.MOVE_AND_SIZE);
// Save the excel file.
workbook.save(dataDir + "AddingTextBoxControl_out.xls");

Управление элементами управления текстовыми полями в дизайнерских электронных таблицах

Aspose.Cells также позволяет вам получать доступ к текстовым полям в электронных таблицах дизайнера и манипулировать ими. Используйте свойство Worksheet.getTextBoxes, чтобы получить коллекцию текстовых полей на листе.

В следующем примере используется файл Microsoft Excel – tsttextboxes.xls – который мы создали в вышеприведенном примере. Он получает текстовые строки двух текстовых полей и изменяет текст второго текстового поля для сохранения файла.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(ManipulatingTextBoxControls.class);
// Instantiate a new Workbook.
Workbook workbook = new Workbook(dataDir + "book1.xls");
// Get the first worksheet in the book.
Worksheet worksheet = workbook.getWorksheets().get(0);
// Get the first textbox object.
com.aspose.cells.TextBox textbox0 = worksheet.getTextBoxes().get(0);
// Obtain the text in the first textbox.
String text0 = textbox0.getText();
System.out.println(text0);
// Get the second textbox object.
com.aspose.cells.TextBox textbox1 = worksheet.getTextBoxes().get(1);
// Obtain the text in the second textbox.
String text1 = textbox1.getText();
// Change the text of the second textbox.
textbox1.setText("This is an alternative text");
// Save the excel file.
workbook.save(dataDir + "tsttextboxes1.xls");

Добавление элемента управления флажком в рабочий лист

Флажки удобны, если вы хотите предоставить пользователю возможность выбрать между двумя вариантами, например, true или false; да или нет. Aspose.Cells позволяет использовать флажки на листах. Например, вы можете создать рабочую книгу с финансовым прогнозом, в которой нужно учесть определенное приобретение или нет. В этом случае вы можете разместить флажок наверху листа. Затем вы можете связать состояние этого флажка с другой ячейкой, чтобы, если флажок выбран, значение ячейки будет True; если он не выбран, значение ячейки будет False.

Использование Microsoft Excel

Чтобы разместить элемент управления флажком на вашем листе, выполните следующие шаги:

  1. Убедитесь, что отображается панель инструментов Формы.
  2. Нажмите на инструмент Флажок на панели инструментов Формы.
  3. В области вашего листа нажмите и перетащите, чтобы определить прямоугольник, в котором будет размещен флажок и метка рядом с флажком.
  4. После размещения флажка перейдите курсором мыши в область метки и измените метку.
  5. В поле Cell Link укажите адрес ячейки, к которой должен быть привязан этот флажок.
  6. Нажмите на ОК.

Использование Aspose.Cells

Aspose.Cells предоставляет класс CheckBoxCollection, который используется для добавления нового флажка в коллекцию. Еще один класс, Aspose.Cells.Drawing.CheckBox, представляет флажок. Он имеет некоторые важные члены:

  • Метод setLinkedCell устанавливает ячейку, к которой связан флажок.
  • Метод setText устанавливает текстовую строку, связанную с флажком. Это метка флажка.
  • Метод setValue указывает, установлен ли флажок или нет.

Далее приведен пример того, как добавить флажок на лист. Результат ниже генерируется после выполнения кода.

На листе добавлен флажок

todo:image_alt_text

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(AddingCheckBoxControl.class);
// Instantiate a new Workbook.
Workbook workbook = new Workbook();
// Get the first worksheet in the book.
Worksheet worksheet = workbook.getWorksheets().get(0);
// Add a checkbox to the first worksheet in the workbook.
int checkBoxIndex = worksheet.getCheckBoxes().add(5, 5, 100, 120);
CheckBox checkBox = worksheet.getCheckBoxes().get(checkBoxIndex);
// Set its text string.
checkBox.setText("Check it!");
// Put a value into B1 cell.
worksheet.getCells().get("B1").setValue("LnkCell");
// Set B1 cell as a linked cell for the checkbox.
checkBox.setLinkedCell("=B1");
// Save the excel file.
workbook.save(dataDir + "tstcheckboxes.xls");

Добавление элемента управления радиокнопкой на лист

Кнопка радио или кнопка опции — это элемент управления в форме круглого фрагмента, пользователь принимает решение, выбирая круглый фрагмент. Кнопка радио обычно, если не всегда, сопровождается другими. Такие кнопки радио отображаются и действуют как группа. Пользователь определяет, какая кнопка является действительной, выбирая только одну из них. При выборе одной кнопки она заполняется. Когда выбрана одна кнопка из группы, кнопки той же группы остаются пустыми.

Использование Microsoft Excel

Для размещения элемента управления кнопкой радио на листе выполните следующие шаги:

  1. Убедитесь, что панель Формы отображается.
  2. Нажмите инструмент Кнопка опции.
  3. На листе щелкните и перетащите для определения прямоугольника, который будет содержать кнопку опции и метку рядом с кнопкой опции.
  4. После размещения кнопки радио на листе перейдите курсором мыши в область метки и измените метку.
  5. В поле Cell Link укажите адрес ячейки, к которой должна быть привязана эта кнопка радио.
  6. Нажмите ОК.

Использование Aspose.Cells

Класс ShapeCollection предоставляет метод с именем addShape, который может использоваться для добавления элемента управления радиокнопкой на лист. Метод может вернуть объект RadioButton. Класс RadioButton представляет элемент управления опцией. Он имеет некоторые важные члены:

  • Метод setLinkedCell указывает ячейку, которая связана с радиокнопкой.
  • Метод setText указывает текстовую строку, связанную с радиокнопкой. Это подпись радиокнопки.
  • Свойство Checked указывает, установлена ли радиокнопка или нет.
  • Метод setFillFormat указывает формат заливки радиокнопки.
  • Метод setLineFormat указывает стили формата линии элемента управления опцией.

Далее приведен пример того, как добавить радиокнопки на лист. В примере добавляются три радиокнопки, представляющие возрастные группы. Результат, приведенный ниже, будет получен после выполнения кода.

На листе добавлены некоторые радиокнопки

todo:image_alt_text

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingRadioButtonControl.class) + "DrawingObjects/";
// Create a new Workbook.
Workbook workbook = new Workbook();
// Get the first worksheet.
Worksheet sheet = workbook.getWorksheets().get(0);
// Get the worksheet cells collection.
Cells cells = sheet.getCells();
// Insert a value.
cells.get("C2").setValue("Age Groups");
Style style = cells.get("B3").getStyle();
style.getFont().setBold(true);
// Set it bold.
cells.get("C2").setStyle(style);
// Add a radio button to the first sheet.
com.aspose.cells.RadioButton radio1 = (com.aspose.cells.RadioButton) sheet.getShapes()
.addShape(MsoDrawingType.RADIO_BUTTON, 3, 0, 1, 0, 20, 100);
// Set its text string.
radio1.setText("20-29");
// Set A1 cell as a linked cell for the radio button.
radio1.setLinkedCell("A1");
// Make the radio button 3-D.
radio1.setShadow(true);
// Set the foreground color of the radio button.
radio1.getFill().setOneColorGradient(Color.getGreen(), 1, GradientStyleType.HORIZONTAL, 1);
// set the line style of the radio button.
radio1.getLine().setDashStyle(MsoLineStyle.THICK_THIN);
// Set the weight of the radio button.
radio1.getLine().setWeight(4);
// Set the line color of the radio button.
radio1.getLine().setOneColorGradient(Color.getBlue(), 1, GradientStyleType.HORIZONTAL, 1);
// Set the dash style of the radio button.
radio1.getLine().setDashStyle(MsoLineDashStyle.SOLID);
// Add another radio button to the first sheet.
com.aspose.cells.RadioButton radio2 = (com.aspose.cells.RadioButton) sheet.getShapes()
.addShape(MsoDrawingType.RADIO_BUTTON, 6, 0, 1, 0, 20, 100);
// Set its text string.
radio2.setText("30-39");
// Set A1 cell as a linked cell for the radio button.
radio2.setLinkedCell("A1");
// Make the radio button 3-D.
radio2.setShadow(true);
// Set the foreground color of the radio button.
radio2.getFill().setOneColorGradient(Color.getGreen(), 1, GradientStyleType.HORIZONTAL, 1);
// set the line style of the radio button.
radio2.getLine().setDashStyle(MsoLineStyle.THICK_THIN);
// Set the weight of the radio button.
radio2.getLine().setWeight(4);
// Set the line color of the radio button.
radio2.getLine().setOneColorGradient(Color.getBlue(), 1, GradientStyleType.HORIZONTAL, 1);
// Set the dash style of the radio button.
radio2.getLine().setDashStyle(MsoLineDashStyle.SOLID);
// Add another radio button to the first sheet.
com.aspose.cells.RadioButton radio3 = (com.aspose.cells.RadioButton) sheet.getShapes()
.addShape(MsoDrawingType.RADIO_BUTTON, 9, 0, 1, 0, 20, 100);
// Set its text string.
radio3.setText("40-49");
// Set A1 cell as a linked cell for the radio button.
radio3.setLinkedCell("A1");
// Make the radio button 3-D.
radio3.setShadow(true);
// Set the foreground color of the radio button.
radio3.getFill().setOneColorGradient(Color.getGreen(), 1, GradientStyleType.HORIZONTAL, 1);
// set the line style of the radio button.
radio3.getLine().setDashStyle(MsoLineStyle.THICK_THIN);
// Set the weight of the radio button.
radio3.getLine().setWeight(4);
// Set the line color of the radio button.
radio3.getLine().setOneColorGradient(Color.getBlue(), 1, GradientStyleType.HORIZONTAL, 1);
// Set the dash style of the radio button.
radio3.getLine().setDashStyle(MsoLineDashStyle.SOLID);
// Save the excel file.
workbook.save(dataDir + "ARBControl_out.xls");

Добавление элемента управления ‘Комбинированный список’ на рабочий лист

Для упрощения ввода данных или ограничения ввода определенных элементов, можно создать комбинированный список или раскрывающийся список допустимых записей, которые собраны из ячеек в другом месте рабочего листа. Когда вы создаете раскрывающийся список для ячейки, рядом с этой ячейкой отображается стрелка. Чтобы ввести информацию в эту ячейку, щелкните стрелку, а затем щелкните нужную запись.

Использование Microsoft Excel

Чтобы разместить элемент управления ‘Комбинированный список’ на рабочем листе, выполните следующие шаги:

  1. Убедитесь, что панель Формы отображается.
  2. Щелкните инструмент Комбинированный список.
  3. В области рабочего листа нажмите и перетащите, чтобы определить прямоугольник, который будет содержать комбинированный список.
  4. Как только комбинированный список размещен на рабочем листе, щелкните правой кнопкой мыши по элементу управления и выберите Формат элемента управления, чтобы указать диапазон ввода.
  5. В поле Связь с ячейкой укажите адрес ячейки, к которой должен быть привязан этот комбинированный список.
  6. Нажмите на ОК.

Использование Aspose.Cells

Класс ShapeCollection предоставляет метод с именем addShape, который можно использовать для добавления элемента управления комбинированным списком на лист. Метод может возвращать объект ComboBox. Класс ComboBox представляет комбинированный список. В нем есть несколько важных членов:

  • Метод setLinkedCell задает ячейку, которая связана с комбинированным списком.
  • Метод setInputRange указывает диапазон ячеек на листе, используемых для заполнения комбинированного списка.
  • Метод setDropDownLines указывает количество отображаемых строк списка в выпадающей части комбинированного списка.
  • Метод setShadow указывает, имеет ли комбинированный список трехмерное затенение.

В следующем примере показано, как добавить комбинированный список на лист. При выполнении кода генерируется следующий вывод.

На листе добавлен комбинированный список

todo:image_alt_text

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(AddingComboBoxControl.class);
// Create a new Workbook.
Workbook workbook = new Workbook();
// Get the first worksheet.
Worksheet sheet = workbook.getWorksheets().get(0);
// Get the worksheet cells collection.
Cells cells = sheet.getCells();
// Input a value.
cells.get("B3").setValue("Employee:");
Style style = cells.get("B3").getStyle();
style.getFont().setBold(true);
// Set it bold.
cells.get("B3").setStyle(style);
// Input some values that denote the input range for the combo box.
cells.get("A2").setValue("Emp001");
cells.get("A3").setValue("Emp002");
cells.get("A4").setValue("Emp003");
cells.get("A5").setValue("Emp004");
cells.get("A6").setValue("Emp005");
cells.get("A7").setValue("Emp006");
// Add a new combo box.
com.aspose.cells.ComboBox comboBox = (com.aspose.cells.ComboBox) sheet.getShapes()
.addShape(MsoDrawingType.COMBO_BOX, 3, 0, 1, 0, 20, 100);
// Set the linked cell;
comboBox.setLinkedCell("A1");
// Set the input range.
comboBox.setInputRange("=A2:A7");
// Set no. of list lines displayed in the combo box's list portion.
comboBox.setDropDownLines(5);
// Set the combo box with 3-D shading.
comboBox.setShadow(true);
// AutoFit Columns
sheet.autoFitColumns();
// Saves the file.
workbook.save(dataDir + "tstcombobox.xls");

Добавление элемента управления ‘Метка’ на рабочий лист

Метки - это средство предоставления пользователям информации о содержании электронных таблиц. Aspose.Cells позволяет добавлять и управлять метками на листе. Класс ShapeCollection предоставляет метод с именем addShape, используемый для добавления элемента управления меткой на лист. Метод возвращает объект Label. Класс Label представляет метку на листе. У него есть несколько важных членов:

  • Метод setText задает подпись метки.
  • Метод setPlacement указывает тип расположения, способ, которым метка прикреплена к ячейкам на листе.

В следующем примере показано, как добавить метку на лист. При выполнении кода генерируется следующий вывод.

Метка добавлена на листе

todo:image_alt_text

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingLabelControl.class) + "DrawingObjects/";
// Create a new Workbook.
Workbook workbook = new Workbook();
// Get the first worksheet.
Worksheet sheet = workbook.getWorksheets().get(0);
// Add a new label to the worksheet.
com.aspose.cells.Label label = (com.aspose.cells.Label) sheet.getShapes().addShape(MsoDrawingType.LABEL, 2, 2,
2, 0, 60, 120);
// Set the caption of the label.
label.setText("This is a Label");
// Set the Placement Type, the way the label is attached to the cells.
label.setPlacement(PlacementType.FREE_FLOATING);
// Set the fill color of the label.
label.getFill().setOneColorGradient(Color.getYellow(), 1, GradientStyleType.HORIZONTAL, 1);
// Saves the file.
workbook.save(dataDir + "AddingLabelControl_out.xls");

Добавление элемента управления список на листе

Элемен управления список создает элемент управления, который позволяет выбирать один или несколько элементов.

Использование Microsoft Excel

Чтобы разместить элемент управления список на листе:

  1. Убедитесь, что панель Формы отображается.
  2. Нажмите кнопку Элемент управления список.
  3. В области вашего листа щелкните и перетащите, чтобы определить прямоугольник, который будет содержать список.
  4. Как только элемент управления списка размещен на листе, щелкните правой кнопкой мыши на элементе управления и щелкните Форматировать элемент управления, чтобы указать диапазон ввода.
  5. В поле Связь с ячейкой укажите адрес ячейки, с которой должен быть связан этот список, и установите атрибут типа выбора (Одиночный, Множественный, Расширенный)
  6. Нажмите ОК.

Использование Aspose.Cells

Класс ShapeCollection предоставляет метод с именем addShape, который используется для добавления элемента управления списка на лист. Метод возвращает объект ListBox. Класс ListBox представляет список. У него есть несколько важных членов:

  • Метод setLinkedCell указывает на связанную с списком ячейку.
  • Метод setInputRange указывает диапазон ячеек на листе, используемый для заполнения списка.
  • Метод setSelectionType указывает режим выбора списка.
  • Метод setShadow указывает, имеет ли список трехмерную тень.

Приведенный ниже пример показывает, как добавить список на лист. При выполнении кода генерируется следующий результат.

Список добавлен на лист

todo:image_alt_text

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(AddingListBoxControl.class);
// Create a new Workbook.
Workbook workbook = new Workbook();
// Get the first worksheet.
Worksheet sheet = workbook.getWorksheets().get(0);
// Get the worksheet cells collection.
Cells cells = sheet.getCells();
// Input a value.
cells.get("B3").setValue("Choose Dept:");
Style style = cells.get("B3").getStyle();
style.getFont().setBold(true);
// Set it bold.
cells.get("B3").setStyle(style);
// Input some values that denote the input range for the combo box.
cells.get("A2").setValue("Sales");
cells.get("A3").setValue("Finance");
cells.get("A4").setValue("MIS");
cells.get("A5").setValue("R&D");
cells.get("A6").setValue("Marketing");
cells.get("A7").setValue("HRA");
// Add a new list box.
com.aspose.cells.ListBox listBox = (com.aspose.cells.ListBox) sheet.getShapes()
.addShape(MsoDrawingType.LIST_BOX, 3, 3, 1, 0, 100, 122);
// Set the linked cell;
listBox.setLinkedCell("A1");
// Set the input range.
listBox.setInputRange("=A2:A7");
// Set the Placement Type, the way the list box is attached to the cells.
listBox.setPlacement(PlacementType.FREE_FLOATING);
// Set the list box with 3-D shading.
listBox.setShadow(true);
// Set the selection type.
listBox.setSelectionType(SelectionType.SINGLE);
// AutoFit Columns
sheet.autoFitColumns();
// Saves the file.
workbook.save(dataDir + "tstlistbox.xls");

Добавление элемента управления кнопка на лист

Кнопки полезны для выполнения некоторых действий. Иногда полезно назначить макрос VBA на кнопку или назначить гиперссылку для открытия веб-страницы.

Использование Microsoft Excel

Чтобы разместить элемент управления кнопка на вашем листе:

  1. Убедитесь, что панель Формы отображается.
  2. Щелкните инструмент Кнопка.
  3. В области вашего листа щелкните и перетащите для определения прямоугольника, который будет содержать кнопку.
  4. Как только список размещен на листе, щелкните правой кнопкой мыши на элементе управления и выберите Формат управления, затем укажите VBA-макрос и атрибуты, касающиеся шрифта, выравнивания, размера, полей и т. д.
  5. Нажмите на ОК.

Использование Aspose.Cells

ShapeCollection класс предоставляет метод с именем addShape, используемый для добавления элемента управления кнопкой на рабочий лист. Метод может вернуть объект кнопки. Класс Button представляет кнопку. Он имеет несколько важных членов:

  • Метод setText указывает заголовок кнопки.
  • Метод setPlacement указывает тип размещения, способ, которым кнопка прикреплена к ячейкам на рабочем листе.
  • Метод addHyperlink добавляет гиперссылку для элемента управления кнопкой. При нажатии на кнопку будет осуществлен переход по связанному URL.

В следующем примере показано, как добавить кнопку на рабочий лист. Ниже приведен результат выполнения кода:

Кнопка добавлена в рабочий лист

todo:image_alt_text

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(AddingButtonControl.class);
// Create a new Workbook.
Workbook workbook = new Workbook();
// Get the first worksheet.
Worksheet sheet = workbook.getWorksheets().get(0);
// Add a new button to the worksheet.
com.aspose.cells.Button button = (com.aspose.cells.Button) sheet.getShapes().addShape(MsoDrawingType.BUTTON, 2,
2, 2, 0, 20, 80);
// Set the caption of the button.
button.setText("Aspose");
// Set the Placement Type, the way the button is attached to the cells.
button.setPlacement(PlacementType.FREE_FLOATING);
// Set the font name.
button.getFont().setName("Tahoma");
// Set the caption string bold.
button.getFont().setBold(true);
// Set the color to blue.
button.getFont().setColor(Color.getBlue());
// Set the hyperlink for the button.
button.addHyperlink("http://www.aspose.com/");
// Saves the file.
workbook.save(dataDir + "tstbutton.xls");

Добавление линейного элемента управления на рабочий лист

Aspose.Cells позволяет рисовать автофигуры на рабочих листах. Вы можете легко создать линию. Также вы можете форматировать линию. Например, вы можете изменить цвет линии, указать толщину и стиль линии по вашему усмотрению.

Использование Microsoft Excel

  1. На панели инструментов Рисование щелкните Автофигуры, наведите указатель на Линии и выберите стиль линии.
  2. Перетащите для создания линии.
  3. Выполните одно или оба из следующего:
    1. Для ограничения углов рисования линии под углом 15 градусов от начальной точки удерживайте клавишу SHIFT при перетаскивании.
    2. Чтобы удлинить линию в противоположных направлениях от первой конечной точки, удерживайте клавишу CTRL при перетаскивании.

Использование Aspose.Cells

ShapeCollection класс предоставляет метод с именем addShape, который используется для добавления формы линии на рабочий лист. Метод может вернуть объект LineShape. Класс LineShape представляет линию. Он имеет несколько важных членов:

  • Метод setDashStyle указывает формат линии.
  • Метод setPlacement указывает тип размещения, способ, которым линия прикреплена к ячейкам на рабочем листе.

Приведенный пример показывает, как добавить линии на рабочий лист. Создаются три линии с различными стилями. Следующий вывод генерируется после выполнения кода

На рабочий лист добавлены несколько линий

todo:image_alt_text

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingLineControl.class) + "DrawingObjects/";
//Instantiate a new Workbook.
Workbook workbook = new Workbook();
//Get the first worksheet in the book.
Worksheet worksheet = workbook.getWorksheets().get(0);
//Add a new line to the worksheet.
LineShape line1 = (LineShape)worksheet.getShapes().addShape(MsoDrawingType.LINE,5, 1,0,0, 0, 250);
line1.setHasLine(true);
//Set the line dash style
LineFormat shapeline = line1.getLine();
shapeline.setDashStyle(MsoLineDashStyle.SOLID);
//Set the placement.
line1.setPlacement(PlacementType.FREE_FLOATING);
//Add another line to the worksheet.
LineShape line2 = (LineShape) worksheet.getShapes().addShape(MsoDrawingType.LINE, 7, 1,0,0, 85, 250);
line2.setHasLine(true);
//Set the line dash style.
shapeline = line2.getLine();
shapeline.setDashStyle(MsoLineDashStyle.DASH_LONG_DASH);
shapeline.setWeight(4);
//Set the placement.
line2.setPlacement(PlacementType.FREE_FLOATING);
//Add the third line to the worksheet.
LineShape line3 = (LineShape)worksheet.getShapes().addShape(MsoDrawingType.LINE, 13, 1,0,0, 0, 250);
line3.setHasLine(true);
//Set the line dash style
shapeline = line1.getLine();
shapeline.setDashStyle(MsoLineDashStyle.SOLID);
//Set the placement.
line3.setPlacement(PlacementType.FREE_FLOATING);
//Save the excel file.
workbook.save(dataDir + "tstlines.xls");

Добавление стрелочки к линии

Aspose.Cells также позволяет вам рисовать стрелки. Возможно добавление стрелки к линии и форматирование линии. Например, вы можете изменить цвет линии или указать ее толщину и стиль.

Приведенный пример показывает, как добавить стрелочку к линии. Следующий вывод генерируется при выполнении кода.

На рабочий лист добавлена линия с стрелочкой

todo:image_alt_text

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddinganArrowHead.class) + "DrawingObjects/";
//Instantiate a new Workbook.
Workbook workbook = new Workbook();
//Get the first worksheet in the book.
Worksheet worksheet = workbook.getWorksheets().get(0);
//Add a line to the worksheet
LineShape line2 = (LineShape) worksheet.getShapes().addShape(MsoDrawingType.LINE, 7, 0, 1, 0, 85, 250);
//Set the line color
line2.getLine().setFillType(FillType.SOLID);
line2.getLine().getSolidFill().setColor(Color.getRed());
//Set the weight of the line.
line2.getLine().setWeight(3);
//Set the placement.
line2.setPlacement(PlacementType.FREE_FLOATING);
//Set the line arrows.
line2.getLine().setEndArrowheadWidth(MsoArrowheadWidth.MEDIUM);
line2.getLine().setEndArrowheadStyle(MsoArrowheadStyle.ARROW);
line2.getLine().setEndArrowheadLength(MsoArrowheadLength.MEDIUM);
line2.getLine().setBeginArrowheadStyle(MsoArrowheadStyle.ARROW_DIAMOND);
line2.getLine().setBeginArrowheadLength(MsoArrowheadLength.MEDIUM);
//Make the gridlines invisible in the first worksheet.
workbook.getWorksheets().get(0).setGridlinesVisible(false);
//Save the excel file.
workbook.save(dataDir + "AddinganArrowHead_out.xlsx");

Добавление прямоугольного контроля на лист

Aspose.Cells позволяет вам рисовать прямоугольные формы в ваших листах. Вы можете создать прямоугольник, квадрат и т. д. Вы также можете форматировать цвет заливки и цвет граничной линии контроля. Например, вы можете изменить цвет прямоугольника, задать цвет заливки, указать толщину и стиль прямоугольника по вашему усмотрению.

Использование Microsoft Excel

  1. На панели Рисование щелкните Прямоугольник.
  2. Перетащите, чтобы нарисовать прямоугольник.
  3. Выполните одно или оба из следующего:
    1. Чтобы ограничить прямоугольник и нарисовать квадрат от его начальной точки, удерживайте клавишу SHIFT во время перетаскивания.
    2. Чтобы нарисовать прямоугольник из центральной точки, удерживайте клавишу CTRL во время перетаскивания.

Использование Aspose.Cells

Класс ShapeCollection предоставляет метод addShape, который используется для добавления прямоугольной формы на рабочий лист. Метод может возвращать объект RectangleShape. Класс RectangleShape представляет собой прямоугольник. У него есть несколько важных членов:

  • Метод setLineFormat указывает атрибуты формата линии прямоугольника.
  • Метод setPlacement указывает тип размещения, способ, которым прямоугольник прикреплен к ячейкам на рабочем листе.
  • Свойство FillFormat указывает стили формата заливки прямоугольника.

Приведенный пример показывает, как добавить прямоугольник на рабочий лист. Следующий вывод генерируется при выполнении кода.

На рабочий лист добавлен прямоугольник

todo:image_alt_text

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingRectangleControl.class) + "DrawingObjects/";
// Instantiate a new Workbook.
Workbook excelbook = new Workbook();
// Add a rectangle control.
com.aspose.cells.RectangleShape rectangle = (com.aspose.cells.RectangleShape) excelbook.getWorksheets().get(0)
.getShapes().addShape(MsoDrawingType.RECTANGLE, 3, 2, 0, 0, 70, 130);
// Set the placement of the rectangle.
rectangle.setPlacement(PlacementType.FREE_FLOATING);
// Set the fill format.
FillFormat fillformat = rectangle.getFill();
fillformat.setOneColorGradient(Color.getOlive(), 1, GradientStyleType.HORIZONTAL, 1);
// Set the line style.
LineFormat linestyle = rectangle.getLine();
linestyle.setDashStyle(MsoLineStyle.THICK_THIN);
// Set the line weight.
linestyle.setWeight(4);
// Set the color of the line.
linestyle.setOneColorGradient(Color.getBlue(), 1, GradientStyleType.HORIZONTAL, 1);
// Set the dash style of the rectangle.
linestyle.setDashStyle(MsoLineDashStyle.SOLID);
// Save the excel file.
excelbook.save(dataDir + "AddingRectangleControl_out.xls");

Добавление дугового контроля на лист

Aspose.Cells позволяет вам рисовать дуговые формы на ваших листах. Вы можете создавать простые и заполненные дуги. Вы можете форматировать цвет заливки и цвет граничной линии контроля. Например, вы можете указать / изменить цвет дуги, установить цвет заливки, указать толщину и стиль формы по вашему усмотрению.

Использование Microsoft Excel

  1. На панели Рисование щелкните Дуга в Автофигуры.
  2. Перетащите, чтобы нарисовать дугу.

Использование Aspose.Cells

Класс ShapeCollection предоставляет метод с именем addShape, который используется для добавления дуговой формы на лист. Метод может возвращать объект ArcShape. Класс ArcShape представляет собой дугу. У него есть несколько важных членов:

  • Метод setLineFormat указывает атрибуты формата линии дуговой формы.
  • Метод setPlacement указывает тип размещения, способ, которым дуга привязана к ячейкам на листе.
  • Cвойство FillFormat указывает стили формата заливки для формы.

Приведенный ниже пример показывает, как добавить дуговые формы на лист. Пример создает две дуговые формы: одна закрашена, а другая - простая. Следующий вывод генерируется при выполнении кода

На лист добавлены две дуговые формы

todo:image_alt_text

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingArcControl.class) + "DrawingObjects/";
// Instantiate a new Workbook.
Workbook excelbook = new Workbook();
// Add an arc shape.
com.aspose.cells.ArcShape arc1 = (com.aspose.cells.ArcShape) excelbook.getWorksheets().get(0).getShapes()
.addShape(MsoDrawingType.ARC, 2, 2, 0, 0, 130, 130);
// Set the placement of the arc.
arc1.setPlacement(PlacementType.FREE_FLOATING);
// Set the fill format.
FillFormat fillformat = arc1.getFill();// getFillFormat();
fillformat.setOneColorGradient(Color.getLime(), 1, GradientStyleType.HORIZONTAL, 1);
//setForeColor(Color.getBlue());
// Set the line style.
LineFormat lineformat = arc1.getLine();// getLineFormat();
lineformat.setDashStyle(MsoLineStyle.SINGLE); //setStyle(MsoLineStyle.SINGLE);
// Set the line weight.
lineformat.setWeight(1);
// Set the color of the arc line.
lineformat.setOneColorGradient(Color.getLime(), 1, GradientStyleType.HORIZONTAL, 1); //setForeColor(Color.getBlue());
// Set the dash style of the arc.
lineformat.setDashStyle(MsoLineDashStyle.SOLID);
// Add another arc shape.
com.aspose.cells.ArcShape arc2 = (com.aspose.cells.ArcShape) excelbook.getWorksheets().get(0).getShapes()
.addShape(MsoDrawingType.ARC, 9, 2, 0, 0, 130, 130);
// Set the placement of the arc.
arc2.setPlacement(PlacementType.FREE_FLOATING);
// Set the line style.
LineFormat lineformat1 = arc2.getLine(); //getLineFormat();
lineformat1.setDashStyle(MsoLineStyle.SINGLE);
// Set the line weight.
lineformat1.setWeight(1);
// Set the color of the arc line.
lineformat1.setOneColorGradient(Color.getLime(), 1, GradientStyleType.HORIZONTAL, 1);//setForeColor(Color.getBlue());
// Set the dash style of the arc.
lineformat1.setDashStyle(MsoLineDashStyle.SOLID);
// Save the excel file.
excelbook.save(dataDir + "AddingArcControl_out.xls");

Добавление овального элемента управления на лист

Aspose.Cells позволяет вам рисовать овальные формы на листах. Создайте простые и закрашенные овальные формы и отформатируйте цвет заливки и цвет граничной линии элемента управления. Например, вы можете указать / изменить цвет овала, установить цвет закрашивания, указать вес и стиль формы.

Использование Microsoft Excel

  1. На панели инструментов Рисование щелкните Овал.
  2. Перетащите, чтобы нарисовать овал.
  3. Выполните одно или оба из следующего:
    1. Чтобы ограничить овал и нарисовать круг из его начальной точки, удерживайте клавишу SHIFT при перетаскивании.
    2. Чтобы нарисовать овал из центральной точки, удерживайте клавишу CTRL при перетаскивании.

Использование Aspose.Cells

Класс ShapeCollection предоставляет метод с именем addShape, который используется для добавления овальной формы на лист. Метод может возвращать объект Oval. Класс Oval представляет овальную форму. У него есть несколько важных членов:

  • Метод setLineFormat указывает атрибуты формата линии овальной формы.
  • Метод setPlacement указывает PlacementType, способ, которым овал привязан к ячейкам на листе.
  • Cвойство FillFormat указывает стили формата заливки для формы.

Следующий пример показывает, как добавить овальные формы на лист. В примере создаются две овальные формы: одна заполненная, а вторая - просто круг. Пример кода генерирует следующий вывод.

На лист добавлены две овальные формы

todo:image_alt_text

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddinganOvalControl.class) + "DrawingObjects/";
// Instantiate a new Workbook.
Workbook excelbook = new Workbook();
// Add an oval shape.
Oval oval1 = (com.aspose.cells.Oval) excelbook.getWorksheets().get(0).getShapes().addShape(MsoDrawingType.OVAL,
2, 2, 0, 0, 130, 130);
// Set the placement of the oval.
oval1.setPlacement(PlacementType.FREE_FLOATING);
// Set the fill format.
FillFormat fillformat = oval1.getFill();// getFillFormat();
fillformat.setOneColorGradient(Color.getNavy(), 1, GradientStyleType.HORIZONTAL, 1);
// Set the line style.
LineFormat lineformat = oval1.getLine();// getLineFormat();
lineformat.setDashStyle(MsoLineStyle.SINGLE); //setStyle(MsoLineStyle.SINGLE);
// Set the line weight.
lineformat.setWeight(1);
// Set the color of the oval line.
lineformat.setOneColorGradient(Color.getGreen(), 1, GradientStyleType.HORIZONTAL, 1);
// Set the dash style of the oval.
lineformat.setDashStyle(MsoLineDashStyle.SOLID);
// Add another arc shape.
Oval oval2 = (com.aspose.cells.Oval) excelbook.getWorksheets().get(0).getShapes().addShape(MsoDrawingType.OVAL,
9, 2, 0, 0, 130, 130);
// Set the placement of the oval.
oval2.setPlacement(PlacementType.FREE_FLOATING);
// Set the line style.
LineFormat lineformat1 = oval2.getLine();
lineformat.setDashStyle(MsoLineStyle.SINGLE); //setStyle(MsoLineStyle.SINGLE);
// Set the line weight.
lineformat1.setWeight(1);
// Set the color of the oval line.
lineformat1.setOneColorGradient(Color.getBlue(),1, GradientStyleType.HORIZONTAL, 1);
// Set the dash style of the oval.
lineformat1.setDashStyle(MsoLineDashStyle.SOLID);
// Save the excel file.
excelbook.save(dataDir + "AddinganOvalControl_out.xls");

Продвинутые темы