mxcad 1.0.301 → 1.0.303

package/dist/mxcad.d.ts

@@ -14,6 +14,10 @@ export declare function b64Encode(str: string): string;
  * @returns 原始数据
  */
 export declare function b64Decode(str: string): string;
+/**
+ * 把字符串转成16进制格式编辑
+ */
+export declare function crateHexString(str: string): string;
 export type FileTypes = {
 	description?: string;
 	accept: {
@@ -14132,7 +14136,7 @@ declare class MxCADMTextImp extends PubSub<{
 	textAlignment: McDb.AttachmentPoint;
 	actualHeight: number;
 	actualWidth: number;
-	met: McGeMatrix3d;
+	mat: McGeMatrix3d;
 	angle: number;
 	lineHeightRatio: number;
 	entityType: "custom" | "mtext";
@@ -14211,7 +14215,7 @@ declare function convertSlatePointToCadPoint(this: MxCADMText, point: IMxEditorP
 	point: McGePoint3d;
 	lineIndex: number;
 } | null;
-declare function transformBy(this: MxCADMText, met: McGeMatrix3d): boolean;
+declare function transformBy(this: MxCADMText, mat: McGeMatrix3d): boolean;
 declare function worldDraw(this: MxCADMText, draw: MxCADWorldDraw): void;
 /**
  * 自定义编辑器实体类
@@ -14259,6 +14263,410 @@ export declare class MxCADMText extends McDbCustomEntity {
 	convertSlatePointToCadPoint: typeof convertSlatePointToCadPoint;
 	transformBy: typeof transformBy;
 }
+/**
+ * 合并单元格信息接口
+ */
+export interface IMergeCellInfo {
+	row: number;
+	col: number;
+	rowspan: number;
+	colspan: number;
+}
+export interface ICellStyleInfo {
+	data: any[][];
+	mergeCells?: IMergeCellInfo[];
+	colWidths?: IColumnWidth[];
+	rowHeights?: IRowHeight[];
+	cellStyles?: CellStyleInfo;
+}
+export interface CellStyleInfo {
+	[key: string]: ICellStyle;
+}
+/**
+ * 行高信息接口
+ */
+export interface IRowHeight {
+	row: number;
+	height: number;
+}
+/**
+ * 列宽信息接口
+ */
+export interface IColumnWidth {
+	col: number;
+	width: number;
+}
+/**
+ * 表格样式接口
+ */
+export interface ITableStyle {
+	rowHeight: number;
+	colWidth: number;
+	textHeight: number;
+	borderColor: number;
+	textColor: number;
+	backgroundColor?: number | null;
+}
+/**
+ * 单元格样式接口
+ */
+export interface ICellStyle {
+	backgroundColor?: number | null;
+	textColor?: number | null;
+	alignment?: "left" | "center" | "right";
+	verticalAlignment?: "top" | "middle" | "bottom";
+}
+export declare class McDbXlsxTable extends McDbCustomEntity {
+	position: McGePoint3d;
+	style: ITableStyle;
+	private _colWidths;
+	private _rowHeights;
+	private _xlsxData;
+	private _mergeCells;
+	private _selectedCells;
+	private _cellTextDimensions;
+	private _cellStyles;
+	private _mat;
+	constructor(imp?: any);
+	create(imp: any): McDbXlsxTable;
+	getTypeName(): string;
+	get xlsxData(): string;
+	set xlsxData(data: string);
+	private getTableData;
+	/**
+	 * 处理合并单元格数据，填充空值
+	 * 根据合并单元格信息，将合并区域内的空单元格填充为合并区域左上角的值
+	 */
+	private processMergedCellData;
+	dwgInFields(filter: IMcDbDwgFiler): boolean;
+	dwgOutFields(filter: IMcDbDwgFiler): boolean;
+	setPosition(position: McGePoint3d): void;
+	getPosition(): McGePoint3d;
+	private calculateTableDimensions;
+	/**
+	 * 获取选中单元格的范围
+	 * @returns 包含选中范围的最小和最大行列索引
+	 */
+	private getSelectionRange;
+	/**
+	 * 设置当前选中的单元格
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 */
+	setSelectedCell(row: number, col: number): void;
+	/**
+	 * 添加一个单元格到选中集合
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 */
+	addSelectedCell(row: number, col: number): void;
+	/**
+	 * 设置多个选中的单元格
+	 * @param cells 单元格位置数组 [{row, col}, ...]
+	 */
+	setSelectedCells(cells: {
+		row: number;
+		col: number;
+	}[]): void;
+	/**
+	 * 清除当前选中的单元格
+	 */
+	clearSelectedCell(): void;
+	/**
+	 * 获取当前选中的单元格
+	 * @returns 第一个选中的单元格，如果没有选中则返回null
+	 */
+	getSelectedCell(): {
+		row: number;
+		col: number;
+	} | null;
+	/**
+	 * 获取所有选中的单元格
+	 * @returns 所有选中的单元格数组
+	 */
+	getSelectedCells(): {
+		row: number;
+		col: number;
+	}[];
+	/**
+	 * 检查指定单元格是否被选中
+	 * @param row 行索引
+	 * @param col 列索引
+	 * @returns 是否被选中
+	 */
+	isCellSelected(row: number, col: number): boolean;
+	/**
+	 * 获取选中单元格的数量
+	 * @returns 选中的单元格数量
+	 */
+	getSelectedCellCount(): number;
+	worldDraw(draw: MxCADWorldDraw): void;
+	setFromWorkbook(processedData: ICellStyleInfo): void;
+	setFromJson(jsonArray: any[]): void;
+	setFromArray(data: any[][]): void;
+	/**
+	 * 设置合并单元格信息
+	 */
+	setMergeCells(mergeCells: IMergeCellInfo[]): void;
+	/**
+	 * 获取合并单元格信息
+	 */
+	getMergeCells(): IMergeCellInfo[];
+	/**
+	 * 设置表格样式
+	 */
+	setStyle(style: Partial<ITableStyle>): void;
+	/**
+	 * 获取表格样式
+	 */
+	getStyle(): ITableStyle;
+	/**
+	 * 设置指定列的宽度
+	 * @param col 列索引 (0-based)
+	 * @param width 列宽度（单位与style.colWidth一致）
+	 */
+	setColumnWidth(col: number, width: number): void;
+	/**
+	 * 获取指定列的宽度
+	 * @param col 列索引 (0-based)
+	 * @returns 列宽度，如果未设置则返回默认列宽
+	 */
+	getColumnWidth(col: number): number;
+	/**
+	 * 获取所有列宽设置
+	 */
+	getAllColumnWidths(): IColumnWidth[];
+	/**
+	 * 重置指定列的宽度为默认值
+	 * @param col 列索引 (0-based)
+	 */
+	resetColumnWidth(col: number): void;
+	/**
+	 * 设置指定行的高度
+	 * @param row 行索引 (0-based)
+	 * @param height 行高度（单位与style.rowHeight一致）
+	 */
+	setRowHeight(row: number, height: number): void;
+	/**
+	 * 获取指定行的高度
+	 * @param row 行索引 (0-based)
+	 * @returns 行高度，如果未设置则返回默认行高
+	 */
+	getRowHeight(row: number): number;
+	/**
+	 * 获取所有行高设置
+	 */
+	getAllRowHeights(): IRowHeight[];
+	/**
+	 * 重置指定行的高度为默认值
+	 * @param row 行索引 (0-based)
+	 */
+	resetRowHeight(row: number): void;
+	/**
+	 * 获取指定单元格的值
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @returns 单元格值
+	 */
+	getCellValue(row: number, col: number): any;
+	/**
+	 * 设置指定单元格的值
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @param value 单元格值（Slate格式或普通文本）
+	 */
+	setCellValue(row: number, col: number, value: any): void;
+	/**
+	 * 获取单元格的纯文本值（如果是Slate格式则提取文本）
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @returns 单元格的纯文本值
+	 */
+	getCellTextValue(row: number, col: number): string;
+	/**
+	 * 获取指定单元格的几何范围
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @returns 单元格的几何范围 { min: McGePoint3d, max: McGePoint3d } 或 null (当单元格不存在时)
+	 */
+	getCellGeometry(row: number, col: number): {
+		min: McGePoint3d;
+		max: McGePoint3d;
+	} | null;
+	/**
+	 * 获取指定单元格的A1格式引用
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @returns A1格式的单元格引用 (例如 "A1", "B2")
+	 */
+	getCellReference(row: number, col: number): string;
+	/**
+	 * 从A1格式引用获取单元格索引
+	 * @param cellRef A1格式的单元格引用 (例如 "A1", "B2")
+	 * @returns 单元格索引 {row, col} 或 null (当引用无效时)
+	 */
+	getCellFromReference(cellRef: string): {
+		row: number;
+		col: number;
+	} | null;
+	/**
+	 * 设置表格全局背景颜色
+	 * @param color 背景颜色值
+	 * - 支持真彩色：0xRRGGBB，如 0x000000 黑色（RR是红色值，GG是绿色值，BB是蓝色值）
+	 * - 支持颜色索引：0-255
+	 * - 支持ColorMethod.kByLayer(1)表示随层
+	 * - 支持ColorMethod.kByBlock(2)表示随块
+	 * - 传入null可移除背景颜色
+	 */
+	setBackgroundColor(color: number | null): void;
+	/**
+	 * 获取表格全局背景颜色
+	 * @returns 背景颜色值，可能为null（表示无背景色）
+	 */
+	getBackgroundColor(): number | null | undefined;
+	/**
+	 * 设置单元格背景颜色
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @param color 背景颜色值
+	 * - 支持真彩色：0xRRGGBB，如 0x000000 黑色（RR是红色值，GG是绿色值，BB是蓝色值）
+	 * - 支持颜色索引：0-255
+	 * - 支持ColorMethod.kByLayer(1)表示随层
+	 * - 支持ColorMethod.kByBlock(2)表示随块
+	 * - 传入null可移除背景颜色
+	 */
+	setCellBackgroundColor(row: number, col: number, color: number | null | undefined): void;
+	/**
+	 * 获取单元格背景颜色
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @returns 单元格背景颜色，如果未设置则返回null
+	 */
+	getCellBackgroundColor(row: number, col: number): number | null | undefined;
+	/**
+	 * 通过A1引用格式设置单元格背景颜色
+	 * @param cellRef A1格式的单元格引用 (例如 "A1", "B2")
+	 * @param color 背景颜色值，null表示删除背景色
+	 * @returns 是否设置成功
+	 */
+	setCellBackgroundColorByRef(cellRef: string, color: number | null | undefined): boolean;
+	/**
+	 * 批量设置单元格背景颜色
+	 * @param cells 单元格位置数组 { row, col } 或 A1引用字符串数组
+	 * @param color 背景颜色值，null表示删除背景色
+	 */
+	setBatchCellBackgroundColor(cells: (string | {
+		row: number;
+		col: number;
+	})[], color: number | null | undefined): void;
+	/**
+	 * 设置单元格文本颜色
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @param color 文本颜色值
+	 * - 支持真彩色：0xRRGGBB，如 0x000000 黑色（RR是红色值，GG是绿色值，BB是蓝色值）
+	 * - 支持颜色索引：0-255
+	 * - 支持ColorMethod.kByLayer(1)表示随层
+	 * - 支持ColorMethod.kByBlock(2)表示随块
+	 * - 传入null可移除文本颜色
+	 */
+	setCellTextColor(row: number, col: number, color: number | null | undefined): void;
+	/**
+	 * 获取单元格文本颜色
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @returns 单元格文本颜色，如果未设置则返回null
+	 */
+	getCellTextColor(row: number, col: number): number | null | undefined;
+	/**
+	 * 通过A1引用格式设置单元格文本颜色
+	 * @param cellRef A1格式的单元格引用 (例如 "A1", "B2")
+	 * @param color 文本颜色值，null表示删除文本颜色
+	 * @returns 是否设置成功
+	 */
+	setCellTextColorByRef(cellRef: string, color: number | null | undefined): boolean;
+	/**
+	 * 批量设置单元格文本颜色
+	 * @param cells 单元格位置数组 { row, col } 或 A1引用字符串数组
+	 * @param color 文本颜色值，null表示删除文本颜色
+	 */
+	setBatchCellTextColor(cells: (string | {
+		row: number;
+		col: number;
+	})[], color: number | null | undefined): void;
+	/**
+	 * 设置单元格水平对齐方式
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @param alignment 水平对齐方式
+	 */
+	setCellAlignment(row: number, col: number, alignment: "left" | "center" | "right"): void;
+	/**
+	 * 获取单元格水平对齐方式
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @returns 水平对齐方式，如果未设置则返回'left'
+	 */
+	getCellAlignment(row: number, col: number): "left" | "center" | "right" | undefined;
+	/**
+	 * 通过A1引用格式设置单元格水平对齐方式
+	 * @param cellRef A1格式的单元格引用 (例如 "A1", "B2")
+	 * @param alignment 水平对齐方式
+	 * @returns 是否设置成功
+	 */
+	setCellAlignmentByRef(cellRef: string, alignment: "left" | "center" | "right"): boolean;
+	/**
+	 * 批量设置单元格水平对齐方式
+	 * @param cells 单元格位置数组 { row, col } 或 A1引用字符串数组
+	 * @param alignment 水平对齐方式
+	 */
+	setBatchCellAlignment(cells: (string | {
+		row: number;
+		col: number;
+	})[], alignment: "left" | "center" | "right"): void;
+	/**
+	 * 设置单元格垂直对齐方式
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @param verticalAlignment 垂直对齐方式
+	 */
+	setCellVerticalAlignment(row: number, col: number, verticalAlignment: "top" | "middle" | "bottom"): void;
+	/**
+	 * 获取单元格垂直对齐方式
+	 * @param row 行索引 (0-based)
+	 * @param col 列索引 (0-based)
+	 * @returns 垂直对齐方式，如果未设置则返回'top'
+	 */
+	getCellVerticalAlignment(row: number, col: number): "top" | "middle" | "bottom" | undefined;
+	/**
+	 * 通过A1引用格式设置单元格垂直对齐方式
+	 * @param cellRef A1格式的单元格引用 (例如 "A1", "B2")
+	 * @param verticalAlignment 垂直对齐方式
+	 * @returns 是否设置成功
+	 */
+	setCellVerticalAlignmentByRef(cellRef: string, verticalAlignment: "top" | "middle" | "bottom"): boolean;
+	/**
+	 * 批量设置单元格垂直对齐方式
+	 * @param cells 单元格位置数组 { row, col } 或 A1引用字符串数组
+	 * @param verticalAlignment 垂直对齐方式
+	 */
+	setBatchCellVerticalAlignment(cells: (string | {
+		row: number;
+		col: number;
+	})[], verticalAlignment: "top" | "middle" | "bottom"): void;
+	/**
+	 * 将CAD坐标点转换为表格中的单元格位置
+	 * @param point CAD空间中的三维点
+	 * @returns 单元格位置 {row, col} 或 null (当点不在表格内时)
+	 */
+	getCellAtPoint(point: McGePoint3d): {
+		row: number;
+		col: number;
+	} | null;
+	getGripPoints(): McGePoint3dArray;
+	moveGripPointsAt(iIndex: number, dXOffset: number, dYOffset: number, dZOffset: number): void;
+	transformBy(_mat: McGeMatrix3d): boolean;
+}
 export declare let MxCpp: MxCppType;
 /**
  * 异步加载 MxCAD assembly，并在加载完成后执行回调函数