Struttura REBARBANDINFOA (commctrl.h)

  • Articolo

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;

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:

Valore Significato
RBBIM_BACKGROUND
 Il membro hbmBack è valido o deve essere impostato.
RBBIM_CHILD
 Il membro hwndChild è valido o deve essere impostato.
RBBIM_CHILDSIZE
 I membri cxMinChild, cyMinChild, cyChild, cyMaxChild e 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 dei seguenti elementi:

Valore Significato
RBBS_BREAK
 La band si trova 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 di espansione se la banda è più piccola 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
 Mantieni 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à 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 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ò 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 fino alla larghezza ideale (vedere RB_MAXIMIZEBAND), il controllo della barra di rebar 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 della 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 di 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 di stato oggetto.

Commenti

I membri cxMinChild, cyMinChild e 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 CCS_VERT , cxMinChild e cx sono misurazioni 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

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