Struttura LVGROUP (commctrl.h)

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:

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:

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.

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