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

Вступление

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

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

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

• получитьтекстовый кадр метод возвращаетМсотекстфрейм объект, используемый для настройки содержимого текстового поля.
• setPlacement метод определяет тип размещения.
• установитьШрифт метод определяет атрибуты шрифта.
• добавить гиперссылку добавляет гиперссылку для текстового поля.
• ЗаполнитьФормат недвижимость возвращаетсяМсофиллформат объект, используемый для установки формата заполнения для текстового поля.
• LineFormat свойство возвращаетМсолинеформат объект, обычно используемый для стиля и веса строки текстового поля.
• setText метод задает вводимый текст для текстового поля.

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

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

На листе создаются два текстовых поля.

// 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 также позволяет вам получать доступ к текстовым полям на листах конструктора и управлять ими. ИспользоватьРабочий лист.getTextBoxes свойство, чтобы получить коллекцию текстовых полей на листе.

В следующем примере используется файл Excel Microsoft — 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");

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

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

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

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

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

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

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

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

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

CheckBox добавляется на лист

// 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");

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

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

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

Чтобы разместить элемент управления Radio Button на листе, выполните следующие действия.

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

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

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

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

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

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

// 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");

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

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

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

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

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

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

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

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

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

Поле со списком добавляется на лист

// 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 позволяет добавлять метки и управлять ими на листе.Коллекция формКласс предоставляет метод с именем addShape, используемый для добавления элемента управления меткой на рабочий лист. Метод возвращает объект Label. Класс Label представляет собой метку на рабочем листе. В него входят несколько важных членов:

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

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

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

// 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. вCell Ссылкаполе, укажите адрес ячейки, к которой этот список должен быть привязан, и установите атрибут типа выбора (Одиночный, Несколько, Расширить)
6. НажмитеХОРОШО.

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

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

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

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

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

// 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

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

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

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

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

// 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. Выполните одно или оба из следующих действий:
4. Чтобы линия рисовалась под углом 15 градусов от начальной точки, удерживайте нажатой клавишу SHIFT при перетаскивании.
5. Чтобы удлинить линию в противоположных направлениях от первой конечной точки, удерживайте нажатой клавишу CTRL при перетаскивании.

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

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

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

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

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

// 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 также позволяет рисовать линии со стрелками. К строке можно добавить стрелку и отформатировать строку. Например, вы можете изменить цвет линии или указать толщину и стиль линии.

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

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

// 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. Выполните одно или оба из следующих действий:
4. Чтобы заставить прямоугольник рисовать квадрат из начальной точки, удерживайте нажатой клавишу SHIFT при перетаскивании.
5. Чтобы нарисовать прямоугольник из центральной точки, удерживайте нажатой клавишу CTRL при перетаскивании.

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

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

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

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

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

// 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

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

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

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

На рабочий лист добавляются две дуги

// 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. Выполните одно или оба из следующих действий:
4. Чтобы заставить овал рисовать окружность из начальной точки, удерживайте нажатой клавишу SHIFT при перетаскивании.
5. Чтобы нарисовать овал из центральной точки, удерживайте нажатой клавишу CTRL при перетаскивании.

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

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

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

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

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

// 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");

Предварительные темы

• Добавьте элементы управления ActiveX, используя Aspose.Cells.
• Удалить элемент управления ActiveX