Struttura REBARBANDINFOW (commctrl.h)

Contiene informazioni che definiscono una banda in un controllo rebar.

Sintassi

typedef struct tagREBARBANDINFOW {
  UINT     cbSize;
  UINT     fMask;
  UINT     fStyle;
  COLORREF clrFore;
  COLORREF clrBack;
  LPWSTR   lpText;
  UINT     cch;
  int      iImage;
  HWND     hwndChild;
  UINT     cxMinChild;
  UINT     cyMinChild;
  UINT     cx;
  HBITMAP  hbmBack;
  UINT     wID;
  UINT     cyChild;
  UINT     cyMaxChild;
  UINT     cyIntegral;
  UINT     cxIdeal;
  LPARAM   lParam;
  UINT     cxHeader;
  RECT     rcChevronLocation;
  UINT     uChevronState;
} REBARBANDINFOW, *LPREBARBANDINFOW;

Members

cbSize

Tipo: UINT

Dimensioni di questa struttura, in byte. L'applicazione deve compilare questo membro prima di inviare eventuali messaggi che usano l'indirizzo di questa struttura come parametro.

fMask

Tipo: UINT

Flag che indicano quali membri di questa struttura sono validi o devono essere compilati. Questo valore può essere una combinazione dei seguenti elementi:

fStyle

Tipo: UINT

Flag che specificano lo stile della banda. Questo valore può essere una combinazione dei seguenti elementi:

clrFore

Tipo: COLORREF

Colori di primo piano della banda.

clrBack

Tipo: COLORREF

Colori di sfondo della banda. Se hbmBack specifica una bitmap di sfondo, questi membri vengono ignorati. Per impostazione predefinita, la banda userà il colore di sfondo del controllo rebar impostato con il messaggio RB_SETBKCOLOR . Se in questo caso viene specificato un colore di sfondo, verrà usato questo colore di sfondo.

lpText

Tipo: LPTSTR

Puntatore a un buffer contenente il testo visualizzato per la banda. Se le informazioni sulla banda vengono richieste dal controllo e RBBIM_TEXT viene specificato in fMask, questo membro deve essere inizializzato all'indirizzo del buffer che riceverà il testo.

cch

Tipo: UINT

Dimensioni del buffer in byte in lpText. Se le informazioni non vengono richieste dal controllo , questo membro viene ignorato.

iImage

Tipo: int

Indice in base zero di qualsiasi immagine che deve essere visualizzata nella banda. L'elenco di immagini viene impostato usando il messaggio RB_SETBARINFO .

hwndChild

Tipo: HWND

Gestire nella finestra figlio contenuta nella banda, se presente.

cxMinChild

Tipo: UINT

Larghezza minima della finestra figlio, in pixel. La banda non può essere ridimensionata più piccola di questo valore.

cyMinChild

Tipo: UINT

Altezza minima della finestra figlio, in pixel. La banda non può essere ridimensionata più piccola di questo valore.

cx

Tipo: UINT

Lunghezza della banda, in pixel.

hbmBack

Tipo: HBITMAP

Handle in una bitmap usata come sfondo per questa band.

wID

Tipo: UINT

Valore UINT usato dal controllo per identificare questa banda per i messaggi di notifica di disegno personalizzati.

cyChild

Tipo: UINT

Versione 4.71. Altezza iniziale della banda, in pixel. Questo membro viene ignorato a meno che non venga specificato lo stile RBBS_VARIABLEHEIGHT.

cyMaxChild

Tipo: UINT

Versione 4.71. Altezza massima della banda, in pixel. Questo membro viene ignorato a meno che non venga specificato lo stile RBBS_VARIABLEHEIGHT.

cyIntegral

Tipo: UINT

Versione 4.71. Valore passo in base al quale la banda può crescere o compattare, in pixel. Se la banda viene ridimensionata, verrà ridimensionata nei passaggi specificati da questo valore. Questo membro viene ignorato a meno che non venga specificato lo stile RBBS_VARIABLEHEIGHT.

cxIdeal

Tipo: UINT

Versione 4.71. Larghezza ideale della banda, in pixel. Se la banda è ingrandita alla larghezza ideale (vedere RB_MAXIMIZEBAND), il controllo della barra di ribar tenterà di rendere la banda questa larghezza.

lParam

Tipo: LPARAM

Versione 4.71. Valore definito dall'applicazione.

cxHeader

Tipo: UINT

Versione 4.71. Dimensioni dell'intestazione della band, in pixel. L'intestazione band è l'area tra il bordo della banda e il bordo della finestra figlio. Questa è l'area in cui vengono visualizzati testo band e immagini, se specificati. Se questo valore è specificato, eseguirà l'override delle dimensioni di intestazione normali calcolate dal controllo per la banda.

rcChevronLocation

Tipo: RECT

Versione 6. Posizione della chevron.

uChevronState

Tipo: UINT

Versione 6. Combinazione delle costanti stato oggetto.

Commenti

I membri cxMinChild, cyMinChild e cx forniscono informazioni sulle dimensioni relative all'orientamento del controllo. Vale a dire, per un controllo rebar orizzontale, cxMinChild e cx sono misurazioni orizzontali e cyMinChild è una misura verticale. Tuttavia, se il controllo usa lo stile CCS_VERT , cxMinChild e cx sono misurazioni verticali e cyMinChild è una misura orizzontale.

Requisiti