fivedev/harbour-core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

2012-09-27 15:31 UTC+0200 Viktor Szakats (harbour syenar.net)

Browse Source 
* contrib/gtwvg/combobox.prg
  * contrib/gtwvg/listbox.prg
  * contrib/gtwvg/pushbut.prg
  * contrib/gtwvg/statbar.prg
  * contrib/gtwvg/static.prg
  * contrib/gtwvg/tabpage.prg
  * contrib/gtwvg/toolbar.prg
  * contrib/gtwvg/treeview.prg
    ! deleted (most possibly copyright protected) MSDN documentation
      copied to the end of source files from MS website.
      Visit this link to find the same information online:
         http://msdn.microsoft.com/en-us/library/windows/desktop/bb773169(v=vs.85).aspx
This commit is contained in:
Viktor Szakats
2012-09-27 13:35:33 +00:00
parent d253081be0
commit a15b3d33af
9 changed files with 14 additions and 3085 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
harbour/ChangeLog
View File

@@ -16,6 +16,20 @@
The license applies to all entries newer than 2009-04-28.
*/
2012-09-27 15:31 UTC+0200 Viktor Szakats (harbour syenar.net)
* contrib/gtwvg/combobox.prg
* contrib/gtwvg/listbox.prg
* contrib/gtwvg/pushbut.prg
* contrib/gtwvg/statbar.prg
* contrib/gtwvg/static.prg
* contrib/gtwvg/tabpage.prg
* contrib/gtwvg/toolbar.prg
* contrib/gtwvg/treeview.prg
! deleted (most possibly copyright protected) MSDN documentation
copied to the end of source files from MS website.
Visit this link to find the same information online:
http://msdn.microsoft.com/en-us/library/windows/desktop/bb773169(v=vs.85).aspx
2012-09-27 13:50 UTC+0200 Przemyslaw Czerpak (druzus/at/poczta.onet.pl)
* harbour/contrib/xhb/hbcompat.ch
* harbour/contrib/xhb/xhbinet.c

511
harbour/contrib/gtwvg/combobox.prg
View File

@@ -347,514 +347,3 @@ METHOD WvgComboBox:drawItem( ... )
eval( ::sl_xbePDrawItem, a_[ 1 ], a_[ 2 ], Self )
ENDIF
RETURN Self
/*----------------------------------------------------------------------*/
/* MSDN on ComboBox Control */
/*----------------------------------------------------------------------*/
#if 0
Functions
=========
DlgDirListComboBox
Replaces the contents of a combo box with the names of the subdirectories and files
in a specified directory. You can filter the list of names by specifying a set of file
attributes. The list of names can include mapped drive letters.
DlgDirSelectComboBoxEx
Retrieves the current selection from a combo box filled by using the
DlgDirListComboBox function. The selection is interpreted as a drive letter, a file,
or a directory name.
GetComboBoxInfo
Retrieves information about the specified combo box.
Macros
======
ComboBox_AddItemData
Adds item data to the list in a combo box at the specified location.
You can use this macro or send the CB_ADDSTRING message explicitly.
ComboBox_AddString
Adds a string to a list in a combo box. If the combo box does not have the CBS_SORT style,
the string is added to the end of the list. Otherwise, the string is inserted into the
list and the list is sorted. You can use this macro or send the CB_ADDSTRING message explicitly.
ComboBox_DeleteString
Deletes the item at the specified location in a list in a combo box. You can use
this macro or send the CB_DELETESTRING message explicitly.
ComboBox_Dir
Adds names to the list displayed by a combo box. The macro adds the names of
directories and files that match a specified string and set of file attributes.
It can also add mapped drive letters to the list in a combo box. You can use this
macro or send the CB_DIR message explicitly.
ComboBox_Enable
Enables or disables a combo box control.
ComboBox_FindItemData
Finds the first item in a combo box list that has the specified item data. You can use
this macro or send the CB_FINDSTRING message explicitly.
ComboBox_FindString
Finds the first string in a combo box list that begins with the specified string.
You can use this macro or send the CB_FINDSTRING message explicitly.
ComboBox_FindStringExact
Finds the first string in a combo box list that exactly matches the specified string,
except that the search is not case sensitive. You can use this macro or send the
CB_FINDSTRINGEXACT message explicitly.
ComboBox_GetCount
Gets the number of items in the list box of a combo box. You can use this macro or
send the CB_GETCOUNT message explicitly.
ComboBox_GetCueBannerText
Gets the cue banner text displayed in the edit control of a combo box. Use this
macro or send the CB_GETCUEBANNER message explicitly.
ComboBox_GetCurSel
Gets the index of the currently selected item in a combo box. You can use this
macro or send the CB_GETCURSEL message explicitly.
ComboBox_GetDroppedControlRect
Retrieves the screen coordinates of a combo box in its dropped-down state.
You can use this macro or send the CB_GETDROPPEDCONTROLRECT message explicitly.
ComboBox_GetExtendedUI
Ascertains whether a combo box is using the default user interface (UI) or the extended UI.
You can use this macro or send the CB_GETEXTENDEDUI message explicitly.
ComboBox_GetGetDroppedState
Ascertains whether the drop list in a combo box control is visible.
You can use this macro or send the CB_GETDROPPEDSTATE message explicitly.
ComboBox_GetItemData
Gets the application-defined value associated with the specified list item in a combo box.
You can use this macro or send the CB_GETITEMDATA message explicitly.
ComboBox_GetItemHeight
Retrieves the height of list items in a combo box.
You can use this macro or send the CB_GETITEMHEIGHT message explicitly.
ComboBox_GetLBText
Gets a string from a list in a combo box.
You can use this macro or send the CB_GETLBTEXT message explicitly.
ComboBox_GetLBTextLen
Gets the length of a string in the list in a combo box.
You can use this macro or send the CB_GETLBTEXTLEN message explicitly.
ComboBox_GetMinVisible
Gets the minimum number of visible items in the drop-down list of a combo box.
ComboBox_GetText
Retrieves the text from a combo box control.
ComboBox_GetTextLength
Gets the number of characters in the text of a combo box.
ComboBox_InsertItemData
Inserts item data in a list in a combo box at the specified location.
You can use this macro or send the CB_INSERTSTRING message explicitly.
ComboBox_InsertString
Adds a string to a list in a combo box at the specified location.
You can use this macro or send the CB_INSERTSTRING message explicitly.
ComboBox_LimitText
Limits the length of the text the user may type into the edit control of a combo box.
You can use this macro or send the CB_LIMITTEXT message explicitly.
ComboBox_ResetContent
Removes all items from the list box and edit control of a combo box.
You can use this macro or send the CB_RESETCONTENT message explicitly.
ComboBox_SelectItemData
Searches a list in a combo box for an item that has the specified item data.
If a matching item is found, the item is selected. You can use this macro or send the
CB_SELECTSTRING message explicitly.
ComboBox_SelectString
Searches a list in a combo box for an item that begins with the characters in a specified string.
If a matching item is found, the item is selected. You can use this macro or send the
CB_SELECTSTRING message explicitly.
ComboBox_SetCueBannerText
Sets the cue banner text that is displayed for the edit control of a combo box.
ComboBox_SetCurSel
Sets the currently selected item in a combo box. You can use this macro or send the
CB_SETCURSEL message explicitly.
ComboBox_SetExtendedUI
Selects either the default user interface (UI) or the extended UI for a combo box that has the
CBS_DROPDOWN or CBS_DROPDOWNLIST style. You can use this macro or send the
CB_SETEXTENDEDUI message explicitly.
ComboBox_SetItemData
Sets the application-defined value associated with the specified list item in a combo box.
You can use this macro or send the CB_SETITEMDATA message explicitly.
ComboBox_SetItemHeight
Sets the height of list items or the selection field in a combo box.
You can use this macro or send the CB_SETITEMHEIGHT message explicitly.
ComboBox_SetMinVisible
Sets the minimum number of visible items in the drop-down list of a combo box.
SetText
Sets the text of a combo box.
ComboBox_ShowDropdown
Shows or hides the list in a combo box.
You can use this macro or send the CB_RESETCONTENT message explicitly.
ListBox_AddItemData
Adds item data to the list box at the specified location.
You can use this macro or send the LB_ADDSTRING message explicitly.
Messages
========
CB_ADDSTRING
Adds a string to the list box of a combo box. If the combo box does not have
the CBS_SORT style, the string is added to the end of the list. Otherwise, the
string is inserted into the list, and the list is sorted.
CB_DELETESTRING
Deletes a string in the list box of a combo box.
CB_DIR
Adds names to the list displayed by the combo box. The message adds the names of
directories and files that match a specified string and set of file attributes.
CB_DIR can also add mapped drive letters to the list.
CB_FINDSTRING
Searches the list box of a combo box for an item beginning with the characters in
a specified string.
CB_FINDSTRINGEXACT
Finds the first list box string in a combo box that matches the string specified in
the lParam parameter.
CB_GETCOMBOBOXINFO
Gets information about the specified combo box.
CB_GETCOUNT
Gets the number of items in the list box of a combo box.
CB_GETCUEBANNER
Gets the cue banner text displayed in the edit control of a combo box.
Send this message explicitly or by using the ComboBox_GetCueBannerText macro.
CB_GETCURSEL
An application sends a CB_GETCURSEL message to retrieve the index of the currently
selected item, if any, in the list box of a combo box.
CB_GETDROPPEDCONTROLRECT
An application sends a CB_GETDROPPEDCONTROLRECT message to retrieve the screen coordinates of a
combo box in its dropped-down state.
CB_GETDROPPEDSTATE
Determines whether the list box of a combo box is dropped down.
CB_GETDROPPEDWIDTH
Gets the minimum allowable width, in pixels, of the list box of a combo box with the
CBS_DROPDOWN or CBS_DROPDOWNLIST style.
CB_GETEDITSEL
Gets the starting and ending character positions of the current selection in the edit
control of a combo box.
CB_GETEXTENDEDUI
Determines whether a combo box has the default user interface or the extended user interface.
CB_GETHORIZONTALEXTENT
Gets the width, in pixels, that the list box can be scrolled horizontally (the scrollable width).
This is applicable only if the list box has a horizontal scroll bar.
CB_GETITEMDATA
An application sends a CB_GETITEMDATA message to a combo box to retrieve the
application-supplied value associated with the specified item in the combo box.
CB_GETITEMHEIGHT
Determines the height of list items or the selection field in a combo box.
CB_GETLBTEXT
Gets a string from the list of a combo box.
CB_GETLBTEXTLEN
Gets the length, in characters, of a string in the list of a combo box.
CB_GETLOCALE
Gets the current locale of the combo box. The locale is used to determine the
correct sorting order of displayed text for combo boxes with the CBS_SORT style and
text added by using the CB_ADDSTRING message.
CB_GETMINVISIBLE
Gets the minimum number of visible items in the drop-down list of a combo box.
CB_GETTOPINDEX
An application sends the CB_GETTOPINDEX message to retrieve the zero-based index of
the first visible item in the list box portion of a combo box. Initially, the item with
index 0 is at the top of the list box, but if the list box contents have been scrolled,
another item may be at the top.
CB_INITSTORAGE
An application sends the CB_INITSTORAGE message before adding a large number of items
to the list box portion of a combo box. This message allocates memory for storing list box items.
CB_INSERTSTRING
Inserts a string or item data into the list of a combo box. Unlike the CB_ADDSTRING message,
the CB_INSERTSTRING message does not cause a list with the CBS_SORT style to be sorted.
CB_LIMITTEXT
Limits the length of the text the user may type into the edit control of a combo box.
CB_RESETCONTENT
Removes all items from the list box and edit control of a combo box.
CB_SELECTSTRING
Searches the list of a combo box for an item that begins with the characters in a specified string.
If a matching item is found, it is selected and copied to the edit control.
CB_SETCUEBANNER
Sets the cue banner text that is displayed for the edit control of a combo box.
CB_SETCURSEL
An application sends a CB_SETCURSEL message to select a string in the list of a combo box.
If necessary, the list scrolls the string into view. The text in the edit control of the
combo box changes to reflect the new selection, and any previous selection in the list
is removed.
CB_SETDROPPEDWIDTH
An application sends the CB_SETDROPPEDWIDTH message to set the maximum allowable width,
in pixels, of the list box of a combo box with the CBS_DROPDOWN or CBS_DROPDOWNLIST style.
CB_SETEDITSEL
An application sends a CB_SETEDITSEL message to select characters in the edit control of a combo box.
CB_SETEXTENDEDUI
An application sends a CB_SETEXTENDEDUI message to select either the default user
interface (UI) or the extended UI for a combo box that has the CBS_DROPDOWN or CBS_DROPDOWNLIST style.
CB_SETHORIZONTALEXTENT
An application sends the CB_SETHORIZONTALEXTENT message to set the width, in pixels,
by which a list box can be scrolled horizontally (the scrollable width). If the width of
the list box is smaller than this value, the horizontal scroll bar horizontally scrolls items
in the list box. If the width of the list box is equal to or greater than this value, the horizontal
scroll bar is hidden or, if the combo box has the CBS_DISABLENOSCROLL style, disabled.
CB_SETITEMDATA
An application sends a CB_SETITEMDATA message to set the value associated with the specified
item in a combo box.
CB_SETITEMHEIGHT
An application sends a CB_SETITEMHEIGHT message to set the height of list items or the
selection field in a combo box.
CB_SETLOCALE
An application sends a CB_SETLOCALE message to set the current locale of the combo box.
If the combo box has the CBS_SORT style and strings are added using CB_ADDSTRING, the locale
of a combo box affects how list items are sorted.
CB_SETMINVISIBLE
An application sends a CB_SETMINVISIBLE message to set the minimum number of visible items
in the drop-down list of a combo box.
CB_SETTOPINDEX
An application sends the CB_SETTOPINDEX message to ensure that a particular item is visible
in the list box of a combo box. The system scrolls the list box contents so that either the
specified item appears at the top of the list box or the maximum scroll range has been reached.
CB_SHOWDROPDOWN
An application sends a CB_SHOWDROPDOWN message to show or hide the list box of a combo box
that has the CBS_DROPDOWN or CBS_DROPDOWNLIST style.
Notifications
=============
CBN_CLOSEUP
The CBN_CLOSEUP notification message is sent when the list box of a combo box has been closed.
The parent window of the combo box receives this notification message through the WM_COMMAND message.
CBN_DBLCLK
The CBN_DBLCLK notification message is sent when the user double-clicks a string in the list
box of a combo box. The parent window of the combo box receives this notification message
through the WM_COMMAND message.
CBN_DROPDOWN
The CBN_DROPDOWN notification message is sent when the list box of a combo box is about to
be made visible. The parent window of the combo box receives this notification message
through the WM_COMMAND message.
CBN_EDITCHANGE
The CBN_EDITCHANGE notification message is sent after the user has taken an action that may
have altered the text in the edit control portion of a combo box. Unlike the
CBN_EDITUPDATE notification message, this notification message is sent after the system
updates the screen. The parent window of the combo box receives this notification message
through the WM_COMMAND message.
CBN_EDITUPDATE
The CBN_EDITUPDATE notification message is sent when the edit control portion of a combo
box is about to display altered text. This notification message is sent after the control
has formatted the text, but before it displays the text. The parent window of the combo box
receives this notification message through the WM_COMMAND message.
CBN_ERRSPACE
The CBN_ERRSPACE notification message is sent when a combo box cannot allocate enough
memory to meet a specific request. The parent window of the combo box receives this
notification message through the WM_COMMAND message.
CBN_KILLFOCUS
The CBN_KILLFOCUS notification message is sent when a combo box loses the keyboard focus.
The parent window of the combo box receives this notification message through the WM_COMMAND message.
CBN_SELCHANGE
The CBN_SELCHANGE notification message is sent when the user changes the current selection
in the list box of a combo box. The user can change the selection by clicking in the list
box or by using the arrow keys. The parent window of the combo box receives this
notification in the form of a WM_COMMAND message with CBN_SELCHANGE in the high-order
word of the wParam parameter.
CBN_SELENDCANCEL
The CBN_SELENDCANCEL notification message is sent when the user selects an item,
but then selects another control or closes the dialog box. It indicates the user
s initial selection is to be ignored. The parent window of the combo box receives
this notification message through the WM_COMMAND message.
CBN_SELENDOK
The CBN_SELENDOK notification message is sent when the user selects a list item,
or selects an item and then closes the list. It indicates that the user s selection
is to be processed. The parent window of the combo box receives this notification
message through the WM_COMMAND message.
CBN_SETFOCUS
The CBN_SETFOCUS notification message is sent when a combo box receives the keyboard focus.
The parent window of the combo box receives this notification message through the WM_COMMAND message.
WM_COMPAREITEM
The system sends the WM_COMPAREITEM message to determine the relative position of a new
item in the sorted list of an owner-drawn combo box or list box. Whenever the application
adds a new item, the system sends this message to the owner of a combo box or list box created
with the CBS_SORT or LBS_SORT style.
WM_DRAWITEM
The WM_DRAWITEM message is sent to the parent window of an owner-drawn button, combo box,
list box, or menu when a visual aspect of the button, combo box, list box, or menu has changed.
A window receives this message through its WindowProc function.
WM_MEASUREITEM
The WM_MEASUREITEM message is sent to the owner window of a combo box, list box,
list view control, or menu item when the control or menu is created.
A window receives this message through its WindowProc function.
Structures
==========
COMBOBOXINFO
Contains combo box status information.
COMPAREITEMSTRUCT
Supplies the identifiers and application-supplied data for two items in a sorted,
owner-drawn list box or combo box.
Whenever an application adds a new item to an owner-drawn list box or combo box
created with the CBS_SORT or LBS_SORT style, the system sends the owner a
WM_COMPAREITEM message. The lParam parameter of the message contains a long pointer
to a COMPAREITEMSTRUCT structure. Upon receiving the message, the owner compares
the two items and returns a value indicating which item sorts before the other.
DRAWITEMSTRUCT
Provides necessary information the owner window to determine how to paint an owner-drawn
control or menu item. The owner window of the owner-drawn control or menu item receives a
pointer to this structure as the lParam parameter of the WM_DRAWITEM message.
MEASUREITEMSTRUCT
Informs the system of the dimensions of an owner-drawn control or menu item.
This allows the system to process user interaction with the control correctly.
Combo Box Styles
To create a combo box using the CreateWindow or CreateWindowEx function, specify
the COMBOBOX class, appropriate window style constants, and a combination of the
following combo box styles.
Constants
CBS_AUTOHSCROLL
Automatically scrolls the text in an edit control to the right when the user types a
character at the end of the line. If this style is not set, only text that fits within
the rectangular boundary is allowed.
CBS_DISABLENOSCROLL
Shows a disabled vertical scroll bar in the list box when the box does not contain
enough items to scroll. Without this style, the scroll bar is hidden when the list box
does not contain enough items.
CBS_DROPDOWN
Similar to CBS_SIMPLE, except that the list box is not displayed unless the user selects
an icon next to the edit control.
CBS_DROPDOWNLIST
Similar to CBS_DROPDOWN, except that the edit control is replaced by a static text
item that displays the current selection in the list box.
CBS_HASSTRINGS
Specifies that an owner-drawn combo box contains items consisting of strings.
The combo box maintains the memory and address for the strings so the application
can use the CB_GETLBTEXT message to retrieve the text for a particular item.
For accessibility issues, see Exposing Owner-Drawn Combo Box Items
CBS_LOWERCASE
Converts to lowercase all text in both the selection field and the list.
CBS_NOINTEGRALHEIGHT
Specifies that the size of the combo box is exactly the size specified by the
application when it created the combo box. Normally, the system sizes a combo box
so that it does not display partial items.
CBS_OEMCONVERT
Converts text entered in the combo box edit control from the Windows character
set to the OEM character set and then back to the Windows character set.
This ensures proper character conversion when the application calls the
CharToOem function to convert a Windows string in the combo box to OEM characters.
This style is most useful for combo boxes that contain file names and applies only
to combo boxes created with the CBS_SIMPLE or CBS_DROPDOWN style.
CBS_OWNERDRAWFIXED
Specifies that the owner of the list box is responsible for drawing its contents
and that the items in the list box are all the same height. The owner window
receives a WM_MEASUREITEM message when the combo box is created and a WM_DRAWITEM
message when a visual aspect of the combo box has changed.
CBS_OWNERDRAWVARIABLE
Specifies that the owner of the list box is responsible for drawing its contents
and that the items in the list box are variable in height. The owner window receives
a WM_MEASUREITEM message for each item in the combo box when you create the combo box
and a WM_DRAWITEM message when a visual aspect of the combo box has changed.
CBS_SIMPLE
Displays the list box at all times. The current selection in the list box is displayed
in the edit control.
CBS_SORT
Automatically sorts strings added to the list box.
CBS_UPPERCASE
Converts to uppercase all text in both the selection field and the list.
#endif
/*----------------------------------------------------------------------*/

342
harbour/contrib/gtwvg/listbox.prg
View File

@@ -323,345 +323,3 @@ METHOD WvgListBox:configure( oParent, oOwner, aPos, aSize, aPresParams, lVisible
METHOD WvgListBox:destroy()
::WvgWindow:destroy()
RETURN NIL
/*----------------------------------------------------------------------*/
/* MSDN on ListBox Control */
/*----------------------------------------------------------------------*/
#if 0
Functions
=========
DlgDirList
Replaces the contents of a list box with the names of the subdirectories and files in a
specified directory. You can filter the list of names by specifying a set of file attributes.
The list can optionally include mapped drives.
DlgDirSelectEx
Retrieves the current selection from a single-selection list box. It assumes that the
list box has been filled by the DlgDirList function and that the selection is a drive letter,
filename, or directory name.
GetListBoxInfo
Retrieves information about the specified list box.
Messages
========
LB_ADDFILE
Adds the specified filename to a list box that contains a directory listing.
LB_ADDSTRING
Adds a string to a list box. If the list box does not have the LBS_SORT style,
the string is added to the end of the list. Otherwise, the string is inserted into the list
and the list is sorted.
LB_DELETESTRING
Deletes a string in a list box.
LB_DIR
Adds names to the list displayed by a list box. The message adds the names of directories
and files that match a specified string and set of file attributes. LB_DIR can also add
mapped drive letters to the list box.
LB_FINDSTRING
Finds the first string in a list box that begins with the specified string.
LB_FINDSTRINGEXACT
Finds the first list box string that exactly matches the specified string, except that
the search is not case sensitive.
LB_GETANCHORINDEX
Gets the index of the anchor item
LB_GETCARETINDEX
Retrieves the index of the item that has the focus rectangle in a multiple-selection list box.
The item may or may not be selected.
LB_GETCOUNT
Gets the number of items in a list box.
LB_GETCURSEL
Gets the index of the currently selected item, if any, in a single-selection list box.
LB_GETHORIZONTALEXTENT
Gets the width, in pixels, that a list box can be scrolled horizontally (the scrollable width)
if the list box has a horizontal scroll bar.
LB_GETITEMDATA
Gets the application-defined value associated with the specified list box item.
LB_GETITEMHEIGHT
Gets the height of items in a list box.
LB_GETITEMRECT
Gets the dimensions of the rectangle that bounds a list box item as it is currently displayed
in the list box.
LB_GETLISTBOXINFO
Gets the number of items per column in a specified list box.
LB_GETLOCALE
Gets the current locale of the list box. You can use the locale to determine the correct
sorting order of displayed text (for list boxes with the LBS_SORT style) and of text
added by the LB_ADDSTRING message.
LB_GETSEL
Gets the selection state of an item.
LB_GETSELCOUNT
Gets the total number of selected items in a multiple-selection list box.
LB_GETSELITEMS
Fills a buffer with an array of integers that specify the item numbers of selected items in
a multiple-selection list box.
LB_GETTEXT
Gets a string from a list box.
LB_GETTEXTLEN
Gets the length of a string in a list box.
LB_GETTOPINDEX
Gets the index of the first visible item in a list box. Initially the item with index 0
is at the top of the list box, but if the list box contents have been scrolled another item
may be at the top.
LB_INITSTORAGE
Allocates memory for storing list box items. This message is used before an application adds
a large number of items to a list box.
LB_INSERTSTRING
Inserts a string or item data into a list box. Unlike the LB_ADDSTRING message,
the LB_INSERTSTRING message does not cause a list with the LBS_SORT style to be sorted.
LB_ITEMFROMPOINT
Gets the zero-based index of the item nearest the specified point in a list box.
LB_RESETCONTENT
Removes all items from a list box.
LB_SELECTSTRING
Searches a list box for an item that begins with the characters in a specified string.
If a matching item is found, the item is selected.
LB_SELITEMRANGE
Selects or deselects one or more consecutive items in a multiple-selection list box.
LB_SELITEMRANGEEX
Selects one or more consecutive items in a multiple-selection list box.
LB_SETANCHORINDEX
Sets the anchor item
LB_SETCARETINDEX
Sets the focus rectangle to the item at the specified index in a multiple-selection list box.
If the item is not visible, it is scrolled into view.
LB_SETCOLUMNWIDTH
Sets the width, in pixels, of all columns in a multiple-column list box.
LB_SETCOUNT
Sets the count of items in a list box created with the LBS_NODATA style and not created with
the LBS_HASSTRINGS style.
LB_SETCURSEL
Selects a string and scrolls it into view, if necessary. When the new string is selected,
the list box removes the highlight from the previously selected string.
LB_SETHORIZONTALEXTENT
Sets the width, in pixels, by which a list box can be scrolled horizontally (the scrollable width).
If the width of the list box is smaller than this value, the horizontal scroll bar horizontally
scrolls items in the list box. If the width of the list box is equal to or greater than this value,
the horizontal scroll bar is hidden.
LB_SETITEMDATA
Sets a value associated with the specified item in a list box.
LB_SETITEMHEIGHT
Sets the height, in pixels, of items in a list box. If the list box has the
LBS_OWNERDRAWVARIABLE style, this message sets the height of the item specified
by the wParam parameter. Otherwise, this message sets the height of all items in the list box.
LB_SETLOCALE
Sets the current locale of the list box. You can use the locale to determine the
correct sorting order of displayed text (for list boxes with the LBS_SORT style)
and of text added by the LB_ADDSTRING message.
LB_SETSEL
Selects a string in a multiple-selection list box.
LB_SETTABSTOPS
Sets the tab-stop positions in a list box.
LB_SETTOPINDEX
Ensures that the specified item in a list box is visible.
Notifications
=============
LBN_DBLCLK
Notifies the application that the user has double-clicked an item in a list box.
The parent window of the list box receives this notification message through the WM_COMMAND message.
LBN_ERRSPACE
Notifies the application that the list box cannot allocate enough memory to meet a specific request.
The parent window of the list box receives this notification message through the WM_COMMAND message.
LBN_KILLFOCUS
Notifies the application that the list box has lost the keyboard focus. The parent window of the
list box receives this notification message through the WM_COMMAND message.
LBN_SELCANCEL
Notifies the application that the user has canceled the selection in a list box. The parent
window of the list box receives this notification message through the WM_COMMAND message.
LBN_SELCHANGE
Notifies the application that the selection in a list box has changed. The parent window of
the list box receives this notification message through the WM_COMMAND message.
LBN_SETFOCUS
Notifies the application that the list box has received the keyboard focus. The parent window
of the list box receives this notification message through the WM_COMMAND message.
WM_CHARTOITEM
Sent by a list box with the LBS_WANTKEYBOARDINPUT style to its owner in response to a WM_CHAR message.
WM_CTLCOLORLISTBOX
Sent to the parent window of a list box before the system draws the list box.
By responding to this message, the parent window can set the text and background colors
of the list box by using the specified display device context handle.
WM_DELETEITEM
Sent to the owner of a list box or combo box when the list box or combo box is destroyed
or when items are removed by the LB_DELETESTRING, LB_RESETCONTENT, CB_DELETESTRING,
or CB_RESETCONTENT message. The system sends a WM_DELETEITEM message for each deleted item.
The system sends the WM_DELETEITEM message for any deleted list box or combo box item with
nonzero item data.
WM_VKEYTOITEM
Sent by a list box with the LBS_WANTKEYBOARDINPUT style to its owner in response
to a WM_KEYDOWN message.
Structures
==========
DELETEITEMSTRUCT
Describes a deleted list box or combo box item. The lParam parameter of a
WM_DELETEITEM message contains a pointer to this structure. When an item is removed from a
list box or combo box or when a list box or combo box is destroyed, the system sends the
WM_DELETEITEM message to the owner for each deleted item.
Windows NT/2000/XP: The system sends a WM_DELETEITEM message only for items deleted from
an owner-drawn list box (with the LBS_OWNERDRAWFIXED or LBS_OWNERDRAWVARIABLE style) or
owner-drawn combo box (with the CBS_OWNERDRAWFIXED or CBS_OWNERDRAWVARIABLE style).
Windows 95/98/Me: The system sends the WM_DELETEITEM message for any deleted list box
or combo box item with nonzero item data.
List Box Styles
===============
To create a list box by using the CreateWindow or CreateWindowEx function,
use the LISTBOX class, appropriate window style constants, and the following style constants to
define the list box. After the control has been created, these styles cannot be modified, except as noted.
Constants
LBS_COMBOBOX
Notifies a list box that it is part of a combo box. This allows coordination between the
two controls so that they present a unified user interface (UI). The combo box itself
must set this style. If the style is set by anything but the combo box, the list box
will regard itself incorrectly as a child of a combo box and a failure will result.
LBS_DISABLENOSCROLL
Shows a disabled vertical scroll bar for the list box when the box does not contain
enough items to scroll. If you do not specify this style, the scroll bar is hidden
when the list box does not contain enough items.
LBS_EXTENDEDSEL
Allows multiple items to be selected by using the SHIFT key and the mouse or special key combinations.
LBS_HASSTRINGS
Specifies that a list box contains items consisting of strings. The list box maintains
the memory and addresses for the strings so that the application can use the LB_GETTEXT message
to retrieve the text for a particular item. By default, all list boxes except owner-drawn list
boxes have this style. You can create an owner-drawn list box either with or without this style.
LBS_MULTICOLUMN
Specifies a multi-columnn list box that is scrolled horizontally. The LB_SETCOLUMNWIDTH message
sets the width of the columns.
LBS_MULTIPLESEL
Turns string selection on or off each time the user clicks or double-clicks a string in the list box.
The user can select any number of strings.
LBS_NODATA
Specifies a no-data list box. Specify this style when the count of items in the list box
will exceed one thousand. A no-data list box must also have the LBS_OWNERDRAWFIXED style,
but must not have the LBS_SORT or LBS_HASSTRINGS style.
A no-data list box resembles an owner-drawn list box except that it contains no string or
bitmap data for an item. Commands to add, insert, or delete an item always ignore any
specified item data; requests to find a string within the list box always fail.
The system sends the WM_DRAWITEM message to the owner window when an item must be drawn.
The itemID member of the DRAWITEMSTRUCT structure passed with the WM_DRAWITEM message
specifies the line number of the item to be drawn. A no-data list box does not send a
WM_DELETEITEM message.
LBS_NOINTEGRALHEIGHT
Specifies that the size of the list box is exactly the size specified by the application
when it created the list box. Normally, the system sizes a list box so that the list box
does not display partial items.
LBS_NOREDRAW
Specifies that the list box s appearance is not updated when changes are made.
To change the redraw state of the control, use the WM_SETREDRAW message.
LBS_NOSEL
Specifies that the list box contains items that can be viewed but not selected.
LBS_NOTIFY
Notifies the parent window with an input message whenever the user clicks or double-clicks
a string in the list box.
LBS_OWNERDRAWFIXED
Specifies that the owner of the list box is responsible for drawing its contents and that
the items in the list box are the same height. The owner window receives a
WM_MEASUREITEM message when the list box is created and a WM_DRAWITEM message when
a visual aspect of the list box has changed.
LBS_OWNERDRAWVARIABLE
Specifies that the owner of the list box is responsible for drawing its contents and that
the items in the list box are variable in height. The owner window receives a
WM_MEASUREITEM message for each item in the combo box when the combo box is created and a
WM_DRAWITEM message when a visual aspect of the combo box has changed.
LBS_SORT
Sorts strings in the list box alphabetically.
LBS_STANDARD
Sorts strings in the list box alphabetically. The parent window receives an input
message whenever the user clicks or double-clicks a string. The list box has borders on all sides.
LBS_USETABSTOPS
Enables a list box to recognize and expand tab characters when drawing its strings.
You can use the LB_SETTABSTOPS message to specify tab stop positions. The default tab positions
are 32 dialog template units apart. Dialog template units are the device-independent units used
in dialog box templates. To convert measurements from dialog template units to screen units (pixels),
use the MapDialogRect function.
LBS_WANTKEYBOARDINPUT
Specifies that the owner of the list box receives WM_VKEYTOITEM messages whenever
the user presses a key and the list box has the input focus. This enables an application
to perform special processing on the keyboard input.
#endif
/*----------------------------------------------------------------------*/

309
harbour/contrib/gtwvg/pushbut.prg
View File

@@ -260,312 +260,3 @@ METHOD WvgPushButton:draw( xParam )
ENDIF
RETURN Self
/*----------------------------------------------------------------------*/
/* MSDN on Button Control */
/*----------------------------------------------------------------------*/
#if 0
Functions
=========
CheckDlgButton
Changes the check state of a button control.
CheckRadioButton
Adds a check mark to (checks) a specified radio button in a group and removes a check mark from
(clears) all other radio buttons in the group.
IsDlgButtonChecked
The IsDlgButtonChecked function determines whether a button control is checked or whether a
three-state button control is checked, unchecked, or indeterminate.
Macros
======
Button_Enable
Enables or disables a button.
Button_GetCheck
Gets the check state of a radio button or check box. You can use this macro or send the BM_GETCHECK
message explicitly.
Button_GetIdealSize
Gets the size of the button that best fits the text and image, if an image list is present.
You can use this macro or send the BCM_GETIDEALSIZE message explicitly.
Button_GetImageList
Gets the BUTTON_IMAGELIST structure that describes the image list that is set for a button control.
You can use this macro or send the BCM_GETIMAGELIST message explicitly.
Button_GetNote
Gets the text of the note associated with a command link button. You can use this macro or send
the BCM_GETNOTE message explicitly.
Button_GetNoteLength
Gets the length of the note text that may be displayed in the description for a command link.
Use this macro or send the BCM_GETNOTELENGTH message explicitly.
Button_GetSplitInfo
Gets information for a specified split button control. Use this macro or send the
BCM_GETSPLITINFO message explicitly.
Button_GetState
Gets the check state of a radio button or check box. You can use this macro or send the
BM_GETSTATE message explicitly.
Button_GetText
Gets the text of a button.
Button_GetTextLength
Gets the number of characters in the text of a button.
Button_GetTextMargin
Gets the margins used to draw text in a button control. You can use this macro or send the
BCM_GETTEXTMARGIN message explicitly.
Button_SetCheck
Sets the check state of a radio button or check box. You can use this macro or send the
BM_SETCHECK message explicitly.
Button_SetDropDownState
Sets the drop down state for a specified button with style of BS_SPLITBUTTON.
Use this macro or send the BCM_SETDROPDOWNSTATE message explicitly.
Button_SetElevationRequiredState
Sets the elevation required state for a specified button or command link to display an elevated icon.
Use this macro or send the BCM_SETSHIELD message explicitly.
Button_SetImageList
Assigns an image list to a button control. You can use this macro or send the
BCM_SETIMAGELIST message explicitly.
Button_SetNote
Sets the text of the note associated with a specified command link button.
You can use this macro or send the BCM_SETNOTE message explicitly.
Button_SetSplitInfo
Sets information for a specified split button control. Use this macro or send the
BCM_SETSPLITINFO message explicitly.
Button_SetState
Sets the highlight state of a button. The highlight state indicates whether the button
is highlighted as if the user had pushed it. You can use this macro or send the
BM_SETSTATE message explicitly.
Button_SetStyle
Sets the style of a button. You can use this macro or send the BM_SETSTYLE message explicitly.
Button_SetText
Sets the text of a button.
Button_SetTextMargin
Sets the margins for drawing text in a button control. You can use this macro or send the
BCM_SETTEXTMARGIN message explicitly.
Messages
========
BCM_GETIDEALSIZE
Gets the size of the button that best fits its text and image, if an image list is present.
You can send this message explicitly or use the Button_GetIdealSize macro.
BCM_GETIMAGELIST
Gets the BUTTON_IMAGELIST structure that describes the image list assigned to a button control.
You can send this message explicitly or use the Button_GetImageList macro.
BCM_GETNOTE
Gets the text of the note associated with a command link button. You can send this message
explicitly or use the Button_GetNote macro.
BCM_GETNOTELENGTH
Gets the length of the note text that may be displayed in the description for a command link button.
Send this message explicitly or by using the Button_GetNoteLength macro.
BCM_GETSPLITINFO
Gets information for a split button control. Send this message explicitly or by using the
Button_GetSplitInfo macro.
BCM_GETTEXTMARGIN
Gets the margins used to draw text in a button control. You can send this message explicitly or
use the Button_GetTextMargin macro.
BCM_SETDROPDOWNSTATE
Sets the drop down state for a button with style TBSTYLE_DROPDOWN. Send this message explicitly
or by using the Button_SetDropDownState macro.
BCM_SETIMAGELIST
Assigns an image list to a button control. You can send this message explicitly or use the
Button_SetImageList macro.
BCM_SETNOTE
Sets the text of the note associated with a command link button. You can send this message
explicitly or use the Button_SetNote macro.
BCM_SETSHIELD
Sets the elevation required state for a specified button or command link to display an elevated icon.
Send this message explicitly or by using the Button_SetElevationRequiredState macro.
BCM_SETSPLITINFO
Sets information for a split button control. Send this message explicitly or by using the
Button_SetSplitInfo macro.
BCM_SETTEXTMARGIN
The BCM_SETTEXTMARGIN message sets the margins for drawing text in a button control.
BM_CLICK
Simulates the user clicking a button. This message causes the button to receive the
WM_LBUTTONDOWN and WM_LBUTTONUP messages, and the button s parent window to receive a
BN_CLICKED notification message.
BM_GETCHECK
Gets the check state of a radio button or check box. You can send this message explicitly or
use the Button_GetCheck macro.
BM_GETIMAGE
Retrieves a handle to the image (icon or bitmap) associated with the button.
BM_GETSTATE
Retrieves the state of a button or check box. You can send this message explicitly or use the
Button_GetState macro.
BM_SETCHECK
Sets the check state of a radio button or check box. You can send this message explicitly or by
using the Button_SetCheck macro.
BM_SETDONTCLICK
Sets a flag on a radio button that controls the generation of BN_CLICKED messages when the
button receives focus.
BM_SETIMAGE
Associates a new image (icon or bitmap) with the button.
BM_SETSTATE
Sets the highlight state of a button. The highlight state indicates whether the button is
highlighted as if the user had pushed it. You can send this message explicitly or use the
Button_SetState macro.
BM_SETSTYLE
Sets the style of a button. You can send this message explicitly or use the Button_SetStyle macro.
Notifications
=============
BCN_DROPDOWN
Sent when the user clicks a drop down arrow on a button. The parent window of the control receives
this notification message in the form of a WM_NOTIFY message.
BCN_HOTITEMCHANGE
Notifies the button control owner that the mouse is entering or leaving the client area of the
button control. The button control sends this notification in the form of a WM_NOTIFY message.
BN_CLICKED
Sent when the user clicks a button.
The parent window of the button receives the BN_CLICKED notification code through the WM_COMMAND message.
BN_DBLCLK
Sent when the user double-clicks a button. This notification is sent automatically for
BS_USERBUTTON, BS_RADIOBUTTON, and BS_OWNERDRAW buttons. Other button types send
BN_DBLCLK only if they have the BS_NOTIFY style.
The parent window of the button receives the BN_DBLCLK notification code through the WM_COMMAND message.
BN_DISABLE
Sent when a button is disabled.
Note This notification message is provided only for compatibility with 16-bit versions of
Microsoft Windows earlier than version 3.0. Applications should use the BS_OWNERDRAW button style
and the DRAWITEMSTRUCT structure for this task.
The parent window of the button receives the BN_DISABLE notification code through the WM_COMMAND message.
BN_DOUBLECLICKED
Sent when the user double-clicks a button. This notification is sent automatically for
BS_USERBUTTON, BS_RADIOBUTTON, and BS_OWNERDRAW buttons. Other button types send
BN_DOUBLECLICKED only if they have the BS_NOTIFY style.
The parent window of the button receives the BN_DOUBLECLICKED notification code through the
WM_COMMAND message.
BN_HILITE
Sent when the user selects a button.
Note This notification message is provided only for compatibility with 16-bit versions
of Windows earlier than version 3.0. Applications should use the BS_OWNERDRAW button style
and the DRAWITEMSTRUCT structure for this task.
The parent window of the button receives the BN_HILITE notification code through the WM_COMMAND message.
BN_KILLFOCUS
Sent when a button loses the keyboard focus. The button must have the
BS_NOTIFY style to send this notification message.
The parent window of the button receives the BN_KILLFOCUS notification code through the
WM_COMMAND message.
BN_PAINT
Sent when a button should be painted.
Note This notification message is provided only for compatibility with 16-bit versions of
Windows earlier than version 3.0. Applications should use the BS_OWNERDRAW button style and
the DRAWITEMSTRUCT structure for this task.
The parent window of the button receives the BN_PAINT notification code through the WM_COMMAND message.
BN_PUSHED
Sent when the push state of a button is set to pushed.
Note This notification message is provided only for compatibility with 16-bit versions
of Windows earlier than version 3.0. Applications should use the BS_OWNERDRAW button
style and the DRAWITEMSTRUCT structure for this task.
The parent window of the button receives the BN_PUSHED notification code through the WM_COMMAND message.
BN_SETFOCUS
Sent when a button receives the keyboard focus. The button must have the BS_NOTIFY style to
send this notification message.
The parent window of the button receives the BN_SETFOCUS notification code through the WM_COMMAND message.
BN_UNHILITE
Sent when the highlight should be removed from a button.
Note This notification message is provided only for compatibility with 16-bit versions of
Windows earlier than version 3.0. Applications should use the BS_OWNERDRAW button style and
the DRAWITEMSTRUCT structure for this task.
The parent window of the button receives the BN_UNHILITE notification code through the WM_COMMAND message.
BN_UNPUSHED
Sent when the push state of a button is set to unpushed.
Note This notification message is provided only for compatibility with 16-bit versions
of Windows earlier than version 3.0. Applications should use the BS_OWNERDRAW button style
and the DRAWITEMSTRUCT structure for this task.
The parent window of the button receives the BN_UNPUSHED notification code through the WM_COMMAND message.
NM_CUSTOMDRAW (button)
Notifies the parent window of a button control about custom draw operations on the button.
The button control sends this notification in the form of a WM_NOTIFY message.
WM_CTLCOLORBTN
The WM_CTLCOLORBTN message is sent to the parent window of a button before drawing the button.
The parent window can change the button s text and background colors. However, only owner-drawn
buttons respond to the parent window processing this message.
Structures
==========
BUTTON_IMAGELIST
Contains information about an image list that is used with a button control.
BUTTON_SPLITINFO
Contains information that defines a split button (BS_SPLITBUTTON and BS_DEFSPLITBUTTON styles).
Used with the BCM_GETSPLITINFO and BCM_SETSPLITINFO messages.
NMBCDROPDOWN
Contains information about a BCN_DROPDOWN notification.
NMBCHOTITEM
Contains information about the movement of the mouse over a button control.
Constants
=========
Button Styles
Specifies a combination of button styles. If you create a button using the BUTTON class
with the CreateWindow or CreateWindowEx function, you can specify any of the button styles listed below.
#endif
/*----------------------------------------------------------------------*/

104
harbour/contrib/gtwvg/statbar.prg
View File

@@ -378,107 +378,3 @@ METHOD WvgStatusBarPanel:caption( cCaption )
ENDIF
RETURN Self
/*----------------------------------------------------------------------*/
/* MSDN on StatusBar Control */
/*----------------------------------------------------------------------*/
#if 0
Messages
========
SB_GETBORDERS
Retrieves the current widths of the horizontal and vertical borders of a status window.
SB_GETICON
Retrieves the icon for a part in a status bar.
SB_GETPARTS
Retrieves a count of the parts in a status window. The message also retrieves the coordinate
of the right edge of the specified number of parts.
SB_GETRECT
Retrieves the bounding rectangle of a part in a status window.
SB_GETTEXT
The SB_GETTEXT message retrieves the text from the specified part of a status window.
SB_GETTEXTLENGTH
The SB_GETTEXTLENGTH message retrieves the length, in characters, of the text from the specified
part of a status window.
SB_GETTIPTEXT
Retrieves the ToolTip text for a part in a status bar. The status bar must be created with the
SBT_TOOLTIPS style to enable ToolTips.
SB_GETUNICODEFORMAT
Retrieves the Unicode character format flag for the control.
SB_ISSIMPLE
Checks a status bar control to determine if it is in simple mode.
SB_SETBKCOLOR
Sets the background color in a status bar.
SB_SETICON
Sets the icon for a part in a status bar.
SB_SETMINHEIGHT
Sets the minimum height of a status windows drawing area.
SB_SETPARTS
Sets the number of parts in a status window and the coordinate of the right edge of each part.
SB_SETTEXT
The SB_SETTEXT message sets the text in the specified part of a status window.
SB_SETTIPTEXT
Sets the ToolTip text for a part in a status bar. The status bar must have been created with
the SBT_TOOLTIPS style to enable ToolTips.
SB_SETUNICODEFORMAT
Sets the Unicode character format flag for the control. This message allows you to change the
character set used by the control at run time rather than having to re-create the control.
SB_SIMPLE
Specifies whether a status window displays simple text or displays all window parts set by a
previous SB_SETPARTS message.
Notifications
=============
NM_CLICK (status bar)
Notifies the parent window of a status bar control that the user has clicked the left mouse
button within the control. NM_CLICK (status bar) is sent in the form of a WM_NOTIFY message.
NM_DBLCLK (status bar)
Notifies the parent window of a a status bar control that the user has double-clicked the
left mouse button within the control. This notification is sent in the form of a WM_NOTIFY message.
NM_RCLICK (status bar)
Notifies the parent window of a status bar control that the user has clicked the right mouse
button within the control. This notification is sent in the form of a WM_NOTIFY message.
NM_RDBLCLK (status bar)
Notifies the parent windows of a status bar control that the user has double-clicked the right
mouse button within the control. NM_RDBLCLK (status bar) is sent in the form of a WM_NOTIFY message.
SBN_SIMPLEMODECHANGE
Sent by a status bar control when the simple mode changes due to a SB_SIMPLE message.
This notification is sent in the form of a WM_NOTIFY message.
Styles
======
SBARS_SIZEGRIP
The status bar control will include a sizing grip at the right end of the status bar.
A sizing grip is similar to a sizing border; it is a rectangular area that the user can click and
drag to resize the parent window.
SBT_TOOLTIPS
Version 4.71.Use this style to enable ToolTips.
SBARS_TOOLTIPS
Version 5.80.Identical to SBT_TOOLTIPS. Use this flag for versions 5.00 or later.
#endif
/*----------------------------------------------------------------------*/

64
harbour/contrib/gtwvg/static.prg
View File

@@ -316,67 +316,3 @@ METHOD WvgStatic:setCaption( xCaption, cDll )
ENDCASE
RETURN Self
/*----------------------------------------------------------------------*/
/* MSDN on Static Control */
/*----------------------------------------------------------------------*/
#if 0
Static Control Styles
Using Static Controls
This topic provides an example that uses a static control.
Messages
========
STM_GETICON
An application sends the STM_GETICON message to retrieve a handle to the icon associated
with a static control that has the SS_ICON style.
STM_GETIMAGE
An application sends an STM_GETIMAGE message to retrieve a handle to the image
(icon or bitmap) associated with a static control.
STM_SETICON
An application sends the STM_SETICON message to associate an icon with an icon control.
STM_SETIMAGE
An application sends an STM_SETIMAGE message to associate a new image with a static control.
Notifications
=============
STN_CLICKED
The STN_CLICKED notification message is sent when the user clicks a static control
that has the SS_NOTIFY style. The parent window of the control receives this
notification message through the WM_COMMAND message.
STN_DBLCLK
The STN_DBLCLK notification message is sent when the user double-clicks a static
control that has the SS_NOTIFY style. The parent window of the control receives this
notification message through the WM_COMMAND message.
STN_DISABLE
The STN_DISABLE notification message is sent when a static control is disabled.
The static control must have the SS_NOTIFY style to receive this notification message.
The parent window of the control receives this notification message through the WM_COMMAND message.
STN_ENABLE
The STN_ENABLE notification message is sent when a static control is enabled.
The static control must have the SS_NOTIFY style to receive this notification message.
The parent window of the control receives this notification message through the WM_COMMAND message.
WM_CTLCOLORSTATIC
A static control, or an edit control that is read-only or disabled, sends the
WM_CTLCOLORSTATIC message to its parent window when the control is about to be drawn.
By responding to this message, the parent window can use the specified device context
handle to set the text and background colors of the static control.
A window receives this message through its WindowProc function.
#endif
/*----------------------------------------------------------------------*/

314
harbour/contrib/gtwvg/tabpage.prg
View File

@@ -232,317 +232,3 @@ METHOD destroy() CLASS WvgTabPage
::wvgWindow:destroy()
RETURN NIL
/*----------------------------------------------------------------------*/
/* MSDN on TabPage Control */
/*----------------------------------------------------------------------*/
#if 0
Tab
This section contains information about the programming elements used with tab controls.
Overviews
About Tab Controls
A tab control is analogous to the dividers in a notebook or the labels in a file cabinet. By using a tab control, an application can define multiple pages for the same area of a window or dialog box.
Using Tab Controls
This topic contains two examples that use tab controls.
Macros
TabCtrl_AdjustRect
Calculates a tab control s display area given a window rectangle, or calculates the window rectangle that would correspond to a specified display area. You can use this macro or send the TCM_ADJUSTRECT message explicitly.
TabCtrl_DeleteAllItems
Removes all items from a tab control. You can use this macro or send the TCM_DELETEALLITEMS message explicitly.
TabCtrl_DeleteItem
Removes an item from a tab control. You can use this macro or send the TCM_DELETEITEM message explicitly.
TabCtrl_DeselectAll
Resets items in a tab control, clearing any that were set to the TCIS_BUTTONPRESSED state. You can use this macro or send the TCM_DESELECTALL message explicitly.
TabCtrl_GetCurFocus
Returns the index of the item that has the focus in a tab control. You can use this macro or send the TCM_GETCURFOCUS message explicitly.
TabCtrl_GetCurSel
Determines the currently selected tab in a tab control. You can use this macro or send the TCM_GETCURSEL message explicitly.
TabCtrl_GetExtendedStyle
Retrieves the extended styles that are currently in use for the tab control. You can use this macro or send the TCM_GETEXTENDEDSTYLE message explicitly.
TabCtrl_GetImageList
Retrieves the image list associated with a tab control. You can use this macro or send the TCM_GETIMAGELIST message explicitly.
TabCtrl_GetItem
Retrieves information about a tab in a tab control. You can use this macro or send the TCM_GETITEM message explicitly.
TabCtrl_GetItemCount
Retrieves the number of tabs in the tab control. You can use this macro or send the TCM_GETITEMCOUNT message explicitly.
TabCtrl_GetItemRect
Retrieves the bounding rectangle for a tab in a tab control. You can use this macro or send the TCM_GETITEMRECT message explicitly.
TabCtrl_GetRowCount
Retrieves the current number of rows of tabs in a tab control. You can use this macro or send the TCM_GETROWCOUNT message explicitly.
TabCtrl_GetToolTips
Retrieves the handle to the ToolTip control associated with a tab control. You can use this macro or send the TCM_GETTOOLTIPS message explicitly.
TabCtrl_GetUnicodeFormat
Retrieves the UNICODE character format flag for the control. You can use this macro or send the TCM_GETUNICODEFORMAT message explicitly.
TabCtrl_HighlightItem
Sets the highlight state of a tab item. You can use this macro or send the TCM_HIGHLIGHTITEM message explicitly.
TabCtrl_HitTest
Determines which tab, if any, is at a specified screen position. You can use this macro or send the TCM_HITTEST message explicitly.
TabCtrl_InsertItem
Inserts a new tab in a tab control. You can use this macro or send the TCM_INSERTITEM message explicitly.
TabCtrl_RemoveImage
Removes an image from a tab control s image list. You can use this macro or send the TCM_REMOVEIMAGE message explicitly.
TabCtrl_SetCurFocus
Sets the focus to a specified tab in a tab control. You can use this macro or send the TCM_SETCURFOCUS message explicitly.
TabCtrl_SetCurSel
Selects a tab in a tab control. You can use this macro or send the TCM_SETCURSEL message explicitly.
TabCtrl_SetExtendedStyle
Sets the extended styles that the tab control will use. You can use this macro or send the TCM_SETEXTENDEDSTYLE message explicitly.
TabCtrl_SetImageList
Assigns an image list to a tab control. You can use this macro or send the TCM_SETIMAGELIST message explicitly.
TabCtrl_SetItem
Sets some or all of a tab s attributes. You can use this macro or send the TCM_SETITEM message explicitly.
TabCtrl_SetItemExtra
Sets the number of bytes per tab reserved for application-defined data in a tab control. You can use this macro or send the TCM_SETITEMEXTRA message explicitly.
TabCtrl_SetItemSize
Sets the width and height of tabs in a fixed-width or owner-drawn tab control. You can use this macro or send the TCM_SETITEMSIZE message explicitly.
TabCtrl_SetMinTabWidth
Sets the minimum width of items in a tab control. You can use this macro or send the TCM_SETMINTABWIDTH message explicitly.
TabCtrl_SetPadding
Sets the amount of space (padding) around each tab s icon and label in a tab control. You can use this macro or send the TCM_SETPADDING message explicitly.
TabCtrl_SetToolTips
Assigns a ToolTip control to a tab control. You can use this macro or send the TCM_SETTOOLTIPS message explicitly.
TabCtrl_SetUnicodeFormat
Sets the Unicode character format flag for the control. This message allows you to change the character set used by the control at run time rather than having to re-create the control. You can use this macro or send the TCM_SETUNICODEFORMAT message explicitly.
Messages
TCM_ADJUSTRECT
Calculates a tab control s display area given a window rectangle, or calculates the window rectangle that would correspond to a specified display area. You can send this message explicitly or by using the TabCtrl_AdjustRect macro.
TCM_DELETEALLITEMS
Removes all items from a tab control. You can send this message explicitly or by using the TabCtrl_DeleteAllItems macro.
TCM_DELETEITEM
Removes an item from a tab control. You can send this message explicitly or by using the TabCtrl_DeleteItem macro.
TCM_DESELECTALL
Resets items in a tab control, clearing any that were set to the TCIS_BUTTONPRESSED state. You can send this message explicitly or by using the TabCtrl_DeselectAll macro.
TCM_GETCURFOCUS
Returns the index of the item that has the focus in a tab control. You can send this message explicitly or by using the TabCtrl_GetCurFocus macro.
TCM_GETCURSEL
Determines the currently selected tab in a tab control. You can send this message explicitly or by using the TabCtrl_GetCurSel macro.
TCM_GETEXTENDEDSTYLE
Retrieves the extended styles that are currently in use for the tab control. You can send this message explicitly or by using the TabCtrl_GetExtendedStyle macro.
TCM_GETIMAGELIST
Retrieves the image list associated with a tab control. You can send this message explicitly or by using the TabCtrl_GetImageList macro.
TCM_GETITEM
Retrieves information about a tab in a tab control. You can send this message explicitly or by using the TabCtrl_GetItem macro.
TCM_GETITEMCOUNT
Retrieves the number of tabs in the tab control. You can send this message explicitly or by using the TabCtrl_GetItemCount macro.
TCM_GETITEMRECT
Retrieves the bounding rectangle for a tab in a tab control. You can send this message explicitly or by using the TabCtrl_GetItemRect macro.
TCM_GETROWCOUNT
Retrieves the current number of rows of tabs in a tab control. You can send this message explicitly or by using the TabCtrl_GetRowCount macro.
TCM_GETTOOLTIPS
Retrieves the handle to the ToolTip control associated with a tab control. You can send this message explicitly or by using the TabCtrl_GetToolTips macro.
TCM_GETUNICODEFORMAT
Retrieves the Unicode character format flag for the control. You can send this message explicitly or use the TabCtrl_GetUnicodeFormat macro.
TCM_HIGHLIGHTITEM
Sets the highlight state of a tab item. You can send this message explicitly or by using the TabCtrl_HighlightItem macro.
TCM_HITTEST
Determines which tab, if any, is at a specified screen position. You can send this message explicitly or by using the TabCtrl_HitTest macro.
TCM_INSERTITEM
Inserts a new tab in a tab control. You can send this message explicitly or by using the TabCtrl_InsertItem macro.
TCM_REMOVEIMAGE
Removes an image from a tab control s image list. You can send this message explicitly or by using the TabCtrl_RemoveImage macro.
TCM_SETCURFOCUS
Sets the focus to a specified tab in a tab control. You can send this message explicitly or by using the TabCtrl_SetCurFocus macro.
TCM_SETCURSEL
Selects a tab in a tab control. You can send this message explicitly or by using the TabCtrl_SetCurSel macro.
TCM_SETEXTENDEDSTYLE
Sets the extended styles that the tab control will use. You can send this message explicitly or by using the TabCtrl_SetExtendedStyle macro.
TCM_SETIMAGELIST
Assigns an image list to a tab control. You can send this message explicitly or by using the TabCtrl_SetImageList macro.
TCM_SETITEM
Sets some or all of a tab s attributes. You can send this message explicitly or by using the TabCtrl_SetItem macro.
TCM_SETITEMEXTRA
Sets the number of bytes per tab reserved for application-defined data in a tab control. You can send this message explicitly or by using the TabCtrl_SetItemExtra macro.
TCM_SETITEMSIZE
Sets the width and height of tabs in a fixed-width or owner-drawn tab control. You can send this message explicitly or by using the TabCtrl_SetItemSize macro.
TCM_SETMINTABWIDTH
Sets the minimum width of items in a tab control. You can send this message explicitly or by using the TabCtrl_SetMinTabWidth macro.
TCM_SETPADDING
Sets the amount of space (padding) around each tab s icon and label in a tab control. You can send this message explicitly or by using the TabCtrl_SetPadding macro.
TCM_SETTOOLTIPS
Assigns a ToolTip control to a tab control. You can send this message explicitly or by using the TabCtrl_SetToolTips macro.
TCM_SETUNICODEFORMAT
Sets the Unicode character format flag for the control. This message allows you to change the character set used by the control at run time rather than having to re-create the control. You can send this message explicitly or use the TabCtrl_SetUnicodeFormat macro.
Notifications
NM_CLICK (tab)
Notifies the parent window of a tab control that the user has clicked the left mouse button within the control. NM_CLICK (tab) is sent in the form of a WM_NOTIFY message.
NM_DBLCLK (tab)
Notifies a parent window of a tab control that the user has double-clicked the left mouse button within the control. This notification is sent in the form of a WM_NOTIFY message.
NM_RCLICK (tab)
Notifies the parent window of a tab control that the user has clicked the right mouse button within the control. NM_RCLICK (tab) is sent in the form of a WM_NOTIFY message.
NM_RDBLCLK (tab)
Notifies the parent window of a tab control that the user has double-clicked the right mouse button within the control. NM_RDBLCLK (tab) is sent in the form of a WM_NOTIFY message.
NM_RELEASEDCAPTURE (tab)
Notifies a tab control s parent window that the control is releasing mouse capture. This notification is sent in the form of a WM_NOTIFY message.
TCN_FOCUSCHANGE
Notifies a tab control s parent window that the button focus has changed.
TCN_GETOBJECT
Sent by a tab control when it has the TCS_EX_REGISTERDROP extended style and an object is dragged over a tab item in the control. This notification message is sent in the form of a WM_NOTIFY message.
TCN_KEYDOWN
Notifies a tab control s parent window that a key has been pressed. This message is sent in the form of a WM_NOTIFY message.
TCN_SELCHANGE
Notifies a tab control s parent window that the currently selected tab has changed. This message is sent in the form of a WM_NOTIFY message.
TCN_SELCHANGING
Notifies a tab control s parent window that the currently selected tab is about to change. This message is sent in the form of a WM_NOTIFY message.
Structures
NMTCKEYDOWN
Contains information about a key press in a tab control. It is used with the TCN_KEYDOWN notification message. This structure supersedes the TC_KEYDOWN structure.
TCHITTESTINFO
Contains information about a hit test. This structure supersedes the TC_HITTESTINFO structure.
TCITEM
Specifies or receives the attributes of a tab item. It is used with the TCM_INSERTITEM, TCM_GETITEM, and TCM_SETITEM messages. This structure supersedes the TC_ITEM structure.
TCITEMHEADER
Specifies or receives the attributes of a tab. It is used with the TCM_INSERTITEM, TCM_GETITEM, and TCM_SETITEM messages. This structure supersedes the TC_ITEMHEADER structure.
Constants
Tab Control Extended Styles
The tab control now supports extended styles. These styles are manipulated using the TCM_GETEXTENDEDSTYLE and TCM_SETEXTENDEDSTYLE messages and should not be confused with extended window styles that are passed to CreateWindowEx.
Tab Control Item States
Tab control items now support an item state to support the TCM_DESELECTALL message. Additionally, the TCITEM structure supports item state values.
Tab Control Styles
This section lists supported tab control styles.
TCS_BOTTOM
Version 4.70. Tabs appear at the bottom of the control. This value equals TCS_RIGHT. This style is not supported if you use ComCtl32.dll version 6.
TCS_BUTTONS
Tabs appear as buttons, and no border is drawn around the display area.
TCS_FIXEDWIDTH
All tabs are the same width. This style cannot be combined with the TCS_RIGHTJUSTIFY style.
TCS_FLATBUTTONS
Version 4.71. Selected tabs appear as being indented into the background while other tabs appear as being on the same plane as the background. This style only affects tab controls with the TCS_BUTTONS style.
TCS_FOCUSNEVER
The tab control does not receive the input focus when clicked.
TCS_FOCUSONBUTTONDOWN
The tab control receives the input focus when clicked.
TCS_FORCEICONLEFT
Icons are aligned with the left edge of each fixed-width tab. This style can only be used with the TCS_FIXEDWIDTH style.
TCS_FORCELABELLEFT
Labels are aligned with the left edge of each fixed-width tab; that is, the label is displayed immediately to the right of the icon instead of being centered. This style can only be used with the TCS_FIXEDWIDTH style, and it implies the TCS_FORCEICONLEFT style.
TCS_HOTTRACK
Version 4.70. Items under the pointer are automatically highlighted. You can check whether or not hot tracking is enabled by calling SystemParametersInfo.
TCS_MULTILINE
Multiple rows of tabs are displayed, if necessary, so all tabs are visible at once.
TCS_MULTISELECT
Version 4.70. Multiple tabs can be selected by holding down the CTRL key when clicking. This style must be used with the TCS_BUTTONS style.
TCS_OWNERDRAWFIXED
The parent window is responsible for drawing tabs.
TCS_RAGGEDRIGHT
Rows of tabs will not be stretched to fill the entire width of the control. This style is the default.
TCS_RIGHT
Version 4.70. Tabs appear vertically on the right side of controls that use the TCS_VERTICAL style. This value equals TCS_BOTTOM. This style is not supported if you use visual styles.
TCS_RIGHTJUSTIFY
The width of each tab is increased, if necessary, so that each row of tabs fills the entire width of the tab control. This window style is ignored unless the TCS_MULTILINE style is also specified.
TCS_SCROLLOPPOSITE
Version 4.70. Unneeded tabs scroll to the opposite side of the control when a tab is selected.
TCS_SINGLELINE
Only one row of tabs is displayed. The user can scroll to see more tabs, if necessary. This style is the default.
TCS_TABS
Tabs appear as tabs, and a border is drawn around the display area. This style is the default.
TCS_TOOLTIPS
The tab control has a ToolTip control associated with it.
TCS_VERTICAL
Version 4.70. Tabs appear at the left side of the control, with tab text displayed vertically. This style is valid only when used with the TCS_MULTILINE style. To make tabs appear on the right side of the control, also use the TCS_RIGHT style. This style is not supported if you use ComCtl32.dll version 6.
Remarks
The following styles can be modified after the control is created.
TCS_BOTTOM
TCS_BUTTONS
TCS_FIXEDWIDTH
TCS_FLATBUTTONS
TCS_FORCEICONLEFT
TCS_FORCELABELLEFT
TCS_MULTILINE
TCS_OWNERDRAWFIXED
TCS_RAGGEDRIGHT
TCS_RIGHT
TCS_VERTICAL
#endif

595
harbour/contrib/gtwvg/toolbar.prg
View File

@@ -502,598 +502,3 @@ METHOD WvgToolBarButton:new( cCaption, nStyle, cKey )
::key := cKey
RETURN Self
/*----------------------------------------------------------------------*/
/* MSDN on ToolBar Control */
/*----------------------------------------------------------------------*/
#if 0
MESSAGES
========
TB_ADDBITMAP
Adds one or more images to the list of button images available for a toolbar.
TB_ADDBUTTONS
Adds one or more buttons to a toolbar.
TB_ADDSTRING
Adds a new string to the toolbars string pool.
TB_AUTOSIZE
Causes a toolbar to be resized.
TB_BUTTONCOUNT
Retrieves a count of the buttons currently in the toolbar.
TB_BUTTONSTRUCTSIZE
Specifies the size of the TBBUTTON structure.
TB_CHANGEBITMAP
Changes the bitmap for a button in a toolbar.
TB_CHECKBUTTON
Checks or unchecks a given button in a toolbar.
TB_COMMANDTOINDEX
Retrieves the zero-based index for the button associated with the specified command identifier.
TB_CUSTOMIZE
Displays the Customize Toolbar dialog box.
TB_DELETEBUTTON
Deletes a button from the toolbar.
TB_ENABLEBUTTON
Enables or disables the specified button in a toolbar.
TB_GETANCHORHIGHLIGHT
Retrieves the anchor highlight setting for a toolbar.
TB_GETBITMAP
Retrieves the index of the bitmap associated with a button in a toolbar.
TB_GETBITMAPFLAGS
Retrieves the flags that describe the type of bitmap to be used.
TB_GETBUTTON
Retrieves information about the specified button in a toolbar.
TB_GETBUTTONINFO
Retrieves extended information for a button in a toolbar.
TB_GETBUTTONSIZE
Retrieves the current width and height of toolbar buttons, in pixels.
TB_GETBUTTONTEXT
Retrieves the display text of a button on a toolbar.
TB_GETCOLORSCHEME
Retrieves the color scheme information from the toolbar control.
TB_GETDISABLEDIMAGELIST
Retrieves the image list that a toolbar control uses to display inactive buttons.
TB_GETEXTENDEDSTYLE
Retrieves the extended styles for a toolbar control.
TB_GETHOTIMAGELIST
Retrieves the image list that a toolbar control uses to display hot buttons.
TB_GETHOTITEM
Retrieves the index of the hot item in a toolbar.
TB_GETIDEALSIZE
Gets the ideal size of the toolbar.
TB_GETIMAGELIST
Retrieves the image list that a toolbar control uses to display buttons in their default state.
A toolbar control uses this image list to display buttons when they are not hot or disabled.
TB_GETIMAGELISTCOUNT
Gets the number of image lists associated with the toolbar.
TB_GETINSERTMARK
Retrieves the current insertion mark for the toolbar.
TB_GETINSERTMARKCOLOR
Retrieves the color used to draw the insertion mark for the toolbar.
TB_GETITEMDROPDOWNRECT
Gets the bounding rectangle of the dropdown window for a toolbar item with style BTNS_DROPDOWN.
TB_GETITEMRECT
Retrieves the bounding rectangle of a button in a toolbar.
TB_GETMAXSIZE
Retrieves the total size of all of the visible buttons and separators in the toolbar.
TB_GETMETRICS
Retrieves the metrics of a toolbar control.
TB_GETOBJECT
Retrieves the IDropTarget for a toolbar control.
TB_GETPADDING
Retrieves the padding for a toolbar control.
TB_GETPRESSEDIMAGELIST
Gets the image list that a toolbar control uses to display buttons in a pressed state.
TB_GETRECT
Retrieves the bounding rectangle for a specified toolbar button.
TB_GETROWS
Retrieves the number of rows of buttons in a toolbar with the TBSTYLE_WRAPABLE style.
TB_GETSTATE
Retrieves information about the state of the specified button in a toolbar, such as whether it
is enabled, pressed, or checked.
TB_GETSTRING
Retrieves a string from a toolbars string pool.
TB_GETSTYLE
Retrieves the styles currently in use for a toolbar control.
TB_GETTEXTROWS
Retrieves the maximum number of text rows that can be displayed on a toolbar button.
TB_GETTOOLTIPS
Retrieves the handle to the ToolTip control, if any, associated with the toolbar.
TB_GETUNICODEFORMAT
Retrieves the Unicode character format flag for the control.
TB_HIDEBUTTON
Hides or shows the specified button in a toolbar.
TB_HITTEST
Determines where a point lies in a toolbar control.
TB_INDETERMINATE
Sets or clears the indeterminate state of the specified button in a toolbar.
TB_INSERTBUTTON
Inserts a button in a toolbar.
TB_INSERTMARKHITTEST
Retrieves the insertion mark information for a point in a toolbar.
TB_ISBUTTONCHECKED
Determines whether the specified button in a toolbar is checked.
TB_ISBUTTONENABLED
Determines whether the specified button in a toolbar is enabled.
TB_ISBUTTONHIDDEN
Determines whether the specified button in a toolbar is hidden.
TB_ISBUTTONHIGHLIGHTED
Checks the highlight state of a toolbar button.
TB_ISBUTTONINDETERMINATE
Determines whether the specified button in a toolbar is indeterminate.
TB_ISBUTTONPRESSED
Determines whether the specified button in a toolbar is pressed.
TB_LOADIMAGES
Loads system-defined button images into a toolbar controls image list.
TB_MAPACCELERATOR
Determines the ID of the button that corresponds to the specified accelerator character.
TB_MARKBUTTON
Sets the highlight state of a given button in a toolbar control.
TB_MOVEBUTTON
Moves a button from one index to another.
TB_PRESSBUTTON
Presses or releases the specified button in a toolbar.
TB_REPLACEBITMAP
Replaces an existing bitmap with a new bitmap.
TB_SAVERESTORE
Send this message to initiate saving or restoring a toolbar state.
TB_SETANCHORHIGHLIGHT
Sets the anchor highlight setting for a toolbar.
TB_SETBITMAPSIZE
Sets the size of the bitmapped images to be added to a toolbar.
TB_SETBUTTONINFO
Sets the information for an existing button in a toolbar.
TB_SETBUTTONSIZE
Sets the size of buttons on a toolbar.
TB_SETBUTTONWIDTH
Sets the minimum and maximum button widths in the toolbar control.
TB_SETCMDID
Sets the command identifier of a toolbar button.
TB_SETCOLORSCHEME
Sets the color scheme information for the toolbar control.
TB_SETDISABLEDIMAGELIST
Sets the image list that the toolbar control will use to display disabled buttons.
TB_SETDRAWTEXTFLAGS
Sets the text drawing flags for the toolbar.
TB_SETEXTENDEDSTYLE
Sets the extended styles for a toolbar control.
TB_SETHOTIMAGELIST
Sets the image list that the toolbar control will use to display hot buttons.
TB_SETHOTITEM
Sets the hot item in a toolbar.
TB_SETHOTITEM2
Sets the hot item in a toolbar.
TB_SETIMAGELIST
Sets the image list that the toolbar uses to display buttons that are in their default state.
TB_SETINDENT
Sets the indentation for the first button in a toolbar control.
TB_SETINSERTMARK
Sets the current insertion mark for the toolbar.
TB_SETINSERTMARKCOLOR
Sets the color used to draw the insertion mark for the toolbar.
TB_SETLISTGAP
Sets the distance between the toolbar buttons on a specific toolbar.
TB_SETMAXTEXTROWS
Sets the maximum number of text rows displayed on a toolbar button.
TB_SETMETRICS
Sets the metrics of a toolbar control.
TB_SETPADDING
Sets the padding for a toolbar control.
TB_SETPARENT
Sets the window to which the toolbar control sends notification messages.
TB_SETPRESSEDIMAGELIST
Sets the image list that the toolbar uses to display buttons that are in a pressed state.
TB_SETROWS
Sets the number of rows of buttons in a toolbar.
TB_SETSTATE
Sets the state for the specified button in a toolbar.
TB_SETSTYLE
Sets the style for a toolbar control.
TB_SETTOOLTIPS
Associates a ToolTip control with a toolbar.
TB_SETUNICODEFORMAT
Sets the Unicode character format flag for the control. This message allows you to change the
character set used by the control at run time rather than having to re-create the control.
TB_SETWINDOWTHEME
Sets the visual style of a toolbar control.
TB_TRANSLATEACCELERATOR
Passes a keyboard message to the toolbar.
NOTIFICATIONS
=============
NM_CHAR (toolbar)
Sent by the toolbar when it receives a WM_CHAR message. This notification message is sent
in the form of a WM_NOTIFY message.
NM_CLICK (toolbar)
Sent by a toolbar control when the user clicks an item with the left mouse button.
This notification message is sent in the form of a WM_NOTIFY message.
NM_CUSTOMDRAW (toolbar)
Sent by the toolbar to notify its parent window about drawing operations. This notification
is sent in the form of a WM_NOTIFY message.
NM_DBLCLK (toolbar)
Notifies the parent window of a toolbar control that the user has double-clicked the left
mouse button within the control. This notification is sent in the form of a WM_NOTIFY message.
NM_KEYDOWN (toolbar)
Sent by a control when the control has the keyboard focus and the user presses a key.
This notification message is sent in the form of a WM_NOTIFY message.
NM_LDOWN
Notifies a toolbars parent window that the left mouse button has been pressed.
NM_RCLICK (toolbar)
Sent by a toolbar control when the user clicks the toolbar with the right mouse button.
This notification message is sent in the form of a WM_NOTIFY message.
NM_RDBLCLK (toolbar)
Notifies a control s parent window that the user has double-clicked the right mouse button
within the control. NM_RDBLCLK (toolbar) is sent in the form of a WM_NOTIFY message.
NM_RELEASEDCAPTURE (toolbar)
Notifies a toolbar control s parent window that the control is releasing mouse capture.
This notification is sent in the form of a WM_NOTIFY message.
NM_TOOLTIPSCREATED (toolbar)
Notifies a toolbar s parent window that the toolbar has created a ToolTip control.
This notification is sent in the form of a WM_NOTIFY message.
TBN_BEGINADJUST
Notifies a toolbar s parent window that the user has begun customizing a toolbar.
This message is sent in the form of a WM_NOTIFY message.
TBN_BEGINDRAG
Notifies a toolbar s parent window that the user has begun dragging a button in a toolbar.
This message is sent in the form of a WM_NOTIFY message.
TBN_CUSTHELP
Notifies a toolbar s parent window that the user has chosen the Help button in the
Customize Toolbar dialog box. This message is sent in the form of a WM_NOTIFY message.
TBN_DELETINGBUTTON
Sent by a toolbar control when a button is about to be deleted.
TBN_DRAGOUT
Sent by a toolbar control when the user clicks a button and then moves the cursor off the button.
This notification message is sent in the form of a WM_NOTIFY message.
TBN_DRAGOVER
Ascertains whether a TB_MARKBUTTON message should be sent for a button that is being dragged over..
TBN_DROPDOWN
Sent by a toolbar control when the user clicks a dropdown button.
This notification message is sent in the form of a WM_NOTIFY message.
TBN_DUPACCELERATOR
Ascertains whether an accelerator key can be used on two or more active toolbars.
TBN_ENDADJUST
Notifies a toolbar s parent window that the user has stopped customizing a toolbar.
This message is sent in the form of a WM_NOTIFY message.
TBN_ENDDRAG
Notifies the toolbar s parent window that the user has stopped dragging a button in a toolbar.
This message is sent in the form of a WM_NOTIFY message.
TBN_GETBUTTONINFO
Retrieves toolbar customization information and notifies the toolbar s parent window of any
changes being made to the toolbar. This is sent in the form of a WM_NOTIFY message.
TBN_GETDISPINFO
Retrieves display information for a toolbar item. This notification is sent in the form of a
WM_NOTIFY message.
TBN_GETINFOTIP
Retrieves infotip information for a toolbar item. This notification is sent in the form of a
WM_NOTIFY message.
TBN_GETOBJECT
Sent by a toolbar control that uses the TBSTYLE_REGISTERDROP style to request a drop target
object when the pointer passes over one of its buttons.
TBN_HOTITEMCHANGE
Sent by a toolbar control when the hot (highlighted) item changes. This notification message
is sent in the form of a WM_NOTIFY message.
TBN_INITCUSTOMIZE
Notifies a toolbar s parent window that customizing has started.
TBN_MAPACCELERATOR
Requests the index of the button in the toolbar corresponding to the specified accelerator character.
TBN_QUERYDELETE
Notifies the toolbar s parent window whether a button may be deleted from a toolbar while the
user is customizing the toolbar. This message is sent in the form of a WM_NOTIFY message.
TBN_QUERYINSERT
Notifies the toolbar s parent window whether a button may be inserted to the left of the
specified button while the user is customizing a toolbar. This message is sent in the form of a
WM_NOTIFY message.
TBN_RESET
Notifies the toolbar s parent window that the user has reset the content of the Customize
Toolbar dialog box. This message is sent in the form of a WM_NOTIFY message.
TBN_RESTORE
Notifies a toolbar s parent window that a toolbar is in the process of being restored.
TBN_SAVE
Notifies a toolbar s parent window that a toolbar is in the process of being saved.
TBN_TOOLBARCHANGE
Notifies the toolbar s parent window that the user has customized a toolbar. This message is sent
in the form of a WM_NOTIFY message.
TBN_WRAPACCELERATOR
Requests the index of the button in one or more toolbars corresponding to the specified accelerator
character.
TBN_WRAPHOTITEM
Notifies an application with two or more toolbars that the hot item is about to change.
BUTTON STATES
=============
TBSTATE_CHECKED
The button has the TBSTYLE_CHECK style and is being clicked.
TBSTATE_ELLIPSES
Version 4.70. The button s text is cut off and an ellipsis is displayed.
TBSTATE_ENABLED
The button accepts user input. A button that doesn t have this state is grayed.
TBSTATE_HIDDEN
The button is not visible and cannot receive user input.
TBSTATE_INDETERMINATE
The button is grayed.
TBSTATE_MARKED
Version 4.71. The button is marked. The interpretation of a marked item is dependent upon the application.
TBSTATE_PRESSED
The button is being clicked.
TBSTATE_WRAP
The button is followed by a line break. The button must also have the TBSTATE_ENABLED state.
STYLES
======
TBSTYLE_ALTDRAG
Allows users to change a toolbar button s position by dragging it while holding down the ALT key.
If this style is not specified, the user must hold down the SHIFT key while dragging a button. Note
that the CCS_ADJUSTABLE style must be specified to enable toolbar buttons to be dragged.
TBSTYLE_CUSTOMERASE
Version 4.70. Generates NM_CUSTOMDRAW notification messages when the toolbar processes
WM_ERASEBKGND messages.
TBSTYLE_FLAT
Version 4.70. Creates a flat toolbar. In a flat toolbar, both the toolbar and the buttons are
transparent and hot-tracking is enabled. Button text appears under button bitmaps. To prevent
repainting problems, this style should be set before the toolbar control becomes visible.
TBSTYLE_LIST
Version 4.70. Creates a flat toolbar with button text to the right of the bitmap. Otherwise,
this style is identical to TBSTYLE_FLAT. To prevent repainting problems, this style should be set
before the toolbar control becomes visible.
TBSTYLE_REGISTERDROP
Version 4.71. Generates TBN_GETOBJECT notification messages to request drop target objects
when the cursor passes over toolbar buttons.
TBSTYLE_TOOLTIPS
Creates a ToolTip control that an application can use to display descriptive text for
the buttons in the toolbar.
TBSTYLE_TRANSPARENT
Version 4.71. Creates a transparent toolbar. In a transparent toolbar, the toolbar is transparent
but the buttons are not. Button text appears under button bitmaps. To prevent repainting problems,
this style should be set before the toolbar control becomes visible.
TBSTYLE_WRAPABLE
Creates a toolbar that can have multiple lines of buttons. Toolbar buttons can "wrap" to
the next line when the toolbar becomes too narrow to include all buttons on the same line.
When the toolbar is wrapped, the break will occur on either the rightmost separator or the rightmost
button if there are no separators on the bar. This style must be set to display a vertical toolbar
control when the toolbar is part of a vertical rebar control. This style cannot be combined with CCS_VERT.
BUTTONS
=======
Note: A toolbar button can have a combination of the following styles. To specify a button style,
set the appropriate flags in the fsStyle member of the button s TBBUTTON structure. Not all styles
can be combined.
For Shell version 4.72 and earlier, both window and button style flags had the form TBSTYLE_XXX.
If you are compiling an application with version 4.72 or earlier of Commctrl.h, you must
use the TBSTYLE_XXX button style flags. For version 5.80 and later, all button styles have
the form BTNS_XXX. All of the TBSTYLE_XXX values have equivalent BTNS_XXX values,
with the same meaning and numerical value. For convenience, both forms are given in the following table.
BTNS_AUTOSIZE
Version 5.80. Specifies that the toolbar control should not assign the standard width to
the button. Instead, the button s width will be calculated based on the width of the text
plus the image of the button. Use the equivalent style flag, TBSTYLE_AUTOSIZE,
for version 4.72 and earlier.
BTNS_BUTTON
Version 5.80. Creates a standard button. Use the equivalent style flag, TBSTYLE_BUTTON,
for version 4.72 and earlier. This flag is defined as 0, and should be used to signify that no
other flags are set.
BTNS_CHECK
Version 5.80. Creates a dual-state push button that toggles between the pressed and nonpressed
states each time the user clicks it. The button has a different background color when it is in
the pressed state. Use the equivalent style flag, TBSTYLE_CHECK, for version 4.72 and earlier.
BTNS_CHECKGROUP
Version 5.80. Creates a button that stays pressed until another button in the group is pressed,
similar to option buttons (also known as radio buttons). It is equivalent to combining
BTNS_CHECK and BTNS_GROUP. Use the equivalent style flag, TBSTYLE_CHECKGROUP,
for version 4.72 and earlier.
BTNS_DROPDOWN
Version 5.80. Creates a drop-down style button that can display a list when the button is clicked.
Instead of the WM_COMMAND message used for normal buttons, drop-down buttons send a TBN_DROPDOWN
notification. An application can then have the notification handler display a list of options.
Use the equivalent style flag, TBSTYLE_DROPDOWN, for version 4.72 and earlier.
If the toolbar has the TBSTYLE_EX_DRAWDDARROWS extended style, drop-down buttons will have a
drop-down arrow displayed in a separate section to their right. If the arrow is clicked,
a TBN_DROPDOWN notification will be sent. If the associated button is clicked, a WM_COMMAND
message will be sent.
BTNS_GROUP
Version 5.80. When combined with BTNS_CHECK, creates a button that stays pressed until another
button in the group is pressed. Use the equivalent style flag, TBSTYLE_GROUP,
for version 4.72 and earlier.
BTNS_NOPREFIX
Version 5.80. Specifies that the button text will not have an accelerator prefix associated with it.
Use the equivalent style flag, TBSTYLE_NOPREFIX, for version 4.72 and earlier.
BTNS_SEP
Version 5.80. Creates a separator, providing a small gap between button groups. A button that has
this style does not receive user input. Use the equivalent style flag, TBSTYLE_SEP, for version 4.72
and earlier.
BTNS_SHOWTEXT
Version 5.81. Specifies that button text should be displayed. All buttons can have text,
but only those buttons with the BTNS_SHOWTEXT button style will display it. This button style must
be used with the TBSTYLE_LIST style and the TBSTYLE_EX_MIXEDBUTTONS extended style.
If you set text for buttons that do not have the BTNS_SHOWTEXT style, the toolbar control will
automatically display it as a ToolTip when the cursor hovers over the button. This feature allows
your application to avoid handling the TBN_GETINFOTIP or TTN_GETDISPINFO notification for the toolbar.
BTNS_WHOLEDROPDOWN
Version 5.80. Specifies that the button will have a drop-down arrow, but not as a separate section.
Buttons with this style behave the same, regardless of whether the TBSTYLE_EX_DRAWDDARROWS extended
style is set.
TBSTYLE_AUTOSIZE
Equivalent to BTNS_AUTOSIZE. Use TBSTYLE_AUTOSIZE for version 4.72 and earlier.
TBSTYLE_BUTTON
Equivalent to BTNS_BUTTON. Use TBSTYLE_BUTTON for version 4.72 and earlier.
TBSTYLE_CHECK
Equivalent to BTNS_CHECK. Use TBSTYLE_CHECK for version 4.72 and earlier.
TBSTYLE_CHECKGROUP
Equivalent to BTNS_CHECKGROUP. Use TBSTYLE_CHECKGROUP for version 4.72 and earlier.
TBSTYLE_DROPDOWN
Equivalent to BTNS_DROPDOWN. Use TBSTYLE_DROPDOWN for version 4.72 and earlier.
TBSTYLE_GROUP
Equivalent to BTNS_GROUP. Use TBSTYLE_GROUP for version 4.72 and earlier.
TBSTYLE_NOPREFIX
Equivalent to BTNS_NOPREFIX. Use TBSTYLE_NOPREFIX for version 4.72 and earlier.
TBSTYLE_SEP
Equivalent to BTNS_SEP. Use TBSTYLE_SEP for version 4.72 and earlier.
#endif
/*----------------------------------------------------------------------*/

846
harbour/contrib/gtwvg/treeview.prg
View File

@@ -493,849 +493,3 @@ METHOD getParentItem() CLASS WvgTreeViewItem
METHOD insItem() CLASS WvgTreeViewItem
RETURN NIL
/*----------------------------------------------------------------------*/
/* MSDN on TreeView Control */
/*----------------------------------------------------------------------*/
#if 0
Macros
TreeView_CreateDragImage
Creates a dragging bitmap for the specified item in a tree-view control. The macro also creates
an image list for the bitmap and adds the bitmap to the image list. An application can display
the image when dragging the item by using the image list functions. You can use this macro or send
the TVM_CREATEDRAGIMAGE message explicitly.
TreeView_DeleteAllItems
Deletes all items from a tree-view control.
TreeView_DeleteItem
Removes an item and all its children from a tree-view control. You can also send the
TVM_DELETEITEM message explicitly.
TreeView_EditLabel
Begins in-place editing of the specified item s text, replacing the text of the item with a
single-line edit control containing the text. This macro implicitly selects and focuses the
specified item. You can use this macro or send the TVM_EDITLABEL message explicitly.
TreeView_EndEditLabelNow
Ends the editing of a tree-view item s label. You can use this macro or send the
TVM_ENDEDITLABELNOW message explicitly.
TreeView_EnsureVisible
Ensures that a tree-view item is visible, expanding the parent item or scrolling the tree-view control, if necessary. You can use this macro or send the TVM_ENSUREVISIBLE message explicitly.
TreeView_Expand
The TreeView_Expand macro expands or collapses the list of child items associated with the
specified parent item, if any. You can use this macro or send the TVM_EXPAND message explicitly.
TreeView_GetBkColor
Retrieves the current background color of the control. You can use this macro or send the
TVM_GETBKCOLOR message explicitly.
TreeView_GetCheckState
Gets the check state of the specified item. You can also use the TVM_GETITEMSTATE message directly.
TreeView_GetChild
Retrieves the first child item of the specified tree-view item. You can use this macro, or
you can explicitly send the TVM_GETNEXTITEM message with the TVGN_CHILD flag.
TreeView_GetCount
Retrieves a count of the items in a tree-view control. You can use this macro or send the
TVM_GETCOUNT message explicitly.
TreeView_GetDropHilight
Retrieves the tree-view item that is the target of a drag-and-drop operation. You can use
this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_DROPHILITE flag.
TreeView_GetEditControl
Retrieves the handle to the edit control being used to edit a tree-view item s text.
You can use this macro or send the TVM_GETEDITCONTROL message explicitly.
TreeView_GetExtendedStyle
Retrieves the extended style for a specified tree-view control. Use this macro or send the
TVM_GETEXTENDEDSTYLE message explicitly.
TreeView_GetFirstVisible
Retrieves the first visible item in a tree-view control window. You can use this macro,
or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_FIRSTVISIBLE flag.
TreeView_GetImageList
Retrieves the handle to the normal or state image list associated with a tree-view control.
You can use this macro or send the TVM_GETIMAGELIST message explicitly.
TreeView_GetIndent
Retrieves the amount, in pixels, that child items are indented relative to their parent items.
You can use this macro or send the TVM_GETINDENT message explicitly.
TreeView_GetInsertMarkColor
Retrieves the color used to draw the insertion mark for the tree view.
You can use this macro or send the TVM_GETINSERTMARKCOLOR message explicitly.
TreeView_GetISearchString
Retrieves the incremental search string for a tree-view control.
The tree-view control uses the incremental search string to select an item based on characters
typed by the user. You can use this macro or send the TVM_GETISEARCHSTRING message explicitly.
TreeView_GetItem
Retrieves some or all of a tree-view item s attributes.
You can use this macro or send the TVM_GETITEM message explicitly.
TreeView_GetItemHeight
Retrieves the current height of the tree-view items.
You can use this macro or send the TVM_GETITEMHEIGHT message explicitly.
TreeView_GetItemPartRect
Retrieves the largest possible bounding rectangle that constitutes the "hit zone"
for a specified part of an item. Use this macro or send the TVM_GETITEMPARTRECT message explicitly.
TreeView_GetItemRect
Retrieves the bounding rectangle for a tree-view item and indicates whether the item is visible.
You can use this macro or send the TVM_GETITEMRECT message explicitly.
TreeView_GetItemState
Retrieves some or all of a tree-view item s state attributes.
You can use this macro or send the TVM_GETITEMSTATE message explicitly.
TreeView_GetLastVisible
Retrieves the last expanded item in a tree-view control. This does not retrieve the last item
visible in the tree-view window. You can use this macro, or
you can explicitly send the TVM_GETNEXTITEM message with the TVGN_LASTVISIBLE flag.
TreeView_GetLineColor
Gets the current line color. You can also use the TVM_GETLINECOLOR message directly.
TreeView_GetNextItem
Retrieves the tree-view item that bears the specified relationship to a specified item.
You can use this macro, use one of the TreeView_Get macros described below,
or send the TVM_GETNEXTITEM message explicitly.
TreeView_GetNextSelected
Retrieves the tree-view item that bears the TVGN_NEXTSELECTED relationship to a specified tree item.
TreeView_GetNextSibling
Retrieves the next sibling item of a specified item in a tree-view control.
You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_NEXT flag.
TreeView_GetNextVisible
Retrieves the next visible item that follows a specified item in a tree-view control.
You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_NEXTVISIBLE flag.
TreeView_GetParent
Retrieves the parent item of the specified tree-view item. You can use this macro,
or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_PARENT flag.
TreeView_GetPrevSibling
Retrieves the previous sibling item of a specified item in a tree-view control.
You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_PREVIOUS flag.
TreeView_GetPrevVisible
Retrieves the first visible item that precedes a specified item in a tree-view control.
You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_PREVIOUSVISIBLE flag.
TreeView_GetRoot
Retrieves the topmost or very first item of the tree-view control. You can use this macro, or
you can explicitly send the TVM_GETNEXTITEM message with the TVGN_ROOT flag.
TreeView_GetScrollTime
Retrieves the maximum scroll time for the tree-view control.
You can use this macro or send the TVM_GETSCROLLTIME message explicitly.
TreeView_GetSelectedCount
Not implemented.
TreeView_GetSelection
Retrieves the currently selected item in a tree-view control.
You can use this macro, or you can explicitly send the TVM_GETNEXTITEM message with the TVGN_CARET flag.
TreeView_GetTextColor
Retrieves the current text color of the control.
You can use this macro or send the TVM_GETTEXTCOLOR message explicitly.
TreeView_GetToolTips
Retrieves the handle to the child ToolTip control used by a tree-view control.
You can use this macro or send the TVM_GETTOOLTIPS message explicitly.
TreeView_GetUnicodeFormat
Retrieves the Unicode character format flag for the control.
You can use this macro or send the TVM_GETUNICODEFORMAT message explicitly.
TreeView_GetVisibleCount
Obtains the number of items that can be fully visible in the client window of a tree-view control.
You can use this macro or send the TVM_GETVISIBLECOUNT message explicitly.
TreeView_HitTest
Determines the location of the specified point relative to the client area of a tree-view control.
You can use this macro or send the TVM_HITTEST message explicitly.
TreeView_InsertItem
Inserts a new item in a tree-view control.
You can use this macro or send the TVM_INSERTITEM message explicitly.
TreeView_MapAccIDToHTREEITEM
Maps an accessibility ID to an HTREEITEM.
You can use this macro or send the TVM_MAPACCIDTOHTREEITEM message explicitly.
TreeView_MapHTREEITEMtoAccID
Maps an HTREEITEM to an accessibility ID.
You can use this macro or send the TVM_MAPHTREEITEMTOACCID message explicitly.
TreeView_Select
Selects the specified tree-view item, scrolls the item into view, or redraws the item in the
style used to indicate the target of a drag-and-drop operation.
You can use this macro or the TreeView_SelectItem, TreeView_SelectSetFirstVisible, or TreeView_SelectDropTarget macros, or you can send the TVM_SELECTITEM message explicitly.
TreeView_SelectDropTarget
Redraws a specified tree-view control item in the style used to indicate the target of a
drag-and-drop operation. You can use this macro or the TreeView_Select macro,
or you can send the TVM_SELECTITEM message explicitly.
TreeView_SelectItem
Selects the specified tree-view item.
You can use this macro or the TreeView_Select macro, or you can send the TVM_SELECTITEM message explicitly.
TreeView_SelectSetFirstVisible
Scrolls the tree-view control vertically to ensure that the specified item is visible.
If possible, the specified item becomes the first visible item at the top of the control s window.
You can use this macro or the TreeView_Select macro, or you can send the TVM_SELECTITEM message explicitly.
TreeView_SetAutoScrollInfo
Sets information used to determine auto-scroll characteristics.
Use this macro or send the TVM_SETAUTOSCROLLINFO message explicitly.
TreeView_SetBkColor
Sets the background color of the control.
You can use this macro or send the TVM_SETBKCOLOR message explicitly.
TreeView_SetCheckState
Sets the item s state image to "checked" or "unchecked."
You can also use the TVM_SETITEM message directly.
TreeView_SetExtendedStyle
Sets the extended style for a specified TreeView control.
Use this macro or send the TVM_SETEXTENDEDSTYLE message explicitly.
TreeView_SetImageList
Sets the normal or state image list for a tree-view control and redraws the control using the new images.
You can use this macro or send the TVM_SETIMAGELIST message explicitly.
TreeView_SetIndent
Sets the width of indentation for a tree-view control and redraws the control to reflect the new width.
You can use this macro or send the TVM_SETINDENT message explicitly.
TreeView_SetInsertMark
Sets the insertion mark in a tree-view control.
You can use this macro or send the TVM_SETINSERTMARK message explicitly.
TreeView_SetInsertMarkColor
Sets the color used to draw the insertion mark for the tree view.
You can use this macro or send the TVM_SETINSERTMARKCOLOR message explicitly.
TreeView_SetItem
The TreeView_SetItem macro sets some or all of a tree-view item s attributes.
You can use this macro or send the TVM_SETITEM message explicitly.
TreeView_SetItemHeight
Sets the height of the tree-view items.
You can use this macro or send the TVM_SETITEMHEIGHT message explicitly.
TreeView_SetItemState
Sets a tree-view item s state attributes.
You can use this macro or send the TVM_SETITEM message explicitly.
TreeView_SetLineColor
Sets the current line color. You can also use the TVM_SETLINECOLOR message directly.
TreeView_SetScrollTime
Sets the maximum scroll time for the tree-view control.
You can use this macro or send the TVM_SETSCROLLTIME message explicitly.
TreeView_SetTextColor
Sets the text color of the control. You can use this macro or send the TVM_SETTEXTCOLOR message explicitly.
TreeView_SetToolTips
Sets a tree-view control s child ToolTip control.
You can use this macro or send the TVM_SETTOOLTIPS message explicitly.
TreeView_SetUnicodeFormat
Sets the Unicode character format flag for the control.
This message allows you to change the character set used by the control at run time rather
than having to re-create the control. You can use this macro or send the TVM_SETUNICODEFORMAT message explicitly.
TreeView_ShowInfoTip
Shows the infotip for a specified item in a tree-view control.
Use this macro or send the TVM_SHOWINFOTIP message explicitly.
TreeView_SortChildren
Sorts the child items of the specified parent item in a tree-view control.
You can use this macro or send the TVM_SORTCHILDREN message explicitly.
TreeView_SortChildrenCB
Sorts tree-view items using an application-defined callback function that compares the items.
You can use this macro or send the TVM_SORTCHILDRENCB message explicitly.
Messages
========
TVM_CREATEDRAGIMAGE
Creates a dragging bitmap for the specified item in a tree-view control.
The message also creates an image list for the bitmap and adds the bitmap to the image list.
An application can display the image when dragging the item by using the image list functions.
You can send this message explicitly or by using the TreeView_CreateDragImage macro.
TVM_DELETEITEM
Removes an item and all its children from a tree-view control.
You can send this message explicitly or by using the TreeView_DeleteItem macro.
TVM_EDITLABEL
Begins in-place editing of the specified item s text, replacing the text of the item with a
single-line edit control containing the text. This message implicitly selects and focuses the specified
item. You can send this message explicitly or by using the TreeView_EditLabel macro.
TVM_ENDEDITLABELNOW
Ends the editing of a tree-view item s label.
You can send this message explicitly or by using the TreeView_EndEditLabelNow macro.
TVM_ENSUREVISIBLE
Ensures that a tree-view item is visible, expanding the parent item or scrolling the tree-view control,
if necessary. You can send this message explicitly or by using the TreeView_EnsureVisible macro.
TVM_EXPAND
The TVM_EXPAND message expands or collapses the list of child items associated with the
specified parent item, if any. You can send this message explicitly or by using the TreeView_Expand macro.
TVM_GETBKCOLOR
Retrieves the current background color of the control.
You can send this message explicitly or by using the TreeView_GetBkColor macro.
TVM_GETCOUNT
Retrieves a count of the items in a tree-view control.
You can send this message explicitly or by using the TreeView_GetCount macro.
TVM_GETEDITCONTROL
Retrieves the handle to the edit control being used to edit a tree-view item s text.
You can send this message explicitly or by using the TreeView_GetEditControl macro.
TVM_GETEXTENDEDSTYLE
Retrieves the extended style for a tree-view control.
Send this message explicitly or by using the TreeView_GetExtendedStyle macro.
TVM_GETIMAGELIST
Retrieves the handle to the normal or state image list associated with a tree-view control.
You can send this message explicitly or by using the TreeView_GetImageList macro.
TVM_GETINDENT
Retrieves the amount, in pixels, that child items are indented relative to their parent items.
You can send this message explicitly or by using the TreeView_GetIndent macro.
TVM_GETINSERTMARKCOLOR
Retrieves the color used to draw the insertion mark for the tree view.
You can send this message explicitly or by using the TreeView_GetInsertMarkColor macro.
TVM_GETISEARCHSTRING
Retrieves the incremental search string for a tree-view control. The tree-view control uses the
incremental search string to select an item based on characters typed by the user.
You can send this message explicitly or by using the TreeView_GetISearchString macro.
TVM_GETITEM
Retrieves some or all of a tree-view item s attributes.
You can send this message explicitly or by using the TreeView_GetItem macro.
TVM_GETITEMHEIGHT
Retrieves the current height of the each tree-view item.
You can send this message explicitly or by using the TreeView_GetItemHeight macro.
TVM_GETITEMPARTRECT
Not implemented.
TVM_GETITEMRECT
Retrieves the bounding rectangle for a tree-view item and indicates whether the item is visible. You can send this message explicitly or by using the TreeView_GetItemRect macro.
TVM_GETITEMSTATE
Retrieves some or all of a tree-view item s state attributes. You can send this message explicitly or by using the TreeView_GetItemState macro.
TVM_GETLINECOLOR
The TVM_GETLINECOLOR message gets the current line color.
TVM_GETNEXTITEM
Retrieves the tree-view item that bears the specified relationship to a specified item.
You can send this message explicitly, by using the TreeView_GetNextItem macro.
TVM_GETSCROLLTIME
Retrieves the maximum scroll time for the tree-view control.
You can send this message explicitly or by using the TreeView_GetScrollTime macro.
TVM_GETSELECTEDCOUNT
Not implemented.
TVM_GETTEXTCOLOR
Retrieves the current text color of the control.
You can send this message explicitly or by using the TreeView_GetTextColor macro.
TVM_GETTOOLTIPS
Retrieves the handle to the child ToolTip control used by a tree-view control.
You can send this message explicitly or by using the TreeView_GetToolTips macro.
TVM_GETUNICODEFORMAT
Retrieves the Unicode character format flag for the control.
You can send this message explicitly or use the TreeView_GetUnicodeFormat macro.
TVM_GETVISIBLECOUNT
Obtains the number of items that can be fully visible in the client window of a tree-view control.
You can send this message explicitly or by using the TreeView_GetVisibleCount macro.
TVM_HITTEST
Determines the location of the specified point relative to the client area of a tree-view control.
You can send this message explicitly or by using the TreeView_HitTest macro.
TVM_INSERTITEM
Inserts a new item in a tree-view control.
You can send this message explicitly or by using the TreeView_InsertItem macro.
TVM_MAPACCIDTOHTREEITEM
Maps an accessibility ID to an HTREEITEM.
TVM_MAPHTREEITEMTOACCID
Maps an HTREEITEM to an accessibility ID.
TVM_SELECTITEM
Selects the specified tree-view item, scrolls the item into view, or redraws the item in the
style used to indicate the target of a drag-and-drop operation.
You can send this message explicitly or by using the TreeView_Select, TreeView_SelectItem, or TreeView_SelectDropTarget macro.
TVM_SETAUTOSCROLLINFO
Sets information used to determine auto-scroll characteristics.
You can send this message explicitly or by using the TreeView_SetAutoScrollInfo macro.
TVM_SETBKCOLOR
Sets the background color of the control.
You can send this message explicitly or by using the TreeView_SetBkColor macro.
TVM_SETEXTENDEDSTYLE
Informs the tree-view control to set extended styles.
Send this message or use the macro TreeView_SetExtendedStyle.
TVM_SETIMAGELIST
Sets the normal or state image list for a tree-view control and redraws the control using the new images.
You can send this message explicitly or by using the TreeView_SetImageList macro.
TVM_SETINDENT
Sets the width of indentation for a tree-view control and redraws the control to reflect the new width.
You can send this message explicitly or by using the TreeView_SetIndent macro.
TVM_SETINSERTMARK
Sets the insertion mark in a tree-view control.
You can send this message explicitly or by using the TreeView_SetInsertMark macro.
TVM_SETINSERTMARKCOLOR
Sets the color used to draw the insertion mark for the tree view.
You can send this message explicitly or by using the TreeView_SetInsertMarkColor macro.
TVM_SETITEM
The TVM_SETITEM message sets some or all of a tree-view item s attributes.
You can send this message explicitly or by using the TreeView_SetItem macro.
TVM_SETITEMHEIGHT
Sets the height of the tree-view items.
You can send this message explicitly or by using the TreeView_SetItemHeight macro.
TVM_SETLINECOLOR
The TVM_SETLINECOLOR message sets the current line color.
TVM_SETSCROLLTIME
Sets the maximum scroll time for the tree-view control.
You can send this message explicitly or by using the TreeView_SetScrollTime macro.
TVM_SETTEXTCOLOR
Sets the text color of the control.
You can send this message explicitly or by using the TreeView_SetTextColor macro.
TVM_SETTOOLTIPS
Sets a tree-view control s child ToolTip control.
You can send this message explicitly or by using the TreeView_SetToolTips macro.
TVM_SETUNICODEFORMAT
Sets the Unicode character format flag for the control.
This message allows you to change the character set used by the control at run time rather than
having to re-create the control.
You can send this message explicitly or use the TreeView_SetUnicodeFormat macro.
TVM_SHOWINFOTIP
Shows the infotip for a specified item in a tree-view control.
You can send this message explicitly or by using the TreeView_ShowInfoTip macro..
TVM_SORTCHILDREN
Sorts the child items of the specified parent item in a tree-view control.
You can send this message explicitly or by using the TreeView_SortChildren macro.
TVM_SORTCHILDRENCB
Sorts tree-view items using an application-defined callback function that compares the items.
You can send this message explicitly or by using the TreeView_SortChildrenCB macro.
Notifications
=============
NM_CLICK (tree view)
Notifies the parent window of a tree-view control that the user has clicked the left mouse
button within the control. This notification is sent in the form of a WM_NOTIFY message.
NM_CUSTOMDRAW (tree view)
Sent by a tree-view control to notify its parent window about drawing operations.
This notification is sent in the form of a WM_NOTIFY message.
NM_DBLCLK (tree view)
Notifies the parent window of a tree-view control that the user has double-clicked the left mouse
button within the control. This notification is sent in the form of a WM_NOTIFY message.
NM_KILLFOCUS (tree view)
Notifies a tree-view control s parent window that the control has lost the input focus.
This notification is sent in the form of a WM_NOTIFY message.
NM_RCLICK (tree view)
Notifies the parent window of a tree-view control that the user has clicked the right mouse
button within the control. This notification is sent in the form of a WM_NOTIFY message.
NM_RDBLCLK (tree view)
Notifies the parent of a tree-view control that the user has double-clicked the right mouse
button within the control. This notification is sent in the form of a WM_NOTIFY message.
NM_RETURN (tree view)
Notifies a tree-view control s parent window that the control has the input focus and that the user
has pressed the key. This notification is sent in the form of a WM_NOTIFY message.
NM_SETCURSOR (tree view)
Notifies a tree-view control s parent window that the control is setting the cursor in response
to a WM_SETCURSOR message. This notification is sent in the form of a WM_NOTIFY message.
NM_SETFOCUS (tree view)
Notifies a tree-view control s parent window that the control has received the input focus.
This notification is sent in the form of a WM_NOTIFY message.
TVN_ASYNCDRAW
Sent by a tree-view control to its parent when the drawing of a icon or overlay has failed.
This notification message is sent in the form of a WM_NOTIFY message.
TVN_BEGINDRAG
Notifies a tree-view control s parent window that a drag-and-drop operation involving the left mouse
button is being initiated. This notification message is sent in the form of a WM_NOTIFY message.
TVN_BEGINLABELEDIT
Notifies a tree-view control s parent window about the start of label editing for an item.
This notification message is sent in the form of a WM_NOTIFY message.
TVN_BEGINRDRAG
Notifies a tree-view control s parent window about the initiation of a drag-and-drop operation
involving the right mouse button. This notification message is sent in the form of a WM_NOTIFY message.
TVN_DELETEITEM
Notifies a tree-view control s parent window that an item is being deleted.
This notification message is sent in the form of a WM_NOTIFY message.
TVN_ENDLABELEDIT
Notifies a tree-view control s parent window about the end of label editing for an item.
This notification message is sent in the form of a WM_NOTIFY message.
TVN_GETDISPINFO
Requests that a tree-view control s parent window provide information needed to display or sort an item.
This notification message is sent in the form of a WM_NOTIFY message.
TVN_GETINFOTIP
Sent by a tree-view control that has the TVS_INFOTIP style. This notification is sent when the
control is requesting additional text information to be displayed in a ToolTip.
The notification is sent in the form of a WM_NOTIFY message.
TVN_ITEMCHANGED
Notifies a tree-view control s parent window that item attributes have changed.
This notification message is sent in the form of a WM_NOTIFY message.
TVN_ITEMCHANGING
Notifies a tree-view control s parent window that item attributes are about to change.
This notification message is sent in the form of a WM_NOTIFY message.
TVN_ITEMEXPANDED
Notifies a tree-view control s parent window that a parent item s list of child items has expanded
or collapsed. This notification message is sent in the form of a WM_NOTIFY message.
TVN_ITEMEXPANDING
Notifies a tree-view control s parent window that a parent item s list of child items is about to
expand or collapse. This notification message is sent in the form of a WM_NOTIFY message.
TVN_KEYDOWN
Notifies a tree-view control s parent window that the user pressed a key and the tree-view control
has the input focus. This notification message is sent in the form of a WM_NOTIFY message.
TVN_SELCHANGED
Notifies a tree-view control s parent window that the selection has changed from one item to another.
This notification message is sent in the form of a WM_NOTIFY message.
TVN_SELCHANGING
Notifies a tree-view control s parent window that the selection is about to change from one item
to another. This notification message is sent in the form of a WM_NOTIFY message.
TVN_SETDISPINFO
Notifies a tree-view control s parent window that it must update the information it maintains
about an item. This notification message is sent in the form of a WM_NOTIFY message.
TVN_SINGLEEXPAND
Sent by a tree-view control with the TVS_SINGLEEXPAND style when the user opens or closes a
tree item using a single click of the mouse. This notification is sent in the form of a WM_NOTIFY message.
Structures
==========
NMTREEVIEW
Contains information about a tree-view notification message. This structure is identical to
the NM_TREEVIEW structure, but it has been renamed to follow current naming conventions.
NMTVASYNCDRAW
Contains an explanation of why the draw of an icon or overlay tree item failed.
This structure is sent on a TVN_ASYNCDRAW notification. Set the dwRetFlags member to indicate
what action the control should take. Note that a draw can fail if there is no image; in other words,
when the icon image has not been extracted.
NMTVCUSTOMDRAW
Contains information specific to an NM_CUSTOMDRAW (tree view) notification message
sent by a tree-view control.
NMTVDISPINFO
Contains and receives display information for a tree-view item. This structure is identical
to the TV_DISPINFO structure, but it has been renamed to follow current naming conventions.
NMTVDISPINFOEX
Contains information pertaining to extended TreeView notification information.
NMTVGETINFOTIP
Contains and receives tree-view item information needed to display a ToolTip for an item.
This structure is used with the TVN_GETINFOTIP notification message.
NMTVITEMCHANGE
Contains information on a tree-view item change. This structure is sent with the TVN_ITEMCHANGED
and TVN_ITEMCHANGING notifications.
NMTVITEMRECT
Not currently supported.
NMTVKEYDOWN
Contains information about a keyboard event in a tree-view control. This structure is used
with the TVN_KEYDOWN notification message. The structure is identical to the TV_KEYDOWN structure,
but it has been renamed to follow current naming conventions.
NMTVSTATEIMAGECHANGING
Contains information about a tree-view state image changing notification message.
TVGETITEMPARTRECTINFO
Contains information for identifying the "hit zone" for a specified part of a tree item.
The structure is used with the TVM_GETITEMPARTRECT message and the TreeView_GetItemPartRect macro.
TVHITTESTINFO
Contains information used to determine the location of a point relative to a tree-view control.
This structure is used with the TVM_HITTEST message. The structure is identical to
the TV_HITTESTINFO structure, but it has been renamed to follow current naming conventions.
TVINSERTSTRUCT
Contains information used to add a new item to a tree-view control. This structure is used with the
TVM_INSERTITEM message. The structure is identical to the TV_INSERTSTRUCT structure,
but it has been renamed to follow current naming conventions.
TVITEM
Specifies or receives attributes of a tree-view item. This structure is identical to the
TV_ITEM structure, but it has been renamed to follow current naming conventions.
New applications should use this structure.
TVITEMEX
Specifies or receives attributes of a tree-view item. This structure is an enhancement to the
TVITEM structure. New applications should use this structure where appropriate.
TVSORTCB
Contains information used to sort child items in a tree-view control. This structure is used
with the TVM_SORTCHILDRENCB message. This structure is identical to the TV_SORTCB structure,
but it has been renamed to follow current naming conventions.
Constants
=========
Tree-View Control Extended Styles
This section lists extended styles used when creating tree-view controls.
The value of extended styles is a bitwise combination of these styles.
Tree-View Control Item States
This section lists the item state flags used to indicate the state of an item in a tree-view control.
Tree-View Control Window Styles
This section lists window styles used when creating tree-view controls.
Constants : Tree-View Control Extended Styles
=============================================
TVS_EX_AUTOHSCROLL
Remove the horizontal scrollbar and auto-scroll depending on mouse position.
TVS_EX_DIMMEDCHECKBOXES
Include dimmed checkbox state if the control has the TVS_CHECKBOXES style.
TVS_EX_DOUBLEBUFFER
Specifies how the background is erased or filled.
TVS_EX_DRAWIMAGEASYNC
Retrieves calendar grid information.
TVS_EX_EXCLUSIONCHECKBOXES
Include exclusion checkbox state if the control has the TVS_CHECKBOXES style.
TVS_EX_FADEINOUTEXPANDOS
Fade expando buttons in or out when the mouse moves away or into a state of hovering over the control.
TVS_EX_MULTISELECT
Not supported. Do not use.
TVS_EX_NOINDENTSTATE
Do not indent the tree view for the expando buttons.
TVS_EX_PARTIALCHECKBOXES
Include partial checkbox state if the control has the TVS_CHECKBOXES style.
TVS_EX_RICHTOOLTIP
Allow rich tooltips in the tree view (custom drawn with icon and text).
Constants : Tree-View Control Item States
=========================================
TVIS_BOLD
The item is bold.
TVIS_CUT
The item is selected as part of a cut-and-paste operation.
TVIS_DROPHILITED
The item is selected as a drag-and-drop target.
TVIS_EXPANDED
The item s list of child items is currently expanded; that is, the child items are visible.
This value applies only to parent items.
TVIS_EXPANDEDONCE
The item s list of child items has been expanded at least once. The TVN_ITEMEXPANDING and
TVN_ITEMEXPANDED notification messages are not generated for parent items that have this
state set in response to a TVM_EXPAND message. Using TVE_COLLAPSE and TVE_COLLAPSERESET
with TVM_EXPAND will cause this state to be reset. This value applies only to parent items.
TVIS_EXPANDPARTIAL
Version 4.70. A partially expanded tree-view item. In this state, some, but not all,
of the child items are visible and the parent item s plus symbol is displayed.
TVIS_SELECTED
The item is selected. Its appearance depends on whether it has the focus.
The item will be drawn using the system colors for selection.
Note:
When you set or retrieve an item s overlay image index or state image index,
you must specify the following masks in the stateMask member of the TVITEM structure.
These values can also be used to mask off the state bits that are not of interest.
TVIS_OVERLAYMASK
Mask for the bits used to specify the item s overlay image index.
TVIS_STATEIMAGEMASK
Mask for the bits used to specify the item s state image index.
TVIS_USERMASK
Same as TVIS_STATEIMAGEMASK.
Constants : Tree-View Control Window Styles
===========================================
TVS_CHECKBOXES
Version 4.70. Enables check boxes for items in a tree-view control. A check box is displayed
only if an image is associated with the item. When set to this style, the control effectively
uses DrawFrameControl to create and set a state image list containing two images. State image 1
is the unchecked box and state image 2 is the checked box. Setting the state image to zero removes
the check box altogether. For more information, see Working with state image indexes.
Version 5.80. Displays a check box even if no image is associated with the item.
Once a tree-view control is created with this style, the style cannot be removed.
Instead, you must destroy the control and create a new one in its place. Destroying the
tree-view control does not destroy the check box state image list. You must destroy it explicitly.
Get the handle to the state image list by sending the tree-view control a TVM_GETIMAGELIST message.
Then destroy the image list with ImageList_Destroy.
If you want to use this style, you must set the TVS_CHECKBOXES style with SetWindowLong
after you create the treeview control, and before you populate the tree. Otherwise,
the checkboxes might appear unchecked, depending on timing issues.
TVS_DISABLEDRAGDROP
Prevents the tree-view control from sending TVN_BEGINDRAG notification messages.
TVS_EDITLABELS
Allows the user to edit the labels of tree-view items.
TVS_FULLROWSELECT
Version 4.71. Enables full-row selection in the tree view. The entire row of the selected item
is highlighted, and clicking anywhere on an item s row causes it to be selected. This style cannot
be used in conjunction with the TVS_HASLINES style.
TVS_HASBUTTONS
Displays plus (+) and minus (-) buttons next to parent items. The user clicks the buttons to
expand or collapse a parent item s list of child items. To include buttons with items at the
root of the tree view, TVS_LINESATROOT must also be specified.
TVS_HASLINES
Uses lines to show the hierarchy of items.
TVS_INFOTIP
Version 4.71. Obtains ToolTip information by sending the TVN_GETINFOTIP notification.
TVS_LINESATROOT
Uses lines to link items at the root of the tree-view control. This value is ignored
if TVS_HASLINES is not also specified.
TVS_NOHSCROLL
Version 5.80. Disables horizontal scrolling in the control. The control will not display
any horizontal scroll bars.
TVS_NONEVENHEIGHT
Version 4.71 Sets the height of the items to an odd height with the TVM_SETITEMHEIGHT message.
By default, the height of items must be an even value.
TVS_NOSCROLL
Version 4.71. Disables both horizontal and vertical scrolling in the control.
The control will not display any scroll bars.
TVS_NOTOOLTIPS
Version 4.70. Disables ToolTips.
TVS_RTLREADING
Version 4.70. Causes text to be displayed from right-to-left (RTL).
Usually, windows display text left-to-right (LTR). Windows can be mirrored to display
languages such as Hebrew or Arabic that read RTL. Typically, tree-view text is displayed
in the same direction as the text in its parent window. if TVS_RTLREADING is set, tree-view text
reads in the opposite direction from the text in the parent window.
TVS_SHOWSELALWAYS
Causes a selected item to remain selected when the tree-view control loses focus.
TVS_SINGLEEXPAND
Version 4.71. Causes the item being selected to expand and the item being unselected to
collapse upon selection in the tree view. If the mouse is used to single-click the selected item and
that item is closed, it will be expanded. If the user holds down the CTRL key while selecting an item,
the item being unselected will not be collapsed.
Version 5.80. Causes the item being selected to expand and the item being unselected to
collapse upon selection in the tree view. If the user holds down the CTRL key while selecting an item,
the item being unselected will not be collapsed.
TVS_TRACKSELECT
Version 4.70. Enables hot tracking in a tree-view control.
#endif
/*----------------------------------------------------------------------*/