A3DPDFCheckBoxSetForZoomOnBehaviour

A3DStatus A3DPDFCheckBoxSetForZoomOnBehaviour(A3DPDFCheckBox *pCheckBox, A3DPDF3DNodeScene *p3DNodeScene, A3DPDFEWidgetTargetBehaviour eBehaviour)
A3DStatus A3DPDFCheckBoxSetForZoomOnBehaviour(A3DPDFCheckBox* pCheckBox, A3DPDF3DNodeScene* p3DNodeScene, A3DPDFEWidgetTargetBehaviour eBehaviour)

This function makes the check box field be the selector for the ‘zoom on behaviour’ mode of the 3D nodes scene.

If the end-user checks the check box, the ‘zoom on behaviour’ mode is on ; else it is off. This function provides a way for the end-user to control the ‘zoom on behaviour’ mode for a 3D nodes scene. With it, a check box field can be associated to a 3D nodes scene widget. If the end-user checks the box, depending on the behaviour all highlighting or selections made on the 3D scene are followed by a zoom action, i.e. the camera is zoomed to the highlighted or selected nodes and the rotation center is moved to the center of the bounding box of these nodes. This mode is only available when interactivity is defined using datamodel and the kA3DPDFDataHighlight or kA3DPDFDataSelect target behaviour. An example is a scenario where you have a scroll table associated to a 3D nodes scene, with the target behaviour kA3DPDFDataSelect. When the end-user selects a row in the scroll table, the corresponding node is selected in the 3D nodes scene. Then, if the check box for ‘zoom on behaviour’ mode is checked, the camera zooms to the node. If the check box is not checked, there is no camera zoom.

Return Values

A3D_SUCCESS:

25.3

Parameters

pCheckBox: The CheckBox object to work on.

p3DNodeScene: The 3D widget to work with.

eBehaviour: The behaviour. Supported values are kA3DPDFDataHighlight or kA3DPDFDataSelect.

Returns

A3D_SUCCESS in case of success or an error code