GetProperty
返回 CDocBuilderValue 对象的属性。
备注
此方法不适用于 JS。
语法
- Python
- C++
- COM
- Java
- .Net
def GetProperty(self, name: str) -> CDocBuilderValue
CDocBuilderValue GetProperty(const wchar_t* sName);
HRESULT GetProperty([in] BSTR name, [out, retval] I_DOCBUILDER_VALUE** result);
CDocBuilderValue getProperty(String name);
CDocBuilderValue^ GetProperty(String^ sName);
参数
- Python
- C++
- COM
- Java
- .Net
| 名称 | 类型 | 描述 |
|---|---|---|
| name | str | CDocBuilderValue 对象属性的名称。 |
| 名称 | 类型 | 描述 |
|---|---|---|
| sName | const wchar_t* | CDocBuilderValue 对象属性的名称。 |
| 名称 | 类型 | 描述 |
|---|---|---|
| name | BSTR | CDocBuilderValue 对象属性的名称。 |
| result | I_DOCBUILDER_VALUE** | 返回的对象属性。 |
| 名称 | 类型 | 描述 |
|---|---|---|
| name | String | CDocBuilderValue 对象属性的名称。 |
| 名称 | 类型 | 描述 |
|---|---|---|
| sName | String^ | CDocBuilderValue 对象属性的名称。 |
示例
- Python
- C++
- COM
- Java
- .Net
builder = docbuilder.CDocBuilder()
context = builder.GetContext()
globalObj = context.GetGlobal()
api = globalObj["Api"]
document = api.GetDocument()
docPr = document.GetProperty("color")
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 oDocPr = oDocument.GetProperty("color");
CDocBuilder::Dispose();
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;
oBuilder->Initialize();
oBuilder->GetContext(&oContext);
oContext->GetGlobal(&oGlobal);
oGlobal->GetProperty(_bstr_t("Api"), &oApi);
oBuilder->Dispose();
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 docPr = doc.getProperty("color");
CDocBuilder.dispose();
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 oDocPr = oDocument.GetProperty("color");
CDocBuilder.Destroy();
获取属性的替代方法
还有两种方法可以获取 CDocBuilderValue 对象的属性：
1. 使用 Get 方法
- Python
- C++
- COM
- Java
- .Net
def Get(self, name: str) -> CDocBuilderValue
CDocBuilderValue Get(const char* name);
CDocBuilderValue Get(const wchar_t* name);
此方法不可用。请改用 GetProperty 方法。
CDocBuilderValue get(String name);
CDocBuilderValue^ Get(String^ name);
示例
- Python
- C++
- COM
- Java
- .Net
builder = docbuilder.CDocBuilder()
context = builder.GetContext()
globalObj = context.GetGlobal()
api = globalObj["Api"]
document = api.GetDocument()
docPr = document.Get("color")
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 oDocPr = oDocument.Get("color");
CDocBuilder::Dispose();
此方法不可用。请改用 GetProperty 方法。
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 docPr = doc.get("color");
CDocBuilder.dispose();
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 oDocPr = oDocument.Get("color");
CDocBuilder.Destroy();
2. 使用索引运算符
- Python
- C++
- COM
- Java
- .Net
value["property_name"]
CDocBuilderValue operator[](const char* name);
CDocBuilderValue operator[](const wchar_t* name);
此运算符不可用。请改用 GetProperty 方法。
value["property_name"]
property CDocBuilderValue^ default[String^]
示例
- Python
- C++
- COM
- Java
- .Net
builder = docbuilder.CDocBuilder()
context = builder.GetContext()
globalObj = context.GetGlobal()
api = globalObj["Api"]
document = api.GetDocument()
docPr = document["color"]
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 oDocPr = oDocument["color"];
CDocBuilder::Dispose();
此运算符不可用。请改用 GetProperty 方法。
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 docPr = doc["color"];
CDocBuilder.dispose();
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 oDocPr = oDocument["color"];
CDocBuilder.Destroy();