L_VecSetObjectViewContext

#include "lvkrn.h"

L_LVKRN_API L_INT L_VecSetObjectViewContext(pVector, pObject, pMin, pMax)

pVECTORHANDLE pVector;	/* pointer to the vector handle */
pVECTOROBJECT pObject;	/* pointer to a structure */
const pVECTORPOINT pMin;	/* pointer to a structure */
const pVECTORPOINT pMax;	/* pointer to a structure */

Sets the view context space for an object.

Parameter	Description
pVector	Pointer to the vector handle.
pObject	Pointer to a VECTOROBJECT structure that references the vector object for which to set the view context space.
pMin	Pointer to a VECTORPOINT structure that contains the minimum point of the view context space to set.
pMax	Pointer to a VECTORPOINT structure that contains the maximum point of the view context space to set.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

View context space is a vector space that is assigned to a specific object. Whenever that object is being viewed on the screen as a target object, this view context space will be used as the area that will be displayed instead of showing the object only. This is used mainly in setting the dimensions of an object that will be displayed by the toolkit when the same object is a target of a hyperlink.

To make sure that the view context is understood correctly an example will be needed:

$image\X1.gif$

$image\X2.gif$

After the end-user clicks on the hyperlink, which has the blue rectangle above as its target, the view is changed from the first figure to the second one, taking the view context space into consideration.

Required DLLs and Libraries

LVKRN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Functions:	L_VecGetObjectViewContext, L_VecRemoveObjectViewContext
Topics:	Modifying Vector Object Characteristics
	Working with View Context