Vector Change Notifications and Notification Categories

Description

Vectors

When calling some functions of the LVectorBase LEADTOOLS C++ 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_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_SET_OBJECT

LVectorObject::UnlockObject

NC_VECTOR_TRANSLATE

LVectorBase::SetTranslation

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