Struttura REBARBANDINFOA (commctrl.h)

Articolo
11/18/2024

Contiene informazioni che definiscono una banda in un controllo rebar.

Sintassi

typedef struct tagREBARBANDINFOA {
  UINT     cbSize;
  UINT     fMask;
  UINT     fStyle;
  COLORREF clrFore;
  COLORREF clrBack;
  LPSTR    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;
} REBARBANDINFOA, *LPREBARBANDINFOA;

Membri

cbSize

Tipo: UINT

Dimensioni di questa struttura, in byte. L'applicazione deve compilare questo membro prima di inviare 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 di quanto segue:

Valore	Significato
RBBIM_BACKGROUND	Il membro hbmBack è valido o deve essere impostato.
RBBIM_CHILD	Il membro hwndChild è valido o deve essere impostato.
RBBIM_CHILDSIZE	Il cxMinChild, cyMinChild, cyChild, cyMaxChilde membri cyIntegral sono validi o devono essere impostati.
RBBIM_COLORS	I membri clrFore e clrBack sono validi o devono essere impostati.
RBBIM_HEADERSIZE	versione 4.71. Il membro cxHeader è valido o deve essere impostato.
RBBIM_IDEALSIZE	versione 4.71. Il membro cxIdeal è valido o deve essere impostato.
RBBIM_ID	Il membro wID è valido o deve essere impostato.
RBBIM_IMAGE	Il membro iImage è valido o deve essere impostato.
RBBIM_LPARAM	versione 4.71. Il membro lParam è valido o deve essere impostato.
RBBIM_SIZE	Il membro cx è valido o deve essere impostato.
RBBIM_STYLE	Il membro fStyle è valido o deve essere impostato.
RBBIM_TEXT	Il membro lpText è valido o deve essere impostato.
RBBIM_CHEVRONLOCATION	Il membro rcChevronLocation è valido o deve essere impostato.
RBBIM_CHEVRONSTATE	Il membro uChevronState è valido o deve essere impostato.

fStyle

Tipo: UINT

Flag che specificano lo stile della banda. Questo valore può essere una combinazione di quanto segue:

Valore	Significato
RBBS_BREAK	La band è su una nuova linea.
RBBS_CHILDEDGE	La banda ha un bordo nella parte superiore e inferiore della finestra figlio.
RBBS_FIXEDBMP	La bitmap di sfondo non si sposta quando la banda viene ridimensionata.
RBBS_FIXEDSIZE	La banda non può essere ridimensionata. Con questo stile, il grip di ridimensionamento non viene visualizzato sulla banda.
RBBS_GRIPPERALWAYS	versione 4.71. La banda avrà sempre una presa di ridimensionamento, anche se è l'unica banda nella barra di rebar.
RBBS_HIDDEN	La banda non sarà visibile.
RBBS_NOGRIPPER	versione 4.71. La banda non avrà mai una presa di ridimensionamento, anche se c'è più di una banda nella barra di rebar.
RBBS_USECHEVRON	Versione 5.80. Mostra un pulsante freccia di espansione se la banda è minore di cxIdeal.
RBBS_VARIABLEHEIGHT	versione 4.71. La banda può essere ridimensionata dal controllo rebar; cyIntegral e cyMaxChild influiscono sul modo in cui la barra di ridimensionamento della banda.
RBBS_NOVERT	Non visualizzare quando è verticale.
RBBS_HIDETITLE	Mantenere nascosto il titolo della banda.
RBBS_TOPALIGN	Mantieni la banda nella riga superiore.

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à invece usato questo colore di sfondo.

lpText

Tipo: LPTSTR

Puntatore a un buffer che contiene 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 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 di RB_SETBARINFO.

hwndChild

Tipo: HWND

Handle per la 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 per una bitmap usata come sfondo per questa banda.

wID

Tipo: UINT

Valore UINT utilizzato 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ò aumentare o ridurre, 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 fino alla larghezza ideale (vedere RB_MAXIMIZEBAND), il controllo barra di ripetizione 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 banda, in pixel. L'intestazione di banda è l'area tra il bordo della banda e il bordo della finestra figlio. Si tratta dell'area in cui vengono visualizzati testo e immagini a banda, se specificati. Se questo valore viene specificato, eseguirà l'override delle dimensioni di intestazione normali calcolate dal controllo per la banda.

rcChevronLocation

Tipo: RECT

versione 6. Posizione della freccia di espansione.

uChevronState

Tipo: UINT

versione 6. Combinazione delle costanti dello stato dell'oggetto .

Osservazioni

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

Nota

L'intestazione commctrl.h definisce REBARBANDINFO come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
intestazione	commctrl.h

Condividi tramite

Struttura REBARBANDINFOA (commctrl.h)

Sintassi

Membri

Osservazioni

Fabbisogno

Commenti e suggerimenti

Risorse aggiuntive