Estructura LVCOLUMNA (commctrl.h)
Contiene información sobre una columna en la vista de informe. Esta estructura se usa para crear y manipular columnas. Esta estructura sustituye a la estructura LV_COLUMN.
Sintaxis
typedef struct tagLVCOLUMNA {
UINT mask;
int fmt;
int cx;
LPSTR pszText;
int cchTextMax;
int iSubItem;
int iImage;
int iOrder;
int cxMin;
int cxDefault;
int cxIdeal;
} LVCOLUMNA, *LPLVCOLUMNA;
Miembros
mask
Tipo: UINT
Variable que especifica qué miembros contienen información válida. Este miembro puede ser cero o uno o varios de los valores siguientes:
| Valor | Significado |
|---|---|
|
El miembro fmt es válido. |
|
El miembro cx es válido. |
|
El miembro pszText es válido. |
|
El miembro iSubItem es válido. |
|
Versión 4.70. El miembro iImage es válido. |
|
Versión 4.70. El miembro iOrder es válido. |
|
Versión 6.00 y Windows Vista.El miembro cxMin es válido. |
|
Versión 6.00 y Windows Vista.El miembro cxDefault es válido. |
|
Versión 6.00 y Windows Vista.El miembro cxIdeal es válido. |
fmt
Tipo: int
Alineación del encabezado de columna y el texto del subelemento de la columna. La alineación de la columna situada más a la izquierda siempre es LVCFMT_LEFT; no se puede cambiar. Este miembro puede ser una combinación de los valores siguientes. Tenga en cuenta que no todas las combinaciones son válidas.
| Valor | Significado |
|---|---|
|
El texto está alineado a la izquierda. |
|
El texto está alineado a la derecha. |
|
Texto centrado. |
|
Máscara de bits usada para seleccionar esos bits de fmt que controlan la justificación del campo. Para comprobar el formato de una columna, use una "y" lógica para combinar LCFMT_JUSTIFYMASK con fmt. A continuación, puede usar una instrucción switch para determinar si se establecen los bits de LVCFMT_LEFT, LVCFMT_RIGHT o LVCFMT_CENTER. |
|
Versión 4.70. El elemento muestra una imagen de una lista de imágenes. |
|
Versión 4.70. El mapa de bits aparece a la derecha del texto. Esto no afecta a una imagen de una lista de imágenes asignada al elemento de encabezado. |
|
Versión 4.70. El elemento de encabezado contiene una imagen en la lista de imágenes. |
|
Versión 6.00 y Windows Vista. No se puede cambiar el tamaño de la columna; igual que HDF_FIXEDWIDTH. |
|
Versión 6.00 y Windows Vista. Si no se establece, CCM_DPISCALE controlará el escalado vertical del ancho fijo. |
|
Versión 6.00 y Windows Vista. El ancho aumentará con el alto de fila. |
|
Versión 6.00 y Windows Vista. Column es un botón de división (igual que HDF_SPLITBUTTON). El encabezado de la columna muestra un botón de división (igual que HDF_SPLITBUTTON). |
cx
Tipo: int
Ancho de la columna, expresado en píxeles.
pszText
Tipo: LPTSTR
Si se establece información de columna, este miembro es la dirección de una cadena terminada en null que contiene el texto del encabezado de columna. Si la estructura recibe información sobre una columna, este miembro especifica la dirección del búfer que recibe el texto del encabezado de columna.
cchTextMax
Tipo: int
Tamaño en TCHARs del búfer al que apunta el miembro pszText . Si la estructura no recibe información sobre una columna, se omite este miembro.
iSubItem
Tipo: int
Índice del subelemento asociado a la columna.
iImage
Tipo: int
Versión 4.70. Índice de base cero de una imagen dentro de la lista de imágenes. La imagen especificada aparecerá dentro de la columna.
iOrder
Tipo: int
Versión 4.70. Desplazamiento de columna de base cero. El desplazamiento de columna está en orden de izquierda a derecha. Por ejemplo, cero indica la columna situada más a la izquierda.
cxMin
Tipo: int
Windows Vista. Ancho mínimo de la columna en píxeles.
cxDefault
Tipo: int
Windows Vista. El valor definido por la aplicación se usa normalmente para almacenar el ancho predeterminado de la columna. El control de vista de lista omite este miembro.
cxIdeal
Tipo: int
Windows Vista. Solo lectura. Ancho ideal de la columna en píxeles, ya que la columna se puede ajustar automáticamente a un ancho menor.
Comentarios
Si se agrega una columna a un control de vista de lista con el índice 0 (la columna situada más a la izquierda), siempre se LVCFMT_LEFT. Establecer otras marcas en la columna 0 no invalida esa alineación. Por lo tanto, si sigue insertando columnas con el índice 0, el texto de todas las columnas se alinea a la izquierda. Si desea que la primera columna esté alineada o centrada a la derecha, puede crear una columna ficticía, insertar una o varias columnas con el índice 1 o superior y especificar la alineación que necesita. Por último, elimine la columna ficticía.
Nota:
El encabezado commctrl.h define LVCOLUMN 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado | commctrl.h |
Consulte también
Referencia