CreateArray

创建数组值，相当于 JS 中的 new Array (length)。

备注

对于 .docbuilder 文件，不使用 CDocBuilderContext.CreateArray 方法。

语法

Python

def CreateArray(self, length: int) -> CDocBuilderValue

C++

CDocBuilderValue CreateArray(const int& nLength);

COM

HRESULT CreateArray([in] long length, [out, retval] I_DOCBUILDER_VALUE** result);

Java

CDocBuilderValue createArray(int length);

.Net

CDocBuilderValue^ CreateArray(int nLength);

参数

Python

名称	类型	描述
length	int	数组长度。

C++

名称	类型	描述
nLength	const int&	数组长度。

COM

名称	类型	描述
length	long	数组长度。
result	I_DOCBUILDER_VALUE**	返回的数组。

Java

名称	类型	描述
length	int	数组长度。

.Net

名称	类型	描述
nLength	int	数组长度。

示例

Python

import os
import docbuilder

builder = docbuilder.CDocBuilder()
builder.CreateFile("docx")

context = builder.GetContext()
globalObj = context.GetGlobal()
api = globalObj["Api"]

document = api.GetDocument()
paragraph = api.CreateParagraph()
paragraph.AddText("Hello, World!")
content = context.CreateArray(1)
content[0] = paragraph
document.InsertContent(content)

dstPath = os.getcwd() + "/result.docx"
builder.SaveFile("docx", dstPath)
builder.CloseFile()

C++

std::wstring sWorkDirectory = NSUtils::GetBuilderDirectory();
CDocBuilder::Initialize(sWorkDirectory.c_str());
CDocBuilder oBuilder;
CContext oContext = oBuilder.GetContext();
CValue oArray = oContext.CreateArray(2);
CDocBuilder::Dispose();

COM

CoInitialize(NULL);
IONLYOFFICEDocBuilder* oBuilder = NULL;
IONLYOFFICEDocBuilderContext* oContext = NULL;
IONLYOFFICEDocBuilderValue* oContent = NULL;
oBuilder->Initialize();
oBuilder->GetContext(&oContext);
oContext->CreateArray(1, &oContent);
oBuilder->Dispose();

Java

CDocBuilder.initialize("");
CDocBuilder builder = new CDocBuilder();
CDocBuilderContext context = builder.getContext();
CDocBuilderValue arrayValue = context.createArray(2);
CDocBuilder.dispose();

.Net

string workDirectory = "C:/Program Files/ONLYOFFICE/documentBuilder";
CDocBuilder.Initialize(workDirectory);
CDocBuilder oBuilder = new CDocBuilder();
CContext oContext = oBuilder.GetContext();
CValue oArray = oContext.CreateArray(2);
CDocBuilder.Destroy();