Struttura LVCOLUMNA (commctrl.h)
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 |
---|---|
|
Il membro fmt è valido. |
|
Il membro cx è valido. |
|
Il membro pszText è valido. |
|
Il membro iSubItem è valido. |
|
Versione 4.70. Il membro iImage è valido. |
|
Versione 4.70. Il membro iOrder è valido. |
|
Versione 6.00 e Windows Vista.Il membro cxMin è valido. |
|
Versione 6.00 e Windows Vista.Il membro cxDefault è valido. |
|
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 |
---|---|
|
Il testo è allineato a sinistra. |
|
Il testo è allineato a destra. |
|
Il testo è allineato al centro. |
|
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. |
|
Versione 4.70. L'elemento visualizza un'immagine da un elenco di immagini. |
|
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. |
|
Versione 4.70. L'elemento di intestazione contiene un'immagine nell'elenco di immagini. |
|
Versione 6.00 e Windows Vista. Non è possibile ridimensionare la colonna; uguale a HDF_FIXEDWIDTH. |
|
Versione 6.00 e Windows Vista. Se non è impostato, CCM_DPISCALE regola il ridimensionamento della larghezza fissa. |
|
Versione 6.00 e Windows Vista. La larghezza aumenta con l'altezza della riga. |
|
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
Riferimento