Programming Interface of a Range Context Node

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.

Exporting Parameter
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.

Exporting Parameter
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.

Returning parameter
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 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.

End of the caution.

Exporting Parameter
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.

Returning parameter
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.

Exporting Parameter
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.

Returning parameter
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.

Exporting Parameter
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.

Returning parameter
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.

Exporting Parameter
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 Note

End of the note.

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

More Information

Range Context Nodes