Struttura LVGROUP (commctrl.h)

  • Articolo

Consente di impostare e recuperare gruppi.

Sintassi

typedef struct tagLVGROUP {
  UINT   cbSize;
  UINT   mask;
  LPWSTR pszHeader;
  int    cchHeader;
  LPWSTR pszFooter;
  int    cchFooter;
  int    iGroupId;
  UINT   stateMask;
  UINT   state;
  UINT   uAlign;
  LPWSTR pszSubtitle;
  UINT   cchSubtitle;
  LPWSTR pszTask;
  UINT   cchTask;
  LPWSTR pszDescriptionTop;
  UINT   cchDescriptionTop;
  LPWSTR pszDescriptionBottom;
  UINT   cchDescriptionBottom;
  int    iTitleImage;
  int    iExtendedImage;
  int    iFirstItem;
  UINT   cItems;
  LPWSTR pszSubsetTitle;
  UINT   cchSubsetTitle;
} LVGROUP, *PLVGROUP;

Members

cbSize

Tipo: UINT

Dimensioni di questa struttura, in byte.

mask

Tipo: UINT

Maschera che specifica quali membri della struttura sono input validi. Uno o più dei valori seguenti:

Valore Significato
LVGF_NONE
 Nessun altro elemento valido.
LVGF_HEADER
 I membri pszHeader e cchHeader sono validi.
LVGF_FOOTER
 I membri pszFooter e cchFooter sono validi.
LVGF_STATE
 state e stateMask membri sono validi.
LVGF_ALIGN
 Membro uAlign valido.
LVGF_GROUPID
 Membro iGroupId valido.
LVGF_SUBTITLE

Versione 6.00 e successive. Il membro pszSubtitle è valido.
LVGF_TASK

Versione 6.00 e successive. Il membro pszTask è valido.
LVGF_DESCRIPTIONTOP

Versione 6.00 e successive. Il membro pszDescriptionTop è valido.
LVGF_DESCRIPTIONBOTTOM

Versione 6.00 e successive. Il membro pszDescriptionBottom è valido.
LVGF_TITLEIMAGE

Versione 6.00 e successive. Il membro iTitleImage è valido.
LVGF_EXTENDEDIMAGE

Versione 6.00 e successive. Il membro iExtendedImage è valido.
LVGF_ITEMS

Versione 6.00 e successive. Il membro cItems è valido.
LVGF_SUBSET

Versione 6.00 e successive. Il membro pszSubsetTitle è valido.
LVGF_SUBSETITEMS

Versione 6.00 e successive. Il membro cchSubsetTitle è valido.

pszHeader

Tipo: LPWSTR

Puntatore a una stringa con terminazione Null che contiene il testo dell'intestazione quando vengono impostate le informazioni sull'elemento. Se le informazioni sul gruppo vengono recuperate, questo membro specifica l'indirizzo del buffer che riceve il testo dell'intestazione.

cchHeader

Tipo: int

Dimensione in TCHARs del buffer a cui punta il membro pszHeader . Se la struttura non riceve informazioni su un gruppo, questo membro viene ignorato.

pszFooter

Tipo: LPWSTR

Puntatore a una stringa con terminazione Null che contiene il testo del piè di pagina quando vengono impostate le informazioni sull'elemento. Se le informazioni sul gruppo vengono recuperate, questo membro specifica l'indirizzo del buffer che riceve il testo del piè di pagina.

cchFooter

Tipo: int

Dimensione in TCHARs del buffer a cui punta il membro pszFooter . Se la struttura non riceve informazioni su un gruppo, questo membro viene ignorato.

iGroupId

Tipo: int

ID del gruppo.

stateMask

Tipo: UINT

Maschera utilizzata con LVM_GETGROUPINFO e LVM_SETGROUPINFO per specificare quali flag nel valore di stato vengono recuperati o impostati.

state

Tipo: UINT

Flag che può avere uno dei valori seguenti:

Valore Significato
LVGS_NORMAL
 I gruppi vengono espansi, viene visualizzato il nome del gruppo e vengono visualizzati tutti gli elementi del gruppo.
LVGS_COLLAPSED
 Il gruppo è compresso.
LVGS_HIDDEN
 Il gruppo è nascosto.
LVGS_NOHEADER

Versione 6.00 e successive. Il gruppo non visualizza un'intestazione.
LVGS_COLLAPSIBLE

Versione 6.00 e successive. Il gruppo può essere compresso.
LVGS_FOCUSED

Versione 6.00 e successive. Il gruppo ha lo stato attivo della tastiera.
LVGS_SELECTED

Versione 6.00 e successive. Il gruppo è selezionato.
LVGS_SUBSETED

Versione 6.00 e successive. Il gruppo visualizza solo una parte dei relativi elementi.
LVGS_SUBSETLINKFOCUSED

Versione 6.00 e successive. Il collegamento del subset del gruppo ha lo stato attivo della tastiera.

uAlign

Tipo: UINT

Indica l'allineamento del testo dell'intestazione o del piè di pagina per il gruppo. Può avere uno o più dei valori seguenti. Usare uno dei flag di intestazione. I flag piè di pagina sono facoltativi.

Valore Significato
LVGA_FOOTER_CENTER
 Il testo del piè di pagina è centrato orizzontalmente nella finestra.
LVGA_FOOTER_LEFT
 Il testo del piè di pagina è allineato a sinistra della finestra.
LVGA_FOOTER_RIGHT
 Il testo del piè di pagina è allineato a destra della finestra.
LVGA_HEADER_CENTER
 Il testo dell'intestazione è centrato orizzontalmente nella finestra.
LVGA_HEADER_LEFT
 Il testo dell'intestazione è allineato a sinistra della finestra.
LVGA_HEADER_RIGHT
 Il testo dell'intestazione è allineato a destra della finestra.

pszSubtitle

Tipo: LPWSTR

Puntatore a una stringa con terminazione Null che contiene il testo del sottotitolo quando vengono impostate le informazioni sull'elemento. Se le informazioni sul gruppo vengono recuperate, questo membro specifica l'indirizzo del buffer che riceve il testo del sottotitolo. Questo elemento viene disegnato sotto il testo dell'intestazione.

cchSubtitle

Tipo: UINT

Dimensioni, in TCHARs, del buffer a cui punta il membro pszSubtitle . Se la struttura non riceve informazioni su un gruppo, questo membro viene ignorato.

pszTask

Tipo: LPWSTR

Puntatore a una stringa con terminazione Null che contiene il testo per un collegamento a un'attività quando vengono impostate le informazioni sull'elemento. Se le informazioni sul gruppo vengono recuperate, questo membro specifica l'indirizzo del buffer che riceve il testo dell'attività. Questo elemento viene disegnato a destra in senso opposto al testo dell'intestazione. Quando si fa clic sull'utente, il collegamento all'attività genera una notifica di LVN_LINKCLICK .

cchTask

Tipo: UINT

Dimensioni in TCHARdel buffer a cui punta il membro pszTask . Se la struttura non riceve informazioni su un gruppo, questo membro viene ignorato.

pszDescriptionTop

Tipo: LPWSTR

Puntatore a una stringa con terminazione Null contenente il testo della descrizione superiore quando vengono impostate le informazioni sull'elemento. Se le informazioni sul gruppo vengono recuperate, questo membro specifica l'indirizzo del buffer che riceve il testo della descrizione superiore. Questo elemento viene disegnato di fronte all'immagine del titolo quando è presente un'immagine del titolo, nessuna immagine estesa e uAlign==LVGA_HEADER_CENTER.

cchDescriptionTop

Tipo: UINT

Dimensioni in TCHARdel buffer a cui punta il membro pszDescriptionTop . Se la struttura non riceve informazioni su un gruppo, questo membro viene ignorato.

pszDescriptionBottom

Tipo: LPWSTR

Puntatore a una stringa con terminazione Null contenente il testo della descrizione inferiore quando vengono impostate le informazioni sull'elemento. Se le informazioni sul gruppo vengono recuperate, questo membro specifica l'indirizzo del buffer che riceve il testo della descrizione inferiore. Questo elemento viene disegnato sotto il testo della descrizione superiore quando è presente un'immagine del titolo, nessuna immagine estesa e uAlign==LVGA_HEADER_CENTER.

cchDescriptionBottom

Tipo: UINT

Dimensioni in TCHARdel buffer a cui punta il membro pszDescriptionBottom . Se la struttura non riceve informazioni su un gruppo, questo membro viene ignorato.

iTitleImage

Tipo: int

Indice dell'immagine del titolo nell'elenco immagini del controllo.

iExtendedImage

Tipo: int

Indice dell'immagine estesa nell'elenco di immagini del controllo.

iFirstItem

Tipo: int

Di sola lettura.

cItems

Tipo: UINT

Sola lettura in modalità dati non proprietari.

pszSubsetTitle

Tipo: LPWSTR

NULL se il gruppo non è un subset. Puntatore a una stringa con terminazione Null che contiene il testo del titolo del subset quando vengono impostate le informazioni sull'elemento. Se le informazioni sul gruppo vengono recuperate, questo membro specifica l'indirizzo del buffer che riceve il testo del titolo del subset.

cchSubsetTitle

Tipo: UINT

Dimensioni in TCHARdel buffer a cui punta il membro pszSubsetTitle . Se la struttura non riceve informazioni su un gruppo, questo membro viene ignorato.

Commenti

Tutte le stringhe restituite in questa struttura devono essere considerate di sola lettura.

La creazione di subset non è attualmente supportata e pszSubsetTitle non può essere impostata dalle applicazioni.

Requisiti

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