Управление элементами управления
Введение
Разработчики могут добавлять различные графические объекты, такие как текстовые поля, флажки, переключатели, комбинированные поля выбора, ярлыки, кнопки, линии, прямоугольники, дуги, овалы, спиннеры, полосы прокрутки, групповые рамки и т. д. 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 определяет входной текст для текстового поля.
В следующем примере создаются два текстовых поля на первом листе книги. Первое текстовое поле хорошо оборудовано различными настройками формата. Второе является простым.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Instantiate a new Workbook. | |
Workbook workbook = new Workbook(); | |
// Get the first worksheet in the book. | |
Worksheet worksheet = workbook.Worksheets[0]; | |
// Add a new textbox to the collection. | |
int textboxIndex = worksheet.TextBoxes.Add(2, 1, 160, 200); | |
// Get the textbox object. | |
Aspose.Cells.Drawing.TextBox textbox0 = worksheet.TextBoxes[textboxIndex]; | |
// Fill the text. | |
textbox0.Text = "ASPOSE______The .NET & JAVA Component Publisher!"; | |
// Get the textbox text frame. | |
//MsoTextFrame textframe0 = textbox0.TextFrame; | |
// Set the textbox to adjust it according to its contents. | |
//textframe0.AutoSize = true; | |
// Set the placement. | |
textbox0.Placement = PlacementType.FreeFloating; | |
// Set the font color. | |
textbox0.Font.Color = Color.Blue; | |
// Set the font to bold. | |
textbox0.Font.IsBold = true; | |
// Set the font size. | |
textbox0.Font.Size = 14; | |
// Set font attribute to italic. | |
textbox0.Font.IsItalic = true; | |
// Add a hyperlink to the textbox. | |
textbox0.AddHyperlink("http:// Www.aspose.com/"); | |
// Get the filformat of the textbox. | |
Aspose.Cells.Drawing.FillFormat fillformat = textbox0.Fill; | |
// Get the lineformat type of the textbox. | |
Aspose.Cells.Drawing.LineFormat lineformat = textbox0.Line; | |
// Set the line weight. | |
lineformat.Weight = 6; | |
// Set the dash style to squaredot. | |
lineformat.DashStyle = MsoLineDashStyle.SquareDot; | |
// Add another textbox. | |
textboxIndex = worksheet.TextBoxes.Add(15, 4, 85, 120); | |
// Get the second textbox. | |
Aspose.Cells.Drawing.TextBox textbox1 = worksheet.TextBoxes[textboxIndex]; | |
// Input some text to it. | |
textbox1.Text = "This is another simple text box"; | |
// Set the placement type as the textbox will move and | |
// Resize with cells. | |
textbox1.Placement = PlacementType.MoveAndSize; | |
// Save the excel file. | |
workbook.Save(dataDir + "book1.out.xls"); |
Манипулирование элементами управления текстовыми полями в электронных таблицах дизайнера
Aspose.Cells также позволяет вам получать доступ к текстовым полям в электронных таблицах дизайнера и манипулировать ими. Используйте свойство Worksheet.TextBoxes, чтобы получить коллекцию текстовых полей на листе.
В следующем примере используется файл Microsoft Excel, созданный в вышеприведенном примере. Он получает текстовые строки двух текстовых полей и изменяет текст второго текстового поля для сохранения файла.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Instantiate a new Workbook. | |
// Open the existing excel file. | |
Workbook workbook = new Workbook(dataDir + "book1.xls"); | |
// Get the first worksheet in the book. | |
Worksheet worksheet = workbook.Worksheets[0]; | |
// Get the first textbox object. | |
Aspose.Cells.Drawing.TextBox textbox0 = worksheet.TextBoxes[0]; | |
// Obtain the text in the first textbox. | |
string text0 = textbox0.Text; | |
// Get the second textbox object. | |
Aspose.Cells.Drawing.TextBox textbox1 = worksheet.TextBoxes[1]; | |
// Obtain the text in the second textbox. | |
string text1 = textbox1.Text; | |
// Change the text of the second textbox. | |
textbox1.Text = "This is an alternative text"; | |
// Save the excel file. | |
workbook.Save(dataDir + "output.out.xls"); |
Добавление элемента управления флажком на лист
Флажки удобны, если вы хотите предоставить пользователю возможность выбрать между двумя вариантами, например, 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 указывает, отмечен ли флажок.
В следующем примере показано, как добавить флажок на лист.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Instantiate a new Workbook. | |
Workbook excelbook = new Workbook(); | |
// Add a checkbox to the first worksheet in the workbook. | |
int index = excelbook.Worksheets[0].CheckBoxes.Add(5, 5, 100, 120); | |
// Get the checkbox object. | |
Aspose.Cells.Drawing.CheckBox checkbox = excelbook.Worksheets[0].CheckBoxes[index]; | |
// Set its text string. | |
checkbox.Text = "Click it!"; | |
// Put a value into B1 cell. | |
excelbook.Worksheets[0].Cells["B1"].PutValue("LnkCell"); | |
// Set B1 cell as a linked cell for the checkbox. | |
checkbox.LinkedCell = "B1"; | |
// Check the checkbox by default. | |
checkbox.Value = true; | |
// Save the excel file. | |
excelbook.Save(dataDir + "book1.out.xls"); |
Добавление элемента управления кнопкой радио на лист
Кнопка радио или кнопка опции — это элемент управления в форме круглого фрагмента, пользователь принимает решение, выбирая круглый фрагмент. Кнопка радио обычно, если не всегда, сопровождается другими. Такие кнопки радио отображаются и действуют как группа. Пользователь определяет, какая кнопка является действительной, выбирая только одну из них. При выборе одной кнопки она заполняется. Когда выбрана одна кнопка из группы, кнопки той же группы остаются пустыми.
Использование 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-теневую окраску.
В следующем примере показано, как добавить комбинированный список на рабочий лист.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Create a new Workbook. | |
Workbook workbook = new Workbook(); | |
// Get the first worksheet. | |
Worksheet sheet = workbook.Worksheets[0]; | |
// Get the worksheet cells collection. | |
Cells cells = sheet.Cells; | |
// Input a value. | |
cells["B3"].PutValue("Employee:"); | |
// Set it bold. | |
cells["B3"].GetStyle().Font.IsBold = true; | |
// Input some values that denote the input range | |
// For the combo box. | |
cells["A2"].PutValue("Emp001"); | |
cells["A3"].PutValue("Emp002"); | |
cells["A4"].PutValue("Emp003"); | |
cells["A5"].PutValue("Emp004"); | |
cells["A6"].PutValue("Emp005"); | |
cells["A7"].PutValue("Emp006"); | |
// Add a new combo box. | |
Aspose.Cells.Drawing.ComboBox comboBox = sheet.Shapes.AddComboBox(2, 0, 2, 0, 22, 100); |
Добавление элемента управления ‘Метка’ на рабочий лист
Метки - это средство предоставления пользователям информации о содержании таблицы. Aspose.Cells позволяет добавлять и управлять метками на рабочем листе. Класс ShapeCollection предоставляет метод с именем AddLabel, используемый для добавления элемента управления ‘Метка’ на рабочий лист. Метод возвращает объект Label. Класс Label представляет метку на рабочем листе. У него есть некоторые важные члены:
- Метод Text указывает строку заголовка метки.
- Метод Placement указывает PlacementType - способ прикрепления метки к ячейкам в листе.
В следующем примере показано, как добавить метку на лист.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Create a new Workbook. | |
Workbook workbook = new Workbook(); | |
// Get the first worksheet in the workbook. | |
Worksheet sheet = workbook.Worksheets[0]; | |
// Add a new label to the worksheet. | |
Aspose.Cells.Drawing.Label label = sheet.Shapes.AddLabel(2, 0, 2, 0, 60, 120); | |
// Set the caption of the label. | |
label.Text = "This is a Label"; | |
// Set the Placement Type, the way the | |
// Label is attached to the cells. | |
label.Placement = PlacementType.FreeFloating; | |
// Saves the file. | |
workbook.Save(dataDir + "book1.out.xls"); |
Добавление элемента управления список на листе
Элемен управления список создает элемент управления, который позволяет выбирать один или несколько элементов.
Использование Microsoft Excel
Чтобы разместить элемент управления список на листе:
- Убедитесь, что панель Формы отображается.
- Нажмите кнопку Элемент управления список.
- В области вашего листа щелкните и перетащите, чтобы определить прямоугольник, который будет содержать список.
- Как только элемент управления списка размещен на листе, щелкните правой кнопкой мыши на элементе управления и щелкните Форматировать элемент управления, чтобы указать диапазон ввода.
- В поле Связь с ячейкой укажите адрес ячейки, с которой должен быть связан этот список, и установите атрибут типа выбора (Одиночный, Множественный, Расширенный)
- Нажмите ОК.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddListBox, который используется для добавления элемента управления списка на лист. Метод возвращает объект Aspose.Cells.Drawing.ListBox. Класс ListBox представляет список. У него есть несколько важных членов:
- Метод LinkedCell указывает ячейку, которая связана с элементом управления списка.
- Метод InputRange указывает диапазон ячеек листа, использующихся для заполнения списка.
- Метод SelectionType указывает режим выбора элементов списка.
- Метод Shadow указывает, имеет ли список 3D-затенение.
В следующем примере показано, как добавить список на лист.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Create a new Workbook. | |
Workbook workbook = new Workbook(); | |
// Get the first worksheet. | |
Worksheet sheet = workbook.Worksheets[0]; | |
// Get the worksheet cells collection. | |
Cells cells = sheet.Cells; | |
// Input a value. | |
cells["B3"].PutValue("Choose Dept:"); | |
// Set it bold. | |
cells["B3"].GetStyle().Font.IsBold = true; | |
// Input some values that denote the input range | |
// For the list box. | |
cells["A2"].PutValue("Sales"); | |
cells["A3"].PutValue("Finance"); | |
cells["A4"].PutValue("MIS"); | |
cells["A5"].PutValue("R&D"); | |
cells["A6"].PutValue("Marketing"); | |
cells["A7"].PutValue("HRA"); | |
// Add a new list box. | |
Aspose.Cells.Drawing.ListBox listBox = sheet.Shapes.AddListBox(2, 0, 3, 0, 122, 100); | |
// Set the placement type. | |
listBox.Placement = PlacementType.FreeFloating; | |
// Set the linked cell. | |
listBox.LinkedCell = "A1"; | |
// Set the input range. | |
listBox.InputRange = "A2:A7"; | |
// Set the selection tyle. | |
listBox.SelectionType = SelectionType.Single; | |
// Set the list box with 3-D shading. | |
listBox.Shadow = true; | |
// Saves the file. | |
workbook.Save(dataDir + "book1.out.xls"); |
Добавление элемента управления кнопка на лист
Кнопки полезны для выполнения некоторых действий. Иногда полезно назначить макрос 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, способ, которым линия присоединена к ячейкам на листе.
Следующий пример показывает, как добавить линии на лист. Создаются три линии с разными стилями.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Instantiate a new Workbook. | |
Workbook workbook = new Workbook(); | |
// Get the first worksheet in the book. | |
Worksheet worksheet = workbook.Worksheets[0]; | |
// Add a new line to the worksheet. | |
Aspose.Cells.Drawing.LineShape line1 = worksheet.Shapes.AddLine(5, 0, 1, 0, 0, 250); | |
// Set the line dash style | |
line1.Line.DashStyle = MsoLineDashStyle.Solid; | |
// Set the placement. | |
line1.Placement = PlacementType.FreeFloating; | |
// Add another line to the worksheet. | |
Aspose.Cells.Drawing.LineShape line2 = worksheet.Shapes.AddLine(7, 0, 1, 0, 85, 250); | |
// Set the line dash style. | |
line2.Line.DashStyle = MsoLineDashStyle.DashLongDash; | |
// Set the weight of the line. | |
line2.Line.Weight = 4; | |
// Set the placement. | |
line2.Placement = PlacementType.FreeFloating; | |
// Add the third line to the worksheet. | |
Aspose.Cells.Drawing.LineShape line3 = worksheet.Shapes.AddLine(13, 0, 1, 0, 0, 250); | |
// Set the line dash style | |
line3.Line.DashStyle = MsoLineDashStyle.Solid; | |
// Set the placement. | |
line3.Placement = PlacementType.FreeFloating; | |
// Make the gridlines invisible in the first worksheet. | |
workbook.Worksheets[0].IsGridlinesVisible = false; | |
// Save the excel file. | |
workbook.Save(dataDir + "book1.out.xls"); |
Добавление стрелки к линии
Aspose.Cells также позволяет вам рисовать стрелки. Возможно добавление стрелки к линии и форматирование линии. Например, вы можете изменить цвет линии или указать ее толщину и стиль.
Следующий пример показывает, как добавить стрелку к линии.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Instantiate a new Workbook. | |
Workbook workbook = new Workbook(); | |
// Get the first worksheet in the book. | |
Worksheet worksheet = workbook.Worksheets[0]; | |
// Add a line to the worksheet | |
Aspose.Cells.Drawing.LineShape line2 = worksheet.Shapes.AddLine(7, 0, 1, 0, 85, 250); | |
// Set the line color | |
line2.Line.FillType = FillType.Solid; | |
line2.Line.SolidFill.Color = Color.Blue; | |
// Set the weight of the line. | |
line2.Line.Weight = 3; | |
// Set the placement. | |
line2.Placement = PlacementType.FreeFloating; | |
// Set the line arrows. | |
line2.Line.EndArrowheadWidth = MsoArrowheadWidth.Medium; | |
line2.Line.EndArrowheadStyle = MsoArrowheadStyle.Arrow; | |
line2.Line.EndArrowheadLength = MsoArrowheadLength.Medium; | |
line2.Line.BeginArrowheadStyle = MsoArrowheadStyle.ArrowDiamond; | |
line2.Line.BeginArrowheadLength = MsoArrowheadLength.Medium; | |
// Make the gridlines invisible in the first worksheet. | |
workbook.Worksheets[0].IsGridlinesVisible = false; | |
// Save the excel file. | |
workbook.Save(dataDir + "book1.out.xlsx"); |
Добавление прямоугольного контроля на лист
Aspose.Cells позволяет вам рисовать прямоугольные формы в ваших листах. Вы можете создать прямоугольник, квадрат и т. д. Вы также можете форматировать цвет заливки и цвет граничной линии контроля. Например, вы можете изменить цвет прямоугольника, задать цвет заливки, указать толщину и стиль прямоугольника по вашему усмотрению.
Использование Microsoft Excel
- На панели Рисование щелкните Прямоугольник.
- Перетащите, чтобы нарисовать прямоугольник.
- Выполните одно или оба из следующего:
- Чтобы ограничить прямоугольник и нарисовать квадрат от его начальной точки, удерживайте клавишу SHIFT во время перетаскивания.
- Чтобы нарисовать прямоугольник из центральной точки, удерживайте клавишу CTRL во время перетаскивания.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddRectangle, который используется для добавления прямоугольной формы на лист. Метод возвращает объект Aspose.Cells.Drawing.RectangleShape. Класс Aspose.Cells.Drawing.RectangleShape представляет прямоугольник. У него есть несколько важных членов:
- Свойство LineFormat указывает атрибуты форматирования линии прямоугольника.
- Свойство Placement указывает PlacementType, способ, которым прямоугольник прикреплен к ячейкам на листе.
- Свойство FillFormat указывает стили форматирования заливки прямоугольника.
Следующий пример показывает, как добавить прямоугольник на лист.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Instantiate a new Workbook. | |
Workbook excelbook = new Workbook(); | |
// Add a rectangle control. | |
Aspose.Cells.Drawing.RectangleShape rectangle = excelbook.Worksheets[0].Shapes.AddRectangle(3, 0, 2, 0, 70, 130); | |
// Set the placement of the rectangle. | |
rectangle.Placement = PlacementType.FreeFloating; | |
// Set the line weight. | |
rectangle.Line.Weight = 4; | |
// Set the dash style of the rectangle. | |
rectangle.Line.DashStyle = MsoLineDashStyle.Solid; | |
// Save the excel file. | |
excelbook.Save(dataDir + "book1.out.xls"); |
Добавление дугового контроля на лист
Aspose.Cells позволяет вам рисовать дуговые формы на ваших листах. Вы можете создавать простые и заполненные дуги. Вы можете форматировать цвет заливки и цвет граничной линии контроля. Например, вы можете указать / изменить цвет дуги, установить цвет заливки, указать толщину и стиль формы по вашему усмотрению.
Использование Microsoft Excel
- На панели Рисование щелкните Дуга в Автофигуры.
- Перетащите, чтобы нарисовать дугу.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddArc, который используется для добавления формы дуги на лист. Метод возвращает объект Aspose.Cells.Drawing.ArcShape. Класс Aspose.Cells.Drawing.ArcShape представляет дугу. У него есть некоторые важные члены:
- Свойство LineFormat определяет атрибуты формата линии формы дуги.
- Свойство Placement определяет PlacementType, способ, которым дуга присоединена к ячейкам на листе.
- Свойство FillFormat определяет стили формата заливки формы.
- Свойство LowerRightRow определяет индекс строки нижнего правого угла.
- Свойство LowerRightColumn определяет индекс столбца нижнего правого угла.
В следующем примере показано, как добавить формы дуг на лист. Пример создает две формы дуги: одну заполненную, а другую простую.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Instantiate a new Workbook. | |
Workbook excelbook = new Workbook(); | |
// Add an arc shape. | |
Aspose.Cells.Drawing.ArcShape arc1 = excelbook.Worksheets[0].Shapes.AddArc(2, 0, 2, 0, 130, 130); | |
// Set the fill shape color | |
arc1.Fill.FillType = FillType.Solid; | |
arc1.Fill.SolidFill.Color = Color.Blue; | |
// Set the placement of the arc. | |
arc1.Placement = PlacementType.FreeFloating; | |
// Set the line weight. | |
arc1.Line.Weight = 1; | |
// Set the dash style of the arc. | |
arc1.Line.DashStyle = MsoLineDashStyle.Solid; | |
// Add another arc shape. | |
Aspose.Cells.Drawing.ArcShape arc2 = excelbook.Worksheets[0].Shapes.AddArc(9, 0, 2, 0, 130, 130); | |
// Set the line color | |
arc2.Line.FillType = FillType.Solid; | |
arc2.Line.SolidFill.Color = Color.Blue; | |
// Set the placement of the arc. | |
arc2.Placement = PlacementType.FreeFloating; | |
// Set the line weight. | |
arc2.Line.Weight = 1; | |
// Set the dash style of the arc. | |
arc2.Line.DashStyle = MsoLineDashStyle.Solid; | |
// Save the excel file. | |
excelbook.Save(dataDir + "book1.out.xls"); |
Добавление овального элемента управления на лист
Aspose.Cells позволяет вам рисовать овальные формы на листах. Создайте простые и закрашенные овальные формы и отформатируйте цвет заливки и цвет граничной линии элемента управления. Например, вы можете указать / изменить цвет овала, установить цвет закрашивания, указать вес и стиль формы.
Использование Microsoft Excel
- На панели инструментов Рисование щелкните Овал.
- Перетащите, чтобы нарисовать овал.
- Выполните одно или оба следующих действия:
- Чтобы ограничить овал и нарисовать круг из его начальной точки, зажмите клавишу SHIFT при перетаскивании.
- Чтобы нарисовать овал из центральной точки, удерживайте клавишу CTRL при перетаскивании.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddOval, который используется для добавления овальной формы на лист. Метод возвращает объект Aspose.Cells.Drawing.Oval. Класс Aspose.Cells.Drawing.Oval представляет овальную форму. У него есть некоторые важные члены:
- Свойство LineFormat определяет атрибуты формата линии овальной формы.
- Свойство Placement определяет PlacementType, способ, которым овал присоединен к ячейкам на листе.
- Свойство FillFormat определяет стили формата заливки формы.
- Свойство LowerRightRow определяет индекс строки нижнего правого угла.
- Свойство LowerRightColumn определяет индекс столбца нижнего правого угла.
В следующем примере показано, как добавить овальные формы на лист. Пример создает две овальные формы: одна заполнена, а другая представляет собой просто кружок.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Instantiate a new Workbook. | |
Workbook excelbook = new Workbook(); | |
// Add an oval shape. | |
Aspose.Cells.Drawing.Oval oval1 = excelbook.Worksheets[0].Shapes.AddOval(2, 0, 2, 0, 130, 160); | |
// Set the placement of the oval. | |
oval1.Placement = PlacementType.FreeFloating; | |
// Set the line weight. | |
oval1.Line.Weight = 1; | |
// Set the dash style of the oval. | |
oval1.Line.DashStyle = MsoLineDashStyle.Solid; | |
// Add another oval (circle) shape. | |
Aspose.Cells.Drawing.Oval oval2 = excelbook.Worksheets[0].Shapes.AddOval(9, 0, 2, 15, 130, 130); | |
// Set the placement of the oval. | |
oval2.Placement = PlacementType.FreeFloating; | |
// Set the line weight. | |
oval2.Line.Weight = 1; | |
// Set the dash style of the oval. | |
oval2.Line.DashStyle = MsoLineDashStyle.Solid; | |
// Save the excel file. | |
excelbook.Save(dataDir + "book1.out.xls"); |
Добавление элемента управления спинбокс на лист
Спинбокс - это текстовое поле, присоединенное к кнопке (называемой спинкнопка), состоящей из стрелки вверх и стрелки вниз, по которой вы щелкаете для пошагового изменения значения в текстовом поле. Используя спинбоксы, вы можете видеть, как изменения ввода влияют на модель вывода в вашей финансовой модели. Вы можете присоединить спинкнопку к определенной ячейке ввода. Когда вы нажимаете на стрелку вверх или вниз на спинкнопке, целочисленное значение в целевой ячейке ввода увеличивается или уменьшается. Aspose.Cells позволяет вам создавать спинбоксы на ваших листах.
Использование Microsoft Excel
Чтобы разместить элемент управления спинбокс на листе:
- Убедитесь, что отображается панель инструментов Формы.
- Щелкните инструмент Спиннер.
- В области вашего листа щелкните и перетащите, чтобы определить прямоугольник, который будет содержать спиннер.
- Как только спиннер размещен на листе, щелкните правой кнопкой мыши по элементу управления и выберите Форматировать элемент управления и укажите максимальное, минимальное и инкрементальное значения.
- В поле Связь с ячейкой укажите адрес ячейки, к которой должен быть привязан этот спинбокс.
- Щелкните OK.
Использование Aspose.Cells
Класс ShapeCollection предоставляет метод с именем AddSpinner, который используется для добавления элемента управления спинбокс на лист. Метод возвращает объект Aspose.Cells.Drawing.Spinner. Класс Aspose.Cells.Drawing.Spinner представляет собой спинбокс. Он имеет некоторые важные члены:
- Свойство LinkedCell указывает на ячейку, которая привязана к спинбоксу.
- Свойство Max указывает максимальное значение для диапазона спинбокса.
- Свойство Min указывает минимальное значение для диапазона спинбокса.
- Свойство IncrementalChange указывает значение инкремента для построчной прокрутки спиннера.
- Свойство Shadow указывает, имеет ли спинбокс трехмерную тень.
- Свойство CurrentValue указывает текущее значение спинбокса.
В следующем примере показано, как добавить спинбокс на лист.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Instantiate a new Workbook. | |
Workbook excelbook = new Workbook(); | |
// Get the first worksheet. | |
Worksheet worksheet = excelbook.Worksheets[0]; | |
// Get the worksheet cells. | |
Cells cells = worksheet.Cells; | |
// Input a string value into A1 cell. | |
cells["A1"].PutValue("Select Value:"); | |
// Set the font color of the cell. | |
cells["A1"].GetStyle().Font.Color = Color.Red; | |
// Set the font text bold. | |
cells["A1"].GetStyle().Font.IsBold = true; | |
// Input value into A2 cell. | |
cells["A2"].PutValue(0); | |
// Set the shading color to black with solid background. | |
cells["A2"].GetStyle().ForegroundColor = Color.Black; | |
cells["A2"].GetStyle().Pattern = BackgroundType.Solid; | |
// Set the font color of the cell. | |
cells["A2"].GetStyle().Font.Color = Color.White; | |
// Set the font text bold. | |
cells["A2"].GetStyle().Font.IsBold = true; | |
// Add a spinner control. | |
Aspose.Cells.Drawing.Spinner spinner = excelbook.Worksheets[0].Shapes.AddSpinner(1, 0, 1, 0, 20, 18); | |
// Set the placement type of the spinner. | |
spinner.Placement = PlacementType.FreeFloating; | |
// Set the linked cell for the control. | |
spinner.LinkedCell = "A2"; | |
// Set the maximum value. | |
spinner.Max = 10; | |
// Set the minimum value. | |
spinner.Min = 0; | |
// Set the incr. change for the control. | |
spinner.IncrementalChange = 2; | |
// Set it 3-D shading. | |
spinner.Shadow = true; | |
// Save the excel file. | |
excelbook.Save(dataDir + "book1.out.xls"); |
Добавление полосы прокрутки на лист
Элемент управления полосой прокрутки используется для выбора данных на листе аналогичным образом спинбоксу. Добавляя элемент управления к листу и привязывая его к ячейке, можно вернуть числовое значение текущего положения элемента управления.
Использование 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 указывает, насколько увеличится текущее значение, если вы щелкнете внутри полосы прокрутки с обеих сторон ползунка.
Приведенный пример показывает, как добавить полосу прокрутки на листе.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Instantiate a new Workbook. | |
Workbook excelbook = new Workbook(); | |
// Get the first worksheet. | |
Worksheet worksheet = excelbook.Worksheets[0]; | |
// Invisible the gridlines of the worksheet. | |
worksheet.IsGridlinesVisible = false; | |
// Get the worksheet cells. | |
Cells cells = worksheet.Cells; | |
// Input a value into A1 cell. | |
cells["A1"].PutValue(1); | |
// Set the font color of the cell. | |
cells["A1"].GetStyle().Font.Color = Color.Maroon; | |
// Set the font text bold. | |
cells["A1"].GetStyle().Font.IsBold = true; | |
// Set the number format. | |
cells["A1"].GetStyle().Number = 1; | |
// Add a scrollbar control. | |
Aspose.Cells.Drawing.ScrollBar scrollbar = worksheet.Shapes.AddScrollBar(0, 0, 1, 0, 125, 20); | |
// Set the placement type of the scrollbar. | |
scrollbar.Placement = PlacementType.FreeFloating; | |
// Set the linked cell for the control. | |
scrollbar.LinkedCell = "A1"; | |
// Set the maximum value. | |
scrollbar.Max = 20; | |
// Set the minimum value. | |
scrollbar.Min = 1; | |
// Set the incr. change for the control. | |
scrollbar.IncrementalChange = 1; | |
// Set the page change attribute. | |
scrollbar.PageChange = 5; | |
// Set it 3-D shading. | |
scrollbar.Shadow = true; | |
// Save the excel file. | |
excelbook.Save(dataDir + "book1.out.xls"); |
Добавление элемента управления 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 и сгруппировать элементы управления на листе.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create directory if it is not already present. | |
bool IsExists = System.IO.Directory.Exists(dataDir); | |
if (!IsExists) | |
System.IO.Directory.CreateDirectory(dataDir); | |
// Instantiate a new Workbook. | |
Workbook excelbook = new Workbook(); | |
// Add a group box to the first worksheet. | |
Aspose.Cells.Drawing.GroupBox box = excelbook.Worksheets[0].Shapes.AddGroupBox(1, 0, 1, 0, 300, 250); | |
// Set the caption of the group box. | |
box.Text = "Age Groups"; | |
box.Placement = PlacementType.FreeFloating; | |
// Make it 2-D box. | |
box.Shadow = false; | |
// Add a radio button. | |
Aspose.Cells.Drawing.RadioButton radio1 = excelbook.Worksheets[0].Shapes.AddRadioButton(3, 0, 2, 0, 30, 110); | |
// Set its text string. | |
radio1.Text = "20-29"; | |
// Set A1 cell as a linked cell for the radio button. | |
radio1.LinkedCell = "A1"; | |
// Make the radio button 3-D. | |
radio1.Shadow = true; | |
// Set the weight of the radio button. | |
radio1.Line.Weight = 4; | |
// Set the dash style of the radio button. | |
radio1.Line.DashStyle = MsoLineDashStyle.Solid; | |
// Add another radio button. | |
Aspose.Cells.Drawing.RadioButton radio2 = excelbook.Worksheets[0].Shapes.AddRadioButton(6, 0, 2, 0, 30, 110); | |
// Set its text string. | |
radio2.Text = "30-39"; | |
// Set A1 cell as a linked cell for the radio button. | |
radio2.LinkedCell = "A1"; | |
// Make the radio button 3-D. | |
radio2.Shadow = true; | |
// Set the weight of the radio button. | |
radio2.Line.Weight = 4; | |
// Set the dash style of the radio button. | |
radio2.Line.DashStyle = MsoLineDashStyle.Solid; | |
// Add another radio button. | |
Aspose.Cells.Drawing.RadioButton radio3 = excelbook.Worksheets[0].Shapes.AddRadioButton(9, 0, 2, 0, 30, 110); | |
// Set its text string. | |
radio3.Text = "40-49"; | |
// Set A1 cell as a linked cell for the radio button. | |
radio3.LinkedCell = "A1"; | |
// Make the radio button 3-D. | |
radio3.Shadow = true; | |
// Set the weight of the radio button. | |
radio3.Line.Weight = 4; | |
// Set the dash style of the radio button. | |
radio3.Line.DashStyle = MsoLineDashStyle.Solid; | |
// Get the shapes. | |
Aspose.Cells.Drawing.Shape[] shapeobjects = new Aspose.Cells.Drawing.Shape[] { box, radio1, radio2, radio3 }; | |
// Group the shapes. | |
Aspose.Cells.Drawing.GroupShape group = excelbook.Worksheets[0].Shapes.Group(shapeobjects); | |
// Save the excel file. | |
excelbook.Save(dataDir + "book1.out.xls"); |