Class CellStyle

java.lang.Object
io.leandev.appfuse.workbook.CellStyle
public class CellStyle extends Object

儲存格樣式

封裝底層 POI 的 XSSFCellStyle 與字型，提供框架無關的樣式設定 API： 字型顏色、背景色、四邊框線（顏色與樣式）、對齊、字型、資料格式、自動換行。 顏色以 JDK 的 Color 表示，不讓 POI 型別洩漏到公開 API。

重用建議 Excel 對單一活頁簿的樣式數量有上限（約 64,000）。大量套用相同外觀時， 應以 Workbook.createCellStyle() 建立一個共用樣式，再透過 Cell.setStyle(CellStyle) 套用到多個儲存格，避免逐格產生新樣式而觸頂。

Since:
4.0.0

  • Method Details

    • setColor

      public CellStyle setColor(Color color)
      設定字型顏色
      Parameters:
      color - 顏色
      Returns:
      此樣式（支援鏈式呼叫）

    • setBackground

      public CellStyle setBackground(Color color)
      設定背景填滿顏色（實心填滿）
      Parameters:
      color - 顏色
      Returns:
      此樣式（支援鏈式呼叫）

    • setDataFormat

      public CellStyle setDataFormat(String dataFormat)
      設定資料格式（Excel 格式字串，例如 yyyy-mm-dd、#,##0.00）
      Parameters:
      dataFormat - Excel 格式字串
      Returns:
      此樣式（支援鏈式呼叫）

    • dataFormat

      public String dataFormat()
      取得目前的資料格式字串
      Returns:
      格式字串，若為一般格式（General）則回傳 null

    • setAlign

      public CellStyle setAlign(Align align)
      設定水平對齊
      Parameters:
      align - 對齊方式
      Returns:
      此樣式（支援鏈式呼叫）

    • setVerticalAlignment

      public CellStyle setVerticalAlignment(VerticalAlignment verticalAlignment)
      設定垂直對齊
      Parameters:
      verticalAlignment - 垂直對齊方式
      Returns:
      此樣式（支援鏈式呼叫）

    • setBorderColor

      public CellStyle setBorderColor(Color color)
      設定四邊框線顏色
      Parameters:
      color - 顏色
      Returns:
      此樣式（支援鏈式呼叫）

    • setBorderStyle

      public CellStyle setBorderStyle(BorderStyle borderStyle)
      設定四邊框線樣式
      Parameters:
      borderStyle - 框線樣式
      Returns:
      此樣式（支援鏈式呼叫）

    • setFontFamily

      public CellStyle setFontFamily(String name)
      設定字型名稱
      Parameters:
      name - 字型名稱（如 Calibri、Microsoft JhengHei）
      Returns:
      此樣式（支援鏈式呼叫）

    • getFontFamily

      public String getFontFamily()
      取得字型名稱
      Returns:
      字型名稱

    • setFontSize

      public CellStyle setFontSize(short points)
      設定字級（點數，point）
      Parameters:
      points - 字級點數
      Returns:
      此樣式（支援鏈式呼叫）

    • getFontSize

      public short getFontSize()
      取得字級（點數，point）
      Returns:
      字級點數

    • setBold

      public CellStyle setBold(boolean bold)
      設定是否粗體
      Parameters:
      bold - 是否粗體
      Returns:
      此樣式（支援鏈式呼叫）

    • setItalic

      public CellStyle setItalic(boolean italic)
      設定是否斜體
      Parameters:
      italic - 是否斜體
      Returns:
      此樣式（支援鏈式呼叫）

    • setWrapText

      public CellStyle setWrapText(boolean wrapText)
      設定是否自動換行
      Parameters:
      wrapText - 是否自動換行
      Returns:
      此樣式（支援鏈式呼叫）