Interactive Objects > VpeFindControl

Retrieves a control's handle by the supplied object name. Names can only assigned to objects using dycodoc and templates.

VpeHandle VpeFindControl(

VpeHandle hTemplate,

LPCSTR name

)

VpeHandle hTemplate

Template Handle of the template which was dumped into the VPE Document

LPCSTR name

the name of the control as assigned in dycodoc

Returns:

Returns the Control Handle of the control with the given name.

If no control with the given name was found, NULL is returned.

Example:

// Retrieves the Control Handle of the object named "Street"

// and disables the control

VpeSetControlEnabled(VpeFindControl(hTemplate, "Street"), FALSE);