CNumPagesField Class Reference

#include <fldbltin.h>

Link against: field.lib

class CNumPagesField : public CPageFieldBase, public CPageFieldBase

Detailed Description

A field which evaluates to the number of pages in the document.

Before the number of pages field can be evaluated, it must be passed a pointer to an object which implements the UpdateFieldNumPages() function.

Member Attribute Documentation

iNumPagesInfo

MFieldNumPagesInfo *iNumPagesInfo[protected]

Member Function Documentation

SetNumPagesInfo ( MFieldNumPagesInfo * )

voidSetNumPagesInfo(MFieldNumPagesInfo *aInfo)[inline]

Sets the object which implements UpdateFieldNumPages(), to get the number of pages in the document. SetNumPagesInfo() must be called before the number of pages field can be evaluated.

Parameters
aInfoPointer to an object which implements UpdateFieldNumPages().

Type ( )

IMPORT_C TUidType()const [virtual]

Reimplemented from CTextField::Type()const

Gets the field's type UID.

Return Value
KNumPagesFieldUid.

Value ( TPtr & )

IMPORT_C TIntValue(TPtr &aValueText)[virtual]

Reimplemented from CTextField::Value(TPtr &)

Gets the total number of pages in the document, by calling UpdateFieldNumPages() (implemented by the object passed to the field using SetNumPagesInfo()).

Notes

SetNumPagesInfo() must have been called beforehand, or a panic occurs.

The text object should support pagination and pagination should have occurred before evaluating the field.

Parameters
aValueTextDescriptor which on return contains the number of pages in the document, converted into the appropriate style, as set by CPageFieldBase::SetNumberStyle().
Return Value
Zero if aValueText is long enough to hold the string. Otherwise, the length of the buffer which is required to hold the string.