IFileDocument.FillS Method

< PreviousTopNext >

Automation:

void FillS ( [in] ISequence pSequence, [in] ulong off, [in] ulong Size) ;

Native (C++):

HRESULT FillS ( [in] ISequence * pSequence, [in] unsigned __int64 off, [in] unsigned __int64 Size) ;

Parameters

pSequenceSequence containing data to fill.offRange starting offsetSizeRange size

Return Value

S_OK or standard OLE error code.

Remarks

Fills a given range with a given pattern. A pattern is repeated until the required number of bytes is written to the file. If file is shorter than the filling range, the file's size is increased. Complexity: constant-time.

This method is a replacement for IFileDocument.Fill when used in scripting languages.

Examples

Filling a range with a simple pattern

JavascriptCopy Code

// fdoc is initialized elsewhere
var pattern = fdoc.CreateSequence();
pattern.AddText("Simple Pattern", false);
fdoc.FillS(pattern, 0x10000, 0x10ff);

< PreviousTopNext >