Vector Change Notifications and Notification Categories

Description

Vectors

When calling some functions of the LVectorBase LEADTOOLS Class Library classes, particularly those that affect the vector itself, then notification messages are sent through the LVectorBase::StartChanging and LVectorBase::EndChanging member functions. These functions are called before and after executing the function that changes the bitmap. This gives you more control over the operation in progress. In order to use this feature, you must override the virtual functions for StartChanging and EndChanging. In the LVectorBase::StartChanging function, if you return an error code, the change operation will halt the calling function and will return the same error code. In the LVectorBase::EndChanging function you will be notified that the calling function's operation is complete. This gives you a chance to do other processing such as updating the display.

The following sections describe the change notifications and the notification categories:

Vector Changing Notifications:

The following is a list of all the notification messages and the functions that send them:

Notification Message	Function In Progress
NC_VECTOR_ADD_GROUP	LVectorBase::AddGroup
NC_VECTOR_ADD_LAYER	LVectorBase::AddLayer
NC_VECTOR_ADD_OBJECT	LVectorLayer::AddObject
NC_VECTOR_ATTACH	LVectorBase::AttachToWindow
NC_VECTOR_BACKCOLOR	LVectorBase::SetBackgroundColor
NC_VECTOR_BIND_VERTICES	LVectorBase::SetBindVerticesMode
NC_VECTOR_CAMERA	LVectorBase::SetCamera
NC_VECTOR_COPY	LVectorBase::Copy
NC_VECTOR_COPY_GROUP	LVectorBase::CopyGroup
NC_VECTOR_COPY_LAYER	LVectorBase::CopyLayer
NC_VECTOR_COPY_OBJECT	LVectorBase::CopyObject
NC_VECTOR_DELETE_GROUP	LVectorGroup::DeleteGroup
NC_VECTOR_DELETE_GROUP_CLONES	LVectorGroup::DeleteGroupClones
NC_VECTOR_DELETE_LAYER	LVectorLayer::DeleteLayer
NC_VECTOR_DELETE_OBJECTS	LVectorBase::DeleteObject
NC_VECTOR_DIALOG_CAMERA	LVectorDialog::DoModalVectorCamera
NC_VECTOR_DIALOG_ROTATE	LVectorDialog::DoModalVectorRotate
NC_VECTOR_DIALOG_SCALE	LVectorDialog::DoModalVectorScale
NC_VECTOR_DIALOG_TRANSLATE	LVectorDialog::DoModalVectorTranslate
NC_VECTOR_EMPTY_GROUP	LVectorGroup::EmptyGroup
NC_VECTOR_EMPTY_LAYER	LVectorLayer::EmptyLayer
NC_VECTOR_EXPLODE_OBJECT	LVectorObject::ExplodeObject
NC_VECTOR_FREE	LVectorBase::Free
NC_VECTOR_INITIALIZE	LVectorBase::Initialize
NC_VECTOR_PAN	LVectorBase::SetPan
NC_VECTOR_POLYGON_MODE	LVectorBase::SetPolygonMode
NC_VECTOR_REALIZE	LVectorBase::Realize
NC_VECTOR_ROTATE	LVectorBase::SetRotation
NC_VECTOR_SCALE	LVectorBase::SetScale
NC_VECTOR_SELECT_OBJECT	LVectorBase::SelectObject
NC_VECTOR_SET_OBJECT	LVectorObject::UnlockObject
NC_VECTOR_TRANSLATE	LVectorBase::SetTranslation
NC_VECTOR_USE_LIGHTS	LVectorBase::SetUseLights
NC_VECTOR_VECTORHANDLE	LVectorBase::SetHandle
NC_VECTOR_VIEW_MODE	LVectorBase::SetViewMode
NC_VECTOR_VIEW_PORT	LVectorBase::SetViewport

Vector Changing Notification Categories:

The following is a list of all the notification categories:

NCAT_VECTOR	LVectorBase functions for setting view and object characteristics
NCAT_VECTOR_DIALOG	LVectorDialog dialog generation