ITextDocument::Freeze method (tom.h)

Increments the freeze count.

Syntax

HRESULT Freeze(
  long *pCount
);

Parameters

pCount

Type: long*

The updated freeze count.

Return value

Type: HRESULT

If the ITextDocument::Freeze count is nonzero, it returns S_OK. If the ITextDocument::Freeze count is zero, it returns FALSE.

Remarks

If the freeze count is nonzero, screen updating is disabled. This allows a sequence of editing operations to be performed without the performance loss and flicker of screen updating. To decrement the freeze count, call the ITextDocument::Unfreeze method.

Requirements

See also

BeginEditCollection

Conceptual

ITextDocument

Reference

Text Object Model

Unfreeze