Estructura LVITEMW (commctrl.h)
Especifica o recibe los atributos de un elemento de vista de lista. Esta estructura se ha actualizado para admitir un nuevo valor de máscara (LVIF_INDENT) que habilita la sangría de elementos. Esta estructura reemplaza a la estructura LV_ITEM.
Sintaxis
typedef struct tagLVITEMW {
UINT mask;
int iItem;
int iSubItem;
UINT state;
UINT stateMask;
LPWSTR pszText;
int cchTextMax;
int iImage;
LPARAM lParam;
int iIndent;
int iGroupId;
UINT cColumns;
PUINT puColumns;
int *piColFmt;
int iGroup;
} LVITEMW, *LPLVITEMW;
Miembros
mask
Tipo: UINT de
Conjunto de marcas que especifican qué miembros de esta estructura contienen datos que se van a establecer o qué miembros se solicitan. Este miembro puede tener uno o varios de los siguientes marcadores establecidos:
| Valor | Significado |
|---|---|
|
Windows Vista y versiones posteriores. El miembro piColFmt es válido o debe establecerse. Si se usa esta marca, el miembro cColumns es válido o debe establecerse. |
|
El miembro cColumns es válido o debe establecerse. |
|
El sistema operativo debe almacenar la información del elemento de lista solicitada y no solicitarla de nuevo. Esta marca solo se usa con el código de notificación LVN_GETDISPINFO. |
|
El miembro |
|
El miembro iImage es válido o debe establecerse. |
|
El miembro |
|
El control no generará LVN_GETDISPINFO para recuperar información de texto si recibe un mensaje de LVM_GETITEM. En su lugar, el miembro pszText contendrá LPSTR_TEXTCALLBACK. |
|
El miembro |
|
El estado miembro es válido o debe establecerse. |
|
El miembro pszText es válido o debe establecerse. |
iItem
Tipo: int
Índice de base cero del elemento al que hace referencia esta estructura.
iSubItem
Tipo: int
Índice basado en uno del subelemento al que hace referencia esta estructura, o cero si esta estructura hace referencia a un elemento en lugar de a un subelemento.
state
Tipo: UINT de
Indica el estado, la imagen de estado y la imagen de superposición del elemento. El miembro stateMask indica los bits válidos de este miembro.
Los bits de 0 a 7 de este miembro contienen las marcas de estado del elemento. Puede ser uno o varios de los valores estado del elemento de
Los bits de 8 a 11 de este miembro especifican el índice de imagen de superposición basado en uno. Tanto la lista de imágenes de icono de tamaño completo como la lista de imágenes de icono pequeño pueden tener imágenes superpuestas. La imagen de superposición se superpone sobre la imagen de icono del elemento. Si estos bits son cero, el elemento no tiene ninguna imagen de superposición. Para aislar estos bits, use la máscara de LVIS_OVERLAYMASK. Para establecer el índice de imagen de superposición en este miembro, debe usar la macro INDEXTOOVERLAYMASK. Las imágenes de superposición de la lista de imágenes se establecen con la función ImageList_SetOverlayImage.
Los bits de 12 a 15 de este miembro especifican el índice de imagen de estado. La imagen de estado se muestra junto al icono de un elemento para indicar un estado definido por la aplicación. Si estos bits son cero, el elemento no tiene ninguna imagen de estado. Para aislar estos bits, use la máscara de LVIS_STATEIMAGEMASK. Para establecer el índice de imagen de estado, use la macro INDEXTOSTATEIMAGEMASK. El índice de imagen de estado especifica el índice de la imagen en la lista de imágenes de estado que se debe dibujar. La lista de imágenes de estado se especifica con el mensaje LVM_SETIMAGELIST.
stateMask
Tipo: UINT de
Valor que especifica qué bits del estado de miembro se recuperarán o modificarán. Por ejemplo, establecer este miembro en LVIS_SELECTED hará que solo se recupere el estado de selección del elemento.
Este miembro permite modificar uno o varios estados de elemento sin tener que recuperar primero todos los estados del elemento. Por ejemplo, establecer este miembro en LVIS_SELECTED y estado en cero hará que se borre el estado de selección del elemento, pero ninguno de los demás estados se verá afectado.
Para recuperar o modificar todos los estados, establezca este miembro en (UINT)-1.
Puede usar la macro ListView_SetItemState para establecer y borrar bits.
pszText
Tipo: LPTSTR de
Si la estructura especifica atributos de elemento, pszText es un puntero a una cadena terminada en null que contiene el texto del elemento. Al responder a una notificación de LVN_GETDISPINFO, asegúrese de que este puntero permanece válido hasta que se haya recibido la siguiente notificación.
Si la estructura recibe atributos de elemento, pszText es un puntero a un búfer que recibe el texto del elemento. Tenga en cuenta que, aunque el control de vista de lista permite almacenar cualquier cadena de longitud como texto de elemento, solo se muestran los primeros 260 TCHARs.
Si el valor de pszText es LPSTR_TEXTCALLBACK, el elemento es un elemento de devolución de llamada . Si cambia el texto de devolución de llamada, debe establecer explícitamente pszText en LPSTR_TEXTCALLBACK y notificar al control de vista de lista el cambio enviando un mensaje de LVM_SETITEM o LVM_SETITEMTEXT.
No establezca pszText en LPSTR_TEXTCALLBACK si el control list-view tiene el estilo LVS_SORTASCENDING o LVS_SORTDESCENDING.
cchTextMax
Tipo: int
Número de
Este miembro solo se usa cuando la estructura recibe atributos de elemento. Se omite cuando la estructura especifica atributos de elemento. Por ejemplo, cchTextMax se omite durante LVM_SETITEM y LVM_INSERTITEM. Es de solo lectura durante LVN_GETDISPINFO y otras notificaciones de LVN_.
iImage
Tipo: int
Índice del icono del elemento en la lista de imágenes del control. Esto se aplica a la lista de imágenes grandes y pequeñas. Si este miembro es el valor de I_IMAGECALLBACK, la ventana primaria es responsable de almacenar el índice. En este caso, el control list-view envía al elemento primario un código de notificación LVN_GETDISPINFO para recuperar el índice cuando necesite mostrar la imagen.
lParam
Tipo: LPARAM de
Valor específico del elemento. Si usa el mensaje de LVM_SORTITEMS, el control list-view pasa este valor a la función de comparación definida por la aplicación. También puede usar el mensaje de LVM_FINDITEM para buscar un control de vista de lista para un elemento con un valor lParam especificado.
iIndent
Tipo: int
versión 4.70. Número de anchos de imagen para sangr el elemento. Una sola sangría equivale al ancho de una imagen de elemento. Por lo tanto, el valor 1 sangría el elemento por el ancho de una imagen, el valor de 2 sangrías por dos imágenes, etc. Tenga en cuenta que este campo solo se admite para los elementos. Si se intenta establecer la sangría del subelemento, se producirá un error en la función de llamada.
iGroupId
Tipo: int
versión 6.0 identificador del grupo al que pertenece el elemento o uno de los siguientes valores.
| Valor | Significado |
|---|---|
|
El control listview envía al elemento primario un código de notificación LVN_GETDISPINFO para recuperar el índice del grupo. |
|
El elemento no pertenece a un grupo. |
cColumns
Tipo: UINT de
versión 6.0 Número de columnas de datos (subelementos) que se mostrarán para este elemento en la vista de mosaico. El valor máximo es 20. Si este valor es I_COLUMNSCALLBACK, el tamaño de la matriz de columnas y la propia matriz (puColumns) se obtienen enviando una notificación de LVN_GETDISPINFO.
puColumns
versión 6.0 puntero a una matriz de índices de columna, especificando qué columnas se muestran para este elemento y el orden de esas columnas.
piColFmt
Tipo: int*
Windows Vista: No implementado. Windows 7 y versiones posteriores: puntero a una matriz de las marcas siguientes (solo o en combinación), especificando el formato de cada subelemento en la vista de mosaico extendida.
iGroup
Tipo: int
Windows Vista: índice de grupo del elemento. Válido solo para la devolución de llamada o los datos de propietario (un solo elemento de varios grupos).
Observaciones
La estructura de LVITEM de
En la vista de mosaico, el nombre del elemento se muestra a la derecha del icono. Puede especificar subelementos adicionales (correspondientes a las columnas de la vista de detalles), que se mostrarán en líneas debajo del nombre del elemento. La matriz
Para obtener código de ejemplo, vea Using List-View Controls.
Nota
El encabezado commctrl.h define LVITEM como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| encabezado de |
commctrl.h |