Condividi tramite

Struttura LVCOLUMNA (commctrl.h)

  • Articolo

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;

Members

mask

Tipo: UINT

Variabile che specifica i membri che 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 è allineato al centro.
LVCFMT_JUSTIFYMASK
 Maschera di bit usata per selezionare i bit di fmt che controllano la giustificazione del campo. 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 sono impostati i bit di LVCFMT_LEFT, LVCFMT_RIGHT o 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 regola il ridimensionamento della larghezza fissa.
LVCFMT_FIXED_RATIO

Versione 6.00 e Windows Vista. La larghezza aumenta con l'altezza della riga.
LVCFMT_SPLITBUTTON

Versione 6.00 e Windows Vista. La 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. Di sola lettura. La larghezza ideale della colonna in pixel, in quanto la colonna può essere attualmente automaticamente ridimensionata in una larghezza minore.

Commenti

Se una colonna viene aggiunta a un controllo di visualizzazione elenco con indice 0 (la colonna più a sinistra), è sempre LVCFMT_LEFT. L'impostazione di altri flag sulla colonna 0 non esegue l'override di tale allineamento. Pertanto, se si continuano a inserire colonne con indice 0, il testo in tutte le colonne viene allineato a sinistra. Se si vuole che la prima colonna sia allineata a destra o centrata, è 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione commctrl.h

Vedi anche

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

Riferimento