На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

TV_ITEM



The TV_ITEM structure specifies or receives attributes of a tree-view item.

typedef struct _TV_ITEM { tvi
UINT mask;
HTREEITEM hItem;
UINT state;
UINT stateMask;
LPSTR pszText;
int cchTextMax;
int iImage;
int iSelectedImage;
int cChildren;
LPARAM lParam;
} TV_ITEM, FAR *LPTV_ITEM;


Members

mask

Array of flags that indicate which of the other structure members contain valid data. When this structure is used with the TVM_GETITEM message, the mask
member indicates the item attributes to retrieve. This member can be a combination of the following values:

Value Meaning
TVIF_CHILDREN The cChildren member is valid.
TVIF_HANDLE The hItem member is valid.
TVIF_IMAGE The iImage member is valid.
TVIF_PARAM The lParam member is valid.
TVIF_SELECTEDIMAGE The iSelectedImage member is valid.
TVIF_STATE The state and stateMask members are valid.
TVIF_TEXT The pszText and cchTextMax members are valid.


hItem

Identifies the item to which this structure refers.

state

Specifies the current state of the item if the item's state is being retrieved, or the new state if the item's state is being set. The stateMask member specifies the bits of the state member that are valid. This member can be any valid combination of state values. For a list of item states, see Tree-View Item States.

stateMask

Specifies the bits of the state member that are valid.

pszText

Pointer to a null-terminated string that contains the item text if the structure specifies item attributes. If this member is the LPSTR_TEXTCALLBACK value, the parent window is responsible for storing the name. In this case, the tree-view control sends the parent window a TVN_GETDISPINFO notification message when it needs the item text for displaying, sorting, or editing, and a TVN_SETDISPINFO notification message when the item text changes.

If the structure is receiving item attributes, this member is the pointer to the buffer that receives the item text.

cchTextMax

Size of the buffer pointed to by the pszText member if the structure is receiving item attributes. If the structure specifies item attributes, this member is ignored.

iImage

Index in the tree-view control's image list of the icon image to use when the item is in the non-selected state.

If this member is the I_IMAGECALLBACK value, the parent window is responsible for storing the index. In this case, the tree-view control sends the parent a TVN_GETDISPINFO notification message to get the index when it needs to display the image.

iSelectedImage

Index in the tree-view control's image list of the icon image to use when the item is in the selected state.

If this member is the I_IMAGECALLBACK value, the parent window is responsible for storing the index. In this case, the tree-view control sends the parent a TVN_GETDISPINFO notification message to get the index when it needs to display the image.

cChildren

Flag that indicates whether the item has associated child items. This member is one of the following values:

Value Meaning
zero The item has no child items.
1 The item has one or more child items.
I_CHILDRENCALLBACK The parent window keeps track of whether the item has child items. In this case, when the tree-view control needs to display the item, the control sends the parent a TVN_GETDISPINFO notification message to determine whether the item has child items.


If the tree-view control has the TVS_HASBUTTONS style, it uses this member to determine whether to display the button indicating the presence of child items. You can use this member to force the control to display the button even though the item does not have any child items inserted. This allows you to display the button while minimizing the control's memory usage by inserting child items only when the item is visible or expanded.

lParam

A 32-bit value to associate with the item.



Remarks

This structure is used with the TVM_GETITEM, TVM_SETITEM, and TVM_INSERTITEM messages. It is also included with many of the notification messages. When the structure is used to retrieve item information, only the structure members indicated by mask contain valid data. All other members are invalid.

See Also

TVN_GETDISPINFO, TVM_GETITEM, TVM_INSERTITEM, TVN_SETDISPINFO, TVM_SETITEM


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

TV_ITEM



Структура TV_ITEM определяет или получает атрибуты дерева-вида пункта.

typedef struct _TV_ITEM { маска tvi UINT;
HTREEITEM hItem;
СОСТОЯНИЕ UINT;
UINT stateMask;
LPSTR pszText;
int cchTextMax;
int iImage;
int iSelectedImage;
int cChildren;
LPARAM lParam;
} TV_ITEM, ЗНАЧИТЕЛЬНО *LPTV_ITEM;


Участники

маска

Массив флагов, которые указывают который из других структурных участников содержат правильные данные. Когда эта структура использована сообщением TVM_GETITEM, элемент маски указывает атрибуты пункта, чтобы извлекаться. Этот элемент может быть комбинацией следующего величин:

Значение Величины
TVIF_CHILDREN элемент cChildren в силе.
TVIF_HANDLE элемент hItem в силе.
TVIF_IMAGE элемент iImage в силе.
TVIF_PARAM элемент lParam в силе.
TVIF_SELECTEDIMAGE элемент iSelectedImage в силе.
TVIF_STATE состояние и участники stateMask в силе.
TVIF_TEXT pszText и участники cchTextMax в силе.


hItem

Идентифицирует пункт на котором эта структура отмечается.

состояние

Определяет текущее состояние пункта если состояние пункта извлекается, или новое состояние если состояние пункта установленн. Элемент stateMask определяет биты штата элемента, который в силе. Этот элемент может быть любой правильной комбинацией государственных величин. Для списка состояний пункта, смотри Состояния Пункта Tree-View.

stateMask

Определяет биты штата элемента, который в силе.

pszText

Указатель в недействительный расторгнутую строку, которая содержит текст пункта если структура определяет атрибуты пункта. Если этот элемент является величиной LPSTR_TEXTCALLBACK, родительское окно ответственное за хранение имени. В этом случае, дерево-вид управления посылает родительскому окну сообщение уведомления TVN_GETDISPINFO когда ему нужно текст пункта для отображение, сортирующий, или редактируя, и сообщение уведомления TVN_SETDISPINFO когда текст пункта изменяется.

Если структура получает атрибуты пункта, этот элемент является указателем в буфер, который получает текст пункта.

cchTextMax

Размер буфера указывался, чтобы элементом pszText если структура получает атрибуты пункта. Если структура определяет атрибуты пункта, этот элемент проигнорирован.

iImage

Проиндексируйте дерево-вид управляющего образа списка иконного образа, чтобы использоваться когда пункт - в не-выбравшееся состояние.

Если этот элемент является величиной I_IMAGECALLBACK, родительское окно ответственное за хранение индекса. В этом случае, дерево-вид управления посылает родителю сообщение уведомления TVN_GETDISPINFO, чтобы получать индекс когда ему нужно отображать образ.

iSelectedImage

Проиндексируйте дерево-вид управляющего образа списка иконного образа, чтобы использоваться когда пункт - в выбранном состоянии.

Если этот элемент является величиной I_IMAGECALLBACK, родительское окно ответственное за хранение индекса. В этом случае, дерево-вид управления посылает родителю сообщение уведомления TVN_GETDISPINFO, чтобы получать индекс когда ему нужно отображать образ.

cChildren

Флаг, что указывает связал пункт пункты ребенка. Этот элемент - одно из следующего величин:

Значение Величины
нуль пункт не имеет пункты ребенка.
1 Пункт имеет один или более пунктов ребенка.
I_CHILDRENCALLBACK родительское окно следит имеет пункт пункты ребенка. В этом случае, когда дереву-виду управления нужно отображать пункт, управление посылает родителю сообщение уведомления TVN_GETDISPINFO, чтобы определять имеет пункт пункты ребенка.


Если дерево-вид управления имеет стиль TVS_HASBUTTONS, оно использует этот элемент, чтобы определять отображать кнопку, указывающую присутствие пунктов ребенка. Вы можете использовать этот элемент, чтобы заставлять управление, чтобы отображать кнопку даже если пункт нет включил любые пункты ребенка. Это позволяет Вам, чтобы отображать кнопка при снижении управляющего использования памяти включая пункты ребенка только когда пункт - видимый или расширенный.

lParam

32- Битовая величина, чтобы соединяться с пунктом.



Замечания

Эта структура использована TVM_GETITEM, TVM_SETITEM, и сообщениями TVM_INSERTITEM. Также включено многими сообщениями уведомления. Когда структура использована, чтобы извлекать информацию пункта, только структурные участники указанные маской содержат правильные данные. Все другие участники недействительны.

Смотри Также

TVN_GETDISPINFO, TVM_GETITEM, TVM_INSERTITEM, TVN_SETDISPINFO, TVM_SETITEM


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz