Estructura LVCOLUMNW (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 sustituye a la estructura LV_COLUMN.

Sintaxis

typedef struct tagLVCOLUMNW {
  UINT   mask;
  int    fmt;
  int    cx;
  LPWSTR pszText;
  int    cchTextMax;
  int    iSubItem;
  int    iImage;
  int    iOrder;
  int    cxMin;
  int    cxDefault;
  int    cxIdeal;
} LVCOLUMNW, *LPLVCOLUMNW;

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
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 es válido.
LVCF_DEFAULTWIDTH

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

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
LVCFMT_LEFT
 El texto está alineado a la izquierda.
LVCFMT_RIGHT
 El texto está alineado a la derecha.
LVCFMT_CENTER
 Texto centrado.
LVCFMT_JUSTIFYMASK
 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.
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. El ancho aumentará con el alto de fila.
LVCFMT_SPLITBUTTON

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

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

Referencia