Форматирование ячейки

Эта тема предоставляет подробное обсуждение того, как форматировать ячейки.

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

Форматирование ячеек с использованием диалогового окна стиля.

Ячейки могут быть отформатированы программным образом, но самым простым способом форматирования ячеек в элементе управления Aspose.Cells.GridWeb в режиме WYSIWYG является использование диалогового окна стиля.

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

Выбор форматирования ячейки

Диалоговое окно стиля отображается.

Диалоговое окно стиля используется для форматирования ячеек

Диалоговое окно стиля позволяет пользователям форматировать ячейки, настраивая параметры шрифта и границы.

Настройка параметров шрифта

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

• Имя шрифта, выберите желаемый шрифт из списка.
• Стиль шрифта, примените стиль шрифта, такой как жирный, курсив и т. д.
• Размер шрифта, выберите размер шрифта в точках.
• Подчеркивание, подчеркните текст.
• Зачеркнутый, примените эффект зачеркивания к тексту.
• Горизонтальное выравнивание, выберите горизонтальное выравнивание.
• Вертикальное выравнивание, выберите вертикальное выравнивание.
• Цвет шрифта, выберите цвет шрифта.
• Фон, выберите цвет фона.

Вы можете проверить выбранные настройки шрифта в небольшой области предварительного просмотра.

Настройки пользовательского шрифта

Настройка граничных настроек

Элемент управления также позволяет пользователям рисовать границу вокруг ячеек, настраивая граничные параметры в диалоговом окне Стиль.

Чтобы просмотреть связанные с границами параметры: Щелкните Границы в диалоговом окне Стиль. Показаны параметры, связанные с границами.

Параметры границ в диалоговом окне стиля

Из диалогового окна Стиль можно выбрать следующие параметры границ:

• Стиль линии границы, выберите стиль границы, такой как сплошная, пунктир и т. д.
• Ширина линии границы, выберите ширину границы в пикселях.
• Цвет линии границы, выберите цвет линии.
• Границы, выберите нумерацию и расположение линий границ.

Настройки пользовательских границ

Применение настроек

Щелкните ОК в диалоговом окне Стиль, чтобы применить изменения.

Применены настройки шрифта и границы

Форматирование ячеек с использованием API

Ячейки также могут быть отформатированы программным путем с помощью API Aspose.Cells.GridWeb. Каждая ячейка имеет свойство Style, которое представляет объект GridTableItemStyle. Используйте свойство Style для настройки шрифта и граничных параметров.

Настройка шрифта

Чтобы настроить настройки шрифта программно:

1. Добавьте элемент управления Aspose.Cells.GridWeb на веб-форму.
2. Получите доступ к листу.
3. Получите доступ к ячейке, которую вы форматируете.
4. Получите доступ к стилю ячейки.
5. Установите размер шрифта в пунктах.
6. Установите стиль шрифта.
7. Установите цвета переднего плана и фона.
8. Установите горизонтальное и вертикальное выравнивание.
9. Верните стиль обратно в ячейку.

Вывод: настроенные настройки шрифта показаны в A1

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active and resize first row and column
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];
sheet.Cells.Clear();
sheet.Cells.SetColumnWidth(0, 50);
sheet.Cells.SetRowHeight(0, 40);

// Accessing a specific cell of the worksheet
GridCell cell = sheet.Cells["A1"];

// Inserting a value in cell A1
cell.PutValue("Aspose.Cells.GridWeb");
           
var style = cell.Style;

// Setting font, color and alignment of cell
style.Font.Size = new FontUnit("12pt");
style.Font.Bold = true;
style.ForeColor = Color.Blue;
style.BackColor = Color.Aqua;
style.HorizontalAlign = HorizontalAlign.Center;                        

// Set the cell style
cell.CopyStyle(style);
sheet.AutoFitColumn(0);

Настройка границ

Границы могут быть применены к отдельным ячейкам или к диапазону.

Одиночная ячейка

Чтобы установить границы одной ячейки:

1. Добавьте элемент управления Aspose.Cells.GridWeb на веб-форму.
2. Получите доступ к листу.
3. Получите доступ к ячейке, которую вы собираетесь отформатировать.
4. Получите доступ к объекту стиля ячейки.
5. Установите стиль границы.
6. Установите ширину границы в пикселях.
7. Установите цвет границы.
8. Установите стиль для ячейки.

Настройка настраиваемых параметров границы для одной ячейки

Возможно установить различные стили для каждой линии границы с использованием свойств Style.TopBorderStyle, Style.BottomBorderStyle, Style.LeftBorderStyle, Style.RightBorderStyle ячейки.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active and resize first row and column
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];
sheet.Cells.Clear();
sheet.Cells.SetColumnWidth(0, 50);
sheet.Cells.SetRowHeight(0, 40);

// Accessing a specific cell of the worksheet
GridCell cell = sheet.Cells["A1"];

var style = cell.Style;

// Setting the border style, width and color
style.BorderStyle = BorderStyle.Solid;
style.BorderWidth = new Unit(2, UnitType.Pixel);
style.BorderColor = Color.Blue;
            
// Set the cell style
cell.CopyStyle(style);

Диапазон ячеек

Чтобы установить границы для диапазона ячеек:

1. Добавьте элемент управления Aspose.Cells.GridWeb на свою веб-форму
2. Получите доступ к нужному листу
3. Создайте объект класса WebBorderStyle
4. Установите стиль границы: сплошной или пунктирный и т. д.
5. Установите ширину границы в пикселях
6. Установите цвет границы
7. Примените настраиваемые параметры границы, хранящиеся в объекте WebBorderStyle, к указанному диапазону ячеек

Диапазон ячеек с настраиваемыми параметрами границы

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

sheet.Cells.Clear();

// Creating an instance of WebBorderStyle
WebBorderStyle bstyle = new WebBorderStyle();

// Setting the border style, width and color
bstyle.BorderStyle = BorderStyle.Double;
bstyle.BorderWidth = new Unit(3, UnitType.Pixel);
bstyle.BorderColor = Color.Blue;

// Applying the instance of WebBorderStyle on a specified range of cells
sheet.Cells.SetBorders(1, 1, 5, 4, SetBorderPosition.Cross, bstyle);

Установка числовых форматов

Aspose.Cells.GridWeb поддерживает установку числовых форматов. Доступно 59 встроенных числовых форматов. Для их просмотра обратитесь к этому списку поддерживаемых числовых форматов.

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

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

Настройки числового формата, примененные к B1 и B2

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

sheet.Cells.Clear();
            
sheet.Cells.SetColumnWidth(0, 50);
sheet.Cells.SetRowHeight(0, 40);

// Putting values to cells
sheet.Cells["A1"].PutValue("Currency1 Number Format");
sheet.Cells["A2"].PutValue("Custom Number Format");
sheet.Cells["B1"].PutValue(7800);
sheet.Cells["B2"].PutValue(2500);

// Setting the number format of "B1" cell to Currency1
sheet.Cells["B1"].SetNumberType((int)NumberType.Currency1);
        
// Setting the custom number format of "B2" cell
sheet.Cells["B2"].SetCustom("#,##0.0000");