Struttura LVCOLUMNA (commctrl.h)

Articolo
11/18/2024

Contiene informazioni su una colonna nella visualizzazione report. Questa struttura viene utilizzata sia per la creazione che la modifica di colonne. Questa struttura sostituisce la struttura LV_COLUMN.

Sintassi

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;

Membri

mask

Tipo: UINT

Variabile che specifica quali membri contengono informazioni valide. Questo membro può essere zero o uno o più dei valori seguenti:

Valore	Significato
LVCF_FMT	Il membro fmt è valido.
LVCF_WIDTH	Il membro cx è valido.
LVCF_TEXT	Il membro pszText è valido.
LVCF_SUBITEM	Il membro iSubItem è valido.
LVCF_IMAGE	versione 4.70. Il membro iImage è valido.
LVCF_ORDER	versione 4.70. Il membro iOrder è valido.
LVCF_MINWIDTH	versione 6.00 e Windows Vista.Il membro cxMin è valido.
LVCF_DEFAULTWIDTH	versione 6.00 e Windows Vista.Il membro cxDefault è valido.
LVCF_IDEALWIDTH	versione 6.00 e Windows Vista.Il membro cxIdeal è valido.

fmt

Tipo: int

Allineamento dell'intestazione di colonna e del testo dell'elemento secondario nella colonna. L'allineamento della colonna più a sinistra è sempre LVCFMT_LEFT; non può essere modificato. Questo membro può essere una combinazione dei valori seguenti. Si noti che non tutte le combinazioni sono valide.

Valore	Significato
LVCFMT_LEFT	Il testo è allineato a sinistra.
LVCFMT_RIGHT	Il testo è allineato a destra.
LVCFMT_CENTER	Il testo è centrato.
LVCFMT_JUSTIFYMASK	Maschera di bit usata per selezionare i bit di fmt giustificazione del campo di controllo. Per controllare il formato di una colonna, usare un "and" logico per combinare LCFMT_JUSTIFYMASK con fmt. È quindi possibile usare un'istruzione switch per determinare se vengono impostati i bit di LVCFMT_LEFT, LVCFMT_RIGHT o di LVCFMT_CENTER.
LVCFMT_IMAGE	versione 4.70. L'elemento visualizza un'immagine da un elenco di immagini.
LVCFMT_BITMAP_ON_RIGHT	versione 4.70. La bitmap viene visualizzata a destra del testo. Ciò non influisce su un'immagine da un elenco di immagini assegnato all'elemento di intestazione.
LVCFMT_COL_HAS_IMAGES	versione 4.70. L'elemento di intestazione contiene un'immagine nell'elenco di immagini.
LVCFMT_FIXED_WIDTH	versione 6.00 e Windows Vista. Non è possibile ridimensionare la colonna; uguale a HDF_FIXEDWIDTH.
LVCFMT_NO_DPI_SCALE	versione 6.00 e Windows Vista. Se non è impostato, CCM_DPISCALE determina la scalabilità fissa.
LVCFMT_FIXED_RATIO	versione 6.00 e Windows Vista. Width aumenterà con l'altezza della riga.
LVCFMT_SPLITBUTTON	versione 6.00 e Windows Vista. Colonna è un pulsante di divisione (uguale a HDF_SPLITBUTTON). L'intestazione della colonna visualizza un pulsante di divisione (uguale a HDF_SPLITBUTTON).

cx

Tipo: int

Larghezza della colonna, in pixel.

pszText

Tipo: LPTSTR

Se vengono impostate informazioni sulla colonna, questo membro è l'indirizzo di una stringa con terminazione Null contenente il testo dell'intestazione di colonna. Se la struttura riceve informazioni su una colonna, questo membro specifica l'indirizzo del buffer che riceve il testo dell'intestazione di colonna.

cchTextMax

Tipo: int

Dimensioni in TCHARdel buffer a cui punta il membro pszText. Se la struttura non riceve informazioni su una colonna, questo membro viene ignorato.

iSubItem

Tipo: int

Indice dell'elemento secondario associato alla colonna.

iImage

Tipo: int

versione 4.70. Indice in base zero di un'immagine all'interno dell'elenco di immagini. L'immagine specificata verrà visualizzata all'interno della colonna.

iOrder

Tipo: int

versione 4.70. Offset di colonna in base zero. L'offset di colonna è in ordine da sinistra a destra. Ad esempio, zero indica la colonna più a sinistra.

cxMin

Tipo: int

Windows Vista. Larghezza minima della colonna in pixel.

cxDefault

Tipo: int

Windows Vista. Valore definito dall'applicazione usato in genere per archiviare la larghezza predefinita della colonna. Questo membro viene ignorato dal controllo visualizzazione elenco.

cxIdeal

Tipo: int

Windows Vista. Sola lettura. Larghezza ideale della colonna in pixel, in quanto la colonna può essere attualmente ridimensionata automaticamente in una larghezza inferiore.

Osservazioni

Se una colonna viene aggiunta a un controllo visualizzazione elenco con indice 0 (la colonna più a sinistra), viene sempre LVCFMT_LEFT. L'impostazione di altri flag sulla colonna 0 non esegue l'override di tale allineamento. Pertanto, se si continua a inserire colonne con indice 0, il testo in tutte le colonne viene allineato a sinistra. Se si desidera che la prima colonna sia allineata a destra o allineata al centro, è possibile creare una colonna fittizia, quindi inserire una o più colonne con indice 1 o superiore e specificare l'allineamento necessario. Eliminare infine la colonna fittizia.

Nota

L'intestazione commctrl.h definisce LVCOLUMN come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.