R -> xlsx包(1)

作者: 煮豆燃逗比 | 来源:发表于2019-04-04 01:18 被阅读0次

以下内容是对xlsx包的说明文档的整理:xlsx包说明文档

该包通过操作以下七种对象来对excel进行操作

  • workbook:excel文件
  • sheet:excel文件中的表格
  • row:表格中的行
  • cell:行中的单元格
  • cellstyle:单元格格式
  • cellcomment:单元格批注
  • cellblock:单元格块,即m行n列的一堆单元格

Workbook

workbook就是一个excel文件,关于workbook有以下三个函数。

createWorkbook(type = "xlsx")   ## 创建workbook
loadWorkbook(file, password = NULL)  ## 从file中加载workbook
saveWorkbook(wb, file, password = NULL)  ## 保存workbook到file

说明:

  • file:文件路径
  • wb:workbook

Sheet

sheet就是一个表格,关于sheet有以下三个函数。

createSheet(wb, sheetName = "Sheet1")  ## 在wb中创建sheet
removeSheet(wb, sheetName = "Sheet2")  ## 删除wb中的sheet
getSheets(wb)  ## 获取wb中的sheet(s)

Row

关于row我理解为,sheet就是由n个row组成的,就如同workbook是由n个sheet组成一样,关于row有以下四个函数。

createRow(sheet, rowIndex = 1:5)  ## 在sheet中创建row
getRows(sheet, rowIndex = NULL)  ## 获取sheet中的row
removeRow(sheet, rows = NULL)  ## 删除row
setRowHeight(rows, inPoints, multiplier)  ## 设定行高

说明:

  • rowIndex:行号,为NULL时表示所有行
  • inPoints:行高
  • multiplier:默认行高(我的电脑上是15)的倍数,优先级大于inPoints
  • 这里的removeRow仅仅将行上的数据变成空白,并没有删除整行

Cell

row是由n个cell组成的,关于cell有以下四个函数。

createCell(row, colIndex = 1:5)  ## 在row中创建cell
getCells(row, colIndex = NULL, simplify = TRUE)  ## 获取row中的cell
setCellValue(cell, value, richTextString = FALSE, showNA = TRUE)  ##给cell赋值
getCellValue(cell, keepFormulas = FALSE, encoding = "unknown") ##  获取cell的值

说明:

  • colIndex:列号,为NULL时表示所有列
  • simplify:若为FALSE则返回一个含有列表的列表
  • richTextString:是否作为多信息文本插入
  • setCellValue和getCellValue两个函数都没有向量化,所以对多个cell使用时需要使用mapply函数和lapply函数

CellStyle

cellstyle是单元格的格式,主要有下面三个函数。

CellStyle(wb, dataFormat = NULL, alignment = NULL, border = NULL,
          fill = NULL, font = NULL, cellProtection = NULL)  ## 设定格式
setCellStyle(cell, cellStyle)  ## 将格式应用到单元格
getCellStyle(cell)  ## 获取单元格的格式

cellstyle的参数可以通过+来连接,如下

CellStyle(wb) + 
  DataFormat() + 
  Alignment() + 
  Border() + 
  Fill() + 
  Font() + 
  CellProtection()

这里的格式有六种:

  1. dataformat:数字
  2. alignment:对齐
  3. border:边框
  4. fill:填充
  5. font:字体
  6. cellprotection:保护
dataformat
DataFormat(x)

说明

  • x:表示数据格式的字符
  • 通过使用excel录制宏然后查看VBA代码的方式可以找到想要的x的代码
alignment
Alignment(horizontal = NULL, vertical = NULL, wrapText = FALSE, 
          rotation = 0, indent = 0)

说明:

  • horizontal:水平对齐(星号为常用)
    "ALIGN_CENTER" 居中 ✳
    "ALIGN_CENTER_SELECTION" 跨列居中
    "ALIGN_FILL" 填充
    "ALIGN_GENERAL" 常规
    "ALIGN_JUSTIFY" 两端对齐
    "ALIGN_LEFT" 靠左(缩进)✳
    "ALIGN_RIGHT" 靠右(缩进)✳
  • vertical:垂直对齐(星号为常用)
    "VERTICAL_BOTTOM" 靠下
    "VERTICAL_CENTER" 居中 ✳
    "VERTICAL_JUSTIFY" 两端对齐
    "VERTICAL_TOP" 靠上
  • wrapText:自动换行,T or F
  • rotation:字体旋转角度
  • indent:缩进距离
border
Border(color = "black", position = "BOTTOM", pen = "BORDER_THIN")

说明:

  • color:线条颜色
  • position:线条位置 "BOTTOM" "LEFT" "TOP" "RIGHT"
  • pen:线条类型,有十四种,根本记不住,常用的应该就下面两个:
    "BORDER_THIN" 普通的线
    "BORDER_THICK" 加粗的线
fill
Fill(foregroundColor = "lightblue", backgroundColor = "lightblue",
     pattern = "SOLID_FOREGROUND")

说明:(不太明白具体区别感觉没多大用)

  • foregroundColor:前景颜色
  • backgroundColor:背景颜色
  • pattern:填充模式
font
Font(color = NULL, heightInPoints = NULL, name = NULL, isItalic = FALSE,
     isStrikeout = FALSE, isBold = FALSE, underline = NULL, boldweight = NULL)

说明:

  • color:字体颜色
  • heightInPoints:字体大小
  • name:字体类型,code可以在excel中直接看到
  • isItalic:斜体,T or F
  • isStrikeout:删除线,T or F
  • isBold:加粗,T or F
  • underline:下划线粗度,数值0,1,2
  • boldweight:加粗要加多粗,正常字体是400,正常加粗字体是700
cellprotection
CellProtection(locked = TRUE, hidden = FALSE)

说明:

  • locked:单元格锁定,T or F
  • hidden:单元格隐藏,T or F

CellComment

cellcomment是单元格的批注,有以下三个函数。

createCellComment(cell, string = "", author = NULL, visible = TRUE)  ## 创建批注
getCellComment(cell)  ## 获取cell的批注
removeCellComment(cell)  ## 删除cell的批注

说明:

  • string:批注内容
  • author:批注作者
  • visible:可见,T or F

CellBlock

cellblock是sheet的一部分,通过以下函数获取。

CellBlock(sheet, startRow, startColumn, noRows, noColumns, create = TRUE)

说明:

  • startRow:起始行
  • startColumn:起始列
  • noRows:行数
  • noColumns:列数
  • create:当sheet中不存在cell的时候,创建新单元格,T or F

以下是对cellblock进行操作的六个函数。

CB.setColData(cellBlock, x, colIndex, rowOffset = 0, showNA = TRUE, 
              colStyle = NULL)  ## 给列填充数据
CB.setRowData(cellBlock, x, rowIndex, colOffset = 0, showNA = TRUE,   
              rowStyle = NULL)  ## 给行填充数据
CB.setMatrixData(cellBlock, x, startRow, startColumn, showNA = TRUE, 
                 cellStyle = NULL)  ## 给行列填充数据
CB.setFill(cellBlock, fill, rowIndex, colIndex)  ## 填充色
CB.setFont(cellBlock, font, rowIndex, colIndex)  ## 字体格式
CB.setBorder(cellBlock, border, rowIndex, colIndex)  ## 网格线

说明:

  • rowOffset:起始行
  • colOffset:起始列
  • rowStyle:行格式
  • colStyle:列格式

相关文章

网友评论

    本文标题:R -> xlsx包(1)

    本文链接:https://www.haomeiwen.com/subject/aqgabqtx.html