In This Topic ▼

L_VecSetObjectViewContext

Summary

Sets the view context space for an object.

Syntax

#include "ltvkrn.h"

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

Parameters

pVECTOROBJECT pObject

Pointer to a VECTOROBJECT structure that references the vector object for which to set the view context space.

const pVECTORPOINT pMin

Pointer to a VECTORPOINT structure that contains the minimum point of the view context space to set.

const pVECTORPOINT pMax

Pointer to a VECTORPOINT structure that contains the maximum point of the view context space to set.

Returns

Value	Meaning
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.