Programming Interface of a Range Context Node

Use

To work with the range context node, interface IF_WD_CONTEXT_NODE_RANGE is provided, which offers some additional methods to interface IF_WD_CONTEXT_NODE for standard context nodes. These are briefly described in the following section.

IF_WD_CONTEXT_NODE_RANGE~SET_TABLE_RANGE

This method enables a section of the whole data set that the context node manages to be passed to the node.

Name	Typing	Description
NEW_ITEMS	TYPE ANY TABLE	Segment of the internal table that is to be bound to the context node.
INDEX	TYPE I	Position in the context node where the table segment is to be inserted.
INVALIDATE_CHILD_NODES	TYPE ABAP_BOOL	This optional parameter specifies whether existing context elements and their child nodes are to be invalidated. The standard value of the parameter is ABAP_FALSE, which means existing context elements remain valid and only their data is overwritten.

IF_WD_CONTEXT_NODE_RANGE~GET_ELEMENTS

This method returns the context elements from the specified area. If the requested data has not yet been passed to the context, the range supply method is called provided there is one.

Name	Typing	Description
FROM	TYPE I	This parameter indicates the start of the area for which the context elements have been requested.
TO	TYPE I	This parameter indicates the end of the area for which the context elements have been requested.

Name	Typing	Description
SET	TYPE IF_WD_CONTEXT_NODE_RANGE~TY_T_ELEMENTS	List of context elements and their indexes.

IF_WD_CONTEXT_NODE_RANGE~SET_MAX_ELEMENT_COUNT

This method has to be called to set the maximum size of the context node.

Caution

If the maximum size of the context node is not set, a short dump will occur when the data is bound to the context node.

Name	Typing	Description
MAX_ELEMENT_COUNT	TYPE I	Maximum size of the context node.

IF_WD_CONTEXT_NODE_RANGE~GET_MAX_ELEMENT_COUNT

This method returns the maximum size of the context node.

Name	Typing	Description
MAX_ELEMENT_COUNT	TYPE I	Maximum size of the context node.

IF_WD_CONTEXT_NODE_RANGE~SET_SELECTION

This method enables you to set the selection of the context node without context nodes having to be created. This can lead to a memory saving if all rows of a table are selected.

Name	Typing	Description
SELECTION	TYPE IF_WD_CONTEXT_NODE_RANGE~TY_T_SELECTION	Specifies which area of the context node is to be selected.
SELECT_ALL	TYPE ABAP_BOOL	Specifies whether the whole content of the context node is to be selected.

IF_WD_CONTEXT_NODE_RANGE~GET_SELECTION

This method returns the selected area of the context node.

Name	Typing	Description
SELECTION	TYPE IF_WD_CONTEXT_NODE_RANGE~TY_T_SELECTION	Selected area of the context node.

IF_WD_CONTEXT_NODE_RANGE~SET_MIN_ELEMENT_COUNT

This method sets the minimum size of the context node, which means the minimum number of elements requested for an empty context node when the range supply method is first called. The standard value for this minimum size is five elements.

Name	Typing	Description
MIN_ELEMENT_COUNT	TYPE I	This parameter sets the minimum size of the context node.

IF_WD_CONTEXT_NODE_RANGE~GET_MIN_ELEMENT_COUNT

This method returns the minimum size of the context node.

Name	Typing	Description
MIN_ELEMENT_COUNT	TYPE I	This parameter sets the minimum size of the context node.

IF_WD_CONTEXT_NODE_RANGE~INVALIDATE_RANGE

This method enables an area of the context node to be invalidated, that is, the context elements in a specified area of the context node can be removed.

Name	Typing	Description
FROM	TYPE I	This parameter indicates the start of the area from which the context elements are to be removed from the context node.
TO	TYPE I	This parameter indicates the end of the area up to which context elements are to be removed from the context node.

IF_WD_CONTEXT_NODE_RANGE~BIND_TABLE_RANGE

This method is similar to SET_TABLE_RANGE, however here the rows are inserted, which means the total number of rows is also increased.

Note

You should call SET_TABLE_RANGE in the supply method, and not call BIND_TABLE_RANGE.

More Information

Range Context Nodes