Compartir a través de

Estructura LVCOLUMNA (commctrl.h)

  • Artículo

Contiene información sobre una columna en la vista de informe. Esta estructura se usa para crear y manipular columnas. Esta estructura reemplaza a la estructura de 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 de

Variable que especifica qué miembros contienen información válida. Este miembro puede ser cero o uno o varios de los siguientes valores:

Valor Significado
LVCF_FMT
 El miembro fmt es válido.
LVCF_WIDTH
 El miembro cx es válido.
LVCF_TEXT
 El miembro pszText es válido.
LVCF_SUBITEM
 El miembro iSubItem es válido.
LVCF_IMAGE

versión 4.70. El miembro iImage es válido.
LVCF_ORDER

versión 4.70. El miembro iOrder es válido.
LVCF_MINWIDTH

versión 6.00 y Windows Vista.El miembro cxMin de es válido.
LVCF_DEFAULTWIDTH

versión 6.00 y Windows Vista.El miembro cxDefault de es válido.
LVCF_IDEALWIDTH

versión 6.00 y Windows Vista.El miembro cxIdeal de 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
LVCFMT_LEFT
 El texto está alineado a la izquierda.
LVCFMT_RIGHT
 El texto está alineado a la derecha.
LVCFMT_CENTER
 El texto está centrado.
LVCFMT_JUSTIFYMASK
 Máscara de bits usada para seleccionar esos bits de fmt esa justificación del campo de control. 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 LVCFMT_LEFT, LVCFMT_RIGHT o LVCFMT_CENTER.
LVCFMT_IMAGE

versión 4.70. El elemento muestra una imagen de una lista de imágenes.
LVCFMT_BITMAP_ON_RIGHT

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.
LVCFMT_COL_HAS_IMAGES

versión 4.70. El elemento de encabezado contiene una imagen en la lista de imágenes.
LVCFMT_FIXED_WIDTH

versión 6.00 y Windows Vista. No se puede cambiar el tamaño de la columna; igual que HDF_FIXEDWIDTH.
LVCFMT_NO_DPI_SCALE

versión 6.00 y Windows Vista. Si no se establece, CCM_DPISCALE controlará el escalado vertical del ancho fijo.
LVCFMT_FIXED_RATIO

versión 6.00 y Windows Vista. Width aumentará con el alto de fila.
LVCFMT_SPLITBUTTON

versión 6.00 y Windows Vista. Columna 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, en píxeles.

pszText

Tipo: LPTSTR de

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 list-view 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.

Observaciones

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 a la derecha o centrada, puede crear una columna ficticia, insertar una o varias columnas con el índice 1 o superior y especificar la alineación que necesita. Por último, elimine la columna ficticia.

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 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

Consulte también

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

de referencia de