IFileDocument.FillMultiS Method

Automation:

void FillMultiS ( [in] ISequence pSequence, [in] IMultiSelection pSel, [in] bool bCont) ;

Native (C++):

HRESULT FillMultiS ( [in] ISequence * pSequence, [in] IMultiSelection * pSel, [in] BOOL bCont) ;

Parameters

pSequenceSequence object containing the data to fill.pSelThe multiple selection object, which contains the ranges to fill in the document.bCont True to continue filling in a new range and False to start from the beginning of the pattern. See the description of the "Transparent fill" flag in the Fill user-interface command for more information.

Return Value

S_OK or standard OLE error code.

Remarks

Fills a given multiple selection with a specified pattern. The pattern is repeated until all given range(s) are filled. bCont parameter specifies whether to continue filling a new range from the previous range, or from the beggining of the pattern. Complexity: linear-time, depending on the selection's complexity.

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

Examples

Filling a range with a single byte

JavascriptCopy Code

// fdoc is initialized elsewhere
var msel = fdoc.CreateEmptySelection();
msel.AddRange(100, 20);
msel.AddRange(200, 30);
var pattern = fdoc.CreateSequence();
pattern.AddData(HexBytes, 0x31, 0x32, 0x33);
fdoc.FillMultiS(pattern, msel, false);

< PreviousTopNext >