VXPLib Documentation: COM

IVXPQuickHTML::GetControlsInfo

Requests the parser to get some statistics on tags <CONTROL> in the current document.
HRESULT GetControlsInfo(long * MinID, long * MaxID, long * nControls);
Parameters
MinID [in, out, defaultvalue(NULL)] - Minimum ID among all tags <CONTROL> in the current document, if the function returns a non-zero value, or indeterminate otherwise.
MaxID [in, out, defaultvalue(NULL)] - Maximum ID among all tags <CONTROL> in the current document, if the function returns a non-zero value, or indeterminate otherwise.
nControls [out, retval] - Return value: the number of tags <CONTROL> in the current document
Remarks
When programming for complex QHTML interfaces or simply storing information about windows controls or other objects as QHTML controls it may often become useful to find out how many tags <CONTROL> the current QHTML document contains, and what range of ID-s such objects use. In some situation it is possible that the application doesn't even know anything about the QHTML document, and needs to extract objects from QHTML dynamically. And this is when such function becomes necessary.

The function returns the number of occurrences of tag <CONTROL>, and if it finds at least one such tag it also sets minimum and maximum ID-s used in such tags.
See Also
IVXPQuickHTML Overview | GetControlPos | GetControlAttr | OnControlGetSize | <CONTROL>
This document was last updated on 19/05/2003
Copyright © 2003 Tooltips.NET