cGetHRText

The function will return all the text associated with each item of a Header common control. Header control items are often found as column titles of report (detail) style List View controls. Double clicking a Header item will often reverse the sort order of the column below it.

The class name for this control is "SysHeader32".

Syntax:

cGetHRText(window-handle)

Parameters:

(i) window-handle Windows handle to a List View common control.

Return:

(s) list A tab-delimited list of the text associated
with each item

32-bit Extender

This function is designed for Windows 32-bit application controls. It cannot be used on Windows 64-bit controls.

64-bit Extender

This function is designed for Windows 64-bit application controls. It cannot be used on Windows on 32-bit controls.

Example:

AddExtender("wwctl44i.dll",0,"wwctl64i.dll")


;Find the Outlook Express header control
hwnd = DllHwnd("Inbox - Outlook")
hwnd = cWndbyclass(hwnd,"ThorCmnViewWndClass")
hwnd = cWndbyclass(hwnd,"ThorMsgViewWndClass")
hwnd = cWndbyclass(hwnd,"SysListView32")
hwnd = cWndbyclass(hwnd,"SysHeader32")
mycolumn = "Subject"
; Get the text for each item of the Header control.
sbtext = cGetHrText(hwnd)
;Get the index of the item of interest
select1=ItemLocate(mycolumn, sbtext, @TAB)
If select1 < 1
   Message("Header column - %mycoumn%","Not Found")
Else
   ; Reverse the sort order of the in box messages.
   cDblClickItem(hwnd, select1)
EndIf
Exit

See Also:

cDblClickItem, cWndByClass, cWndinfo, DLLhwnd (WIL help).