sds_redraw

int sds_redraw (const sds_name entity-name, int mode);


Redraw that, like this.


This function redraws the specified object(s) or the entire viewport.

The argument entity-name defines what is to be redrawn. When this argument is NULL, the entire viewport is redrawn.

The argument mode describes how the specified objects are to be redrawn, but is only useful if entity-name is not NULL.

Mode Descriptions
1 or -1 Redraw the specified object(s).
2 or -2 Disappear the specified object(s).
3 or -3 Highlight the specified object(s).
4 or -4 Redraw highlighted object(s) in normal (non-highlighted) mode.

When you are working with complex objects, such as polylines, use the positive value to update all the parts of the object; use the negative value to update only the first part.

The modes for this function have to be used in pairs, so that every time you use one mode, you have to follow that up later with the opposite mode. For example, if you use mode 2, you must later use mode 1. Likewise, if you use mode 3, you must later use mode 4.

This function returns RTNORM or an error code.

Example

sds_name entity1;

sds_point point1;

sds_entsel("\nPick another object: ",entity1,point1);

sds_redraw(NULL,4); \\ Un-highlights everything.

sds_redraw(entity1,3); \\ Highlights selected object.

Tell me about...

Programming Overview of SDS™ (Solutions Development System™)

sds_grclear