save method

save(stream)

Saves the data of the embedded object into the specified stream.

save(stream: Buffer)
ParameterTypeDescription
streamBufferWhere to save the object data.

Remarks

It is the responsibility of the caller to dispose the stream.

Exceptions

exceptioncondition
RuntimeError (Proxy error(InvalidOperationException))Throws if you attempt to save a linked object.

save(fileName)

Saves the data of the embedded object into a file with the specified name.

save(fileName: string)
ParameterTypeDescription
fileNamestringName of the file to save the OLE object data.

Exceptions

exceptioncondition
RuntimeError (Proxy error(InvalidOperationException))Throws if you attempt to save a linked object.

Examples

Shows how to extract embedded OLE objects into files.

let doc = new aw.Document(base.myDir + "OLE spreadsheet.docm");
let shape = doc.getShape(0, true);

// The OLE object in the first shape is a Microsoft Excel spreadsheet.
let oleFormat = shape.oleFormat;

expect(oleFormat.progId).toEqual("Excel.Sheet.12");

// Our object is neither auto updating nor locked from updates.
expect(oleFormat.autoUpdate).toEqual(false);
expect(oleFormat.isLocked).toEqual(false);

// If we plan on saving the OLE object to a file in the local file system,
// we can use the "SuggestedExtension" property to determine which file extension to apply to the file.
expect(oleFormat.suggestedExtension).toEqual(".xlsx");

// Below are two ways of saving an OLE object to a file in the local file system.
// 1 -  Save it via a stream:
let writeStream = fs.createWriteStream(base.artifactsDir + "OLE spreadsheet extracted via stream" + oleFormat.suggestedExtension);
oleFormat.save(writeStream);
await finished(writeStream);

// 2 -  Save it directly to a filename:
oleFormat.save(base.artifactsDir + "OLE spreadsheet saved directly" + oleFormat.suggestedExtension);

See Also

OleFormat.getRawData method