Set

通过索引设置数组值。

备注

此方法不适用于 JS。

语法

Python

def Set(self, key: int, value: CDocBuilderValue) -> None

C++

void Set(const int& nIndex, CDocBuilderValue sValue);

COM

HRESULT Set([in] long index, [in] I_DOCBUILDER_VALUE** value);

Java

void set(int index, Object value);
void set(String index, Object value);

.Net

void Set(int nIndex, CDocBuilderValue^ sValue);

参数

Python

名称	类型	描述
key	int	数组值的索引。
value	CDocBuilderValue	要设置的数组值。

C++

名称	类型	描述
nIndex	const int&	数组值的索引。
sValue	CDocBuilderValue	要设置的值。

COM

名称	类型	描述
index	long	数组值的索引。
value	I_DOCBUILDER_VALUE**	要设置的数组值。

Java

名称	类型	描述
index	int | String	数组值的索引或名称。
value	Object	要设置的数组值。

.Net

名称	类型	描述
nIndex	int	数组值的索引。
sValue	CDocBuilderValue^	要设置的数组值。

示例

Python

builder = docbuilder.CDocBuilder()
context = builder.GetContext()
globalObj = context.GetGlobal()
api = globalObj["Api"]
document = api.GetDocument()
charts = document.GetAllCharts()
chart = api.CreateChart("bar3D", [[200, 240, 280], [250, 260, 280]],
                        ["Projected Revenue", "Estimated Costs"], [2014, 2015, 2016],
                        4051300, 2347595, 24)
charts.Set(1, chart)

C++

std::wstring sWorkDirectory = NSUtils::GetBuilderDirectory();
CDocBuilder::Initialize(sWorkDirectory.c_str());
CDocBuilder oBuilder;
CContext oContext = oBuilder.GetContext();
CValue oGlobal = oContext.GetGlobal();
CValue oApi = oGlobal["Api"];
CValue oDocument = oApi.Call("GetDocument");
CValue aCharts = oDocument.Call("GetAllCharts");
CValue oChart = oApi.Call("CreateChart", "bar3D", ...);
aCharts.Set(1, oChart);
CDocBuilder::Dispose();

COM

CoInitialize(NULL);
IONLYOFFICEDocBuilder* oBuilder = NULL;
CoCreateInstance(__uuidof(CONLYOFFICEDocBuilder), NULL, CLSCTX_INPROC_SERVER, __uuidof(IONLYOFFICEDocBuilder), (void**)&oBuilder);
IONLYOFFICEDocBuilderContext* oContext = NULL;
IONLYOFFICEDocBuilderValue* oGlobal = NULL;
IONLYOFFICEDocBuilderValue* oApi = NULL;
IONLYOFFICEDocBuilderValue* oDocument = NULL;
IONLYOFFICEDocBuilderValue* aParagraphs = NULL;
IONLYOFFICEDocBuilderValue* oParagraph = NULL;
oBuilder->Initialize();
oBuilder->GetContext(&oContext);
oContext->GetGlobal(&oGlobal);
oGlobal->GetProperty(_bstr_t("Api"), &oApi);
oApi->Call(_bstr_t("GetDocument"), ATL::CComVariant(), ATL::CComVariant(), ATL::CComVariant(), ATL::CComVariant(), ATL::CComVariant(), ATL::CComVariant(), &oDocument);
oDocument->Call(_bstr_t("GetAllParagraphs"), ATL::CComVariant(), ATL::CComVariant(), ATL::CComVariant(), ATL::CComVariant(), ATL::CComVariant(), ATL::CComVariant(), &aParagraphs);
oApi->Call(_bstr_t("CreateParagraph"), ATL::CComVariant(), ATL::CComVariant(), ATL::CComVariant(), ATL::CComVariant(), ATL::CComVariant(), ATL::CComVariant(), &oParagraph);
aParagraphs->Set(1, oParagraph);
oBuilder->Dispose();

Java

CDocBuilder.initialize("");
CDocBuilder builder = new CDocBuilder();
CDocBuilderContext context = builder.getContext();
CDocBuilderValue global = context.getGlobal();
CDocBuilderValue api = global.get("Api");
CDocBuilderValue doc = api.call("GetDocument");
CDocBuilderValue charts = doc.call("GetAllCharts");
CDocBuilderValue chart = api.call("CreateChart", "bar3D", ...);
charts.set(1, chart);
CDocBuilder.dispose();

.Net

string workDirectory = "C:/Program Files/ONLYOFFICE/documentBuilder";
CDocBuilder.Initialize(workDirectory);
CDocBuilder oBuilder = new CDocBuilder();
CContext oContext = oBuilder.GetContext();
CValue oGlobal = oContext.GetGlobal();
CValue oApi = oGlobal["Api"];
CValue oDocument = oApi.Call("GetDocument");
CValue aCharts = oDocument.Call("GetAllCharts");
CValue oChart = oApi.Call("CreateChart", "bar3D", ...);
aCharts.Set(1, oChart);
CDocBuilder.Destroy();

索引运算符

operator[] 后缀表达式也可用于通过索引设置数组值：

Python

array[index] = value

C++

array[index] = value;

COM

此运算符不可用。请改用 Set 方法。

Java

array[index] = value

.Net

property CDocBuilderValue^ default[int]