CReBarCtrl-klass

Kapslar in funktionerna i en omlistekontroll, som är en container för ett underordnat fönster.

Syntax

class CReBarCtrl : public CWnd

Medlemmar

Offentliga konstruktorer

Offentliga metoder

Anmärkningar

Programmet där omlistkontrollen finns tilldelar det underordnade fönstret som finns i omlist-kontrollen till omlistringsbandet. Det underordnade fönstret är vanligtvis en annan vanlig kontroll.

Omlistningskontroller innehåller ett eller flera band. Varje band kan innehålla en kombination av ett gripfält, en bitmapp, en textetikett och ett underordnat fönster. Bandet kan bara innehålla ett av dessa objekt.

Omlistkontrollen kan visa det underordnade fönstret över en angiven bakgrundsbitmapp. Alla kontrollband för armeringsjärn kan ändras i storlek, förutom de som använder RBBS_FIXEDSIZE stil. När du flyttar eller ändrar storlek på ett omlistekontrollband hanterar omlistkontrollen storleken och positionen för det underordnade fönstret som tilldelats det bandet. Om du vill ändra storlek på eller ändra ordningen på band i kontrollen klickar du på och drar ett bands gripfält.

Följande bild visar en omlistkontroll som har tre band:

• Band 0 innehåller en platt, transparent verktygsfältskontroll.

• Band 1 innehåller både transparenta standardknappar och transparenta listruteknappar.

• Band 2 innehåller en kombinationsruta och fyra standardknappar.

  

Armeringskontroll

Stöd för omlistningskontroller:

• Bildlistor.

• Meddelandehantering.

• Anpassade dragningsfunktioner.

• En mängd olika kontrollformat utöver standardfönsterformat. En lista över dessa formatmallar finns i Omlisteringskontrollformat i Windows SDK.

Mer information finns i Använda CReBarCtrl.

Arvshierarki

CObject

CCmdTarget

CWnd

CReBarCtrl

Kravspecifikation

Rubrik: afxcmn.h

CReBarCtrl::BeginDrag

Implementerar beteendet för Win32-meddelandet RB_BEGINDRAG enligt beskrivningen i Windows SDK.

void BeginDrag(
    UINT uBand,
    DWORD dwPos = (DWORD)-1);

Parameterar

uBand
Nollbaserat index för det band som dra och släpp-åtgärden kommer att påverka.

dwPos
Ett DWORD-värde som innehåller startmuskoordinaterna. Den vågräta koordinaten finns i LOWORD och den lodräta koordinaten finns i HIWORD. Om du skickar (DWORD)-1 använder omstapelkontrollen musens position senast kontrollens tråd anropade GetMessage eller PeekMessage.

CReBarCtrl::Skapa

Skapar omlistkontrollen och kopplar den CReBarCtrl till objektet.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameterar

dwStyle
Anger kombinationen av omlisteringskontrollformat som tillämpas på kontrollen. En lista över formatmallar som stöds finns i Omliste-kontrollformat i Windows SDK.

rekt
En referens till ett CRect-objekt eller en RECT-struktur , som är positionen och storleken på omlistkontrollen.

pParentWnd
En pekare till ett CWnd-objekt som är det överordnade fönstret i omlistkontrollen. Den får inte vara NULL.

Nid
Anger kontrollens kontroll-ID.

Returvärde

Nonzero om objektet har skapats. annars 0.

Anmärkningar

Skapa en omlistkontroll i två steg:

1. Anropa CReBarCtrl för att konstruera ett CReBarCtrl objekt.

2. Anropa den här medlemsfunktionen, som skapar kontrollen för Windows-ompanelen och kopplar den CReBarCtrl till objektet.

När du anropar Createinitieras de vanliga kontrollerna.

Exempel

CReBarCtrl *pReBarCtrl = new CReBarCtrl();
CRect rect;
GetWindowRect(rect);
pReBarCtrl->Create(RBS_BANDBORDERS, rect, this, AFX_IDW_REBAR);

// Use ReBar Control.

delete pReBarCtrl;

CReBarCtrl::CreateEx

Skapar en kontroll (ett underordnat fönster) och associerar den med objektet CReBarCtrl.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameterar

dwExStyle
Anger den utökade stilen för kontrollen som skapas. En lista över utökade Windows-format finns i parametern dwExStyle för CreateWindowEx i Windows SDK.

dwStyle
Anger kombinationen av omlisteringskontrollformat som tillämpas på kontrollen. En lista över formatmallar som stöds finns i Visa kontrollformat i Windows SDK.

rekt
En referens till en RECT- struktur som beskriver storleken och positionen för fönstret som ska skapas, i klientkoordinater för pParentWnd.

pParentWnd
En pekare till det fönster som är kontrollens överordnade.

Nid
Kontrollens underordnade fönster-ID.

Returvärde

Nonzero om det lyckas; annars 0.

Anmärkningar

Använd CreateEx i stället för Skapa för att använda utökade Windows-formatmallar, som anges av windows utökade formatmallsförord WS_EX_.

CReBarCtrl::CReBarCtrl

Skapar ett CReBarCtrl objekt.

CReBarCtrl();

Exempel

Se exemplet för CReBarCtrl::Create.

CReBarCtrl::D eleteBand

Implementerar beteendet för Win32-meddelandet RB_DELETEBAND enligt beskrivningen i Windows SDK.

BOOL DeleteBand(UINT uBand);

Parameterar

uBand
Nollbaserat index för det band som ska tas bort.

Returvärde

Nonzero om bandet har tagits bort. annars noll.

Exempel

UINT nCount = m_wndReBar.GetReBarCtrl().GetBandCount();

if (nCount > 0)
   m_wndReBar.GetReBarCtrl().DeleteBand(nCount - 1);

CReBarCtrl::D ragMove

Implementerar beteendet för Win32-meddelandet RB_DRAGMOVE enligt beskrivningen i Windows SDK.

void DragMove(DWORD dwPos = (DWORD)-1);

Parameterar

dwPos
Ett DWORD-värde som innehåller de nya muskoordinaterna. Den vågräta koordinaten finns i LOWORD och den lodräta koordinaten finns i HIWORD. Om du skickar (DWORD)-1 använder omstapelkontrollen musens position senast kontrollens tråd anropade GetMessage eller PeekMessage.

CReBarCtrl::EndDrag

Implementerar beteendet för Win32-meddelandet RB_ENDDRAG enligt beskrivningen i Windows SDK.

void EndDrag();

CReBarCtrl::GetBandBorders

Implementerar beteendet för Win32-meddelandet RB_GETBANDBORDERS enligt beskrivningen i Windows SDK.

void GetBandBorders(
    UINT uBand,
    LPRECT prc) const;

Parameterar

uBand
Nollbaserat index för det band som kantlinjerna ska hämtas för.

Kina
En pekare till en RECT-struktur som tar emot bandkantlinjerna. Om kontrollen för ompanelen har RBS_BANDBORDERS formatmallen får varje medlem i den här strukturen antalet bildpunkter, på motsvarande sida av bandet, som utgör kantlinjen. Om kontrollen för omstapel inte har RBS_BANDBORDERS formatmall tar endast den vänstra medlemmen i den här strukturen emot giltig information. En beskrivning av omlistningskontrollformat finns i Omlisteringskontrollformat i Windows SDK.

CReBarCtrl::GetBandCount

Implementerar beteendet för Win32-meddelandet RB_GETBANDCOUNT enligt beskrivningen i Windows SDK.

UINT GetBandCount() const;

Returvärde

Antalet band som tilldelats kontrollen.

CReBarCtrl::GetBandInfo

Implementerar beteendet för Win32-meddelandet RB_GETBANDINFO enligt beskrivningen i Windows SDK.

BOOL GetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi) const;

Parameterar

uBand
Nollbaserat index för det band som informationen ska hämtas för.

prbbi
En pekare till en REBARBANDINFO-struktur för att ta emot bandinformationen. Du måste ange medlemmen i den cbSize här strukturen till sizeof(REBARBANDINFO) och ställa in fMask medlemmen på de objekt som du vill hämta innan du skickar det här meddelandet.

Returvärde

Nonzero om det lyckas; annars noll.

CReBarCtrl::GetBandMargins

Hämtar bandets marginaler.

void GetBandMargins(PMARGINS pMargins);

Parameterar

pMargins
En pekare till en MARGINALSTRUKTUR som tar emot informationen.

Anmärkningar

Den här medlemsfunktionen emulerar funktionerna i RB_GETBANDMARGINS-meddelandet enligt beskrivningen i Windows SDK.

CReBarCtrl::GetBarHeight

Hämtar höjden på stapeln.

UINT GetBarHeight() const;

Returvärde

Värde som representerar kontrollens höjd, i bildpunkter.

CReBarCtrl::GetBarInfo

Implementerar beteendet för Win32-meddelandet RB_GETBARINFO enligt beskrivningen i Windows SDK.

BOOL GetBarInfo(REBARINFO* prbi) const;

Parameterar

prbi
En pekare till en REBARINFO-struktur som tar emot kontrollinformationen för omstaken. Du måste ange cbSize-medlemmen i den här strukturen till sizeof(REBARINFO) innan du skickar det här meddelandet.

Returvärde

Nonzero om det lyckas; annars noll.

CReBarCtrl::GetBkColor

Implementerar beteendet för Win32-meddelandet RB_GETBKCOLOR enligt beskrivningen i Windows SDK.

COLORREF GetBkColor() const;

Returvärde

Ett COLORREF-värde som representerar den aktuella standardbakgrundsfärgen.

CReBarCtrl::GetColorScheme

Hämtar COLORSCHEME-strukturen för omlistkontrollen.

BOOL GetColorScheme(COLORSCHEME* lpcs);

Parameterar

lpcs
En pekare till en COLORSCHEME-struktur enligt beskrivningen i Windows SDK.

Returvärde

Nonzero om det lyckas; annars noll.

Anmärkningar

Strukturen COLORSCHEME innehåller knappens markeringsfärg och knappens skuggfärg.

CReBarCtrl::GetDropTarget

Implementerar beteendet för Win32-meddelandet RB_GETDROPTARGET enligt beskrivningen i Windows SDK.

IDropTarget* GetDropTarget() const;

Returvärde

En pekare till ett IDropTarget-gränssnitt .

CReBarCtrl::GetExtendedStyle

Hämtar de utökade formaten för den aktuella omlistekontrollen.

DWORD GetExtendedStyle() const;

Returvärde

En bitvis kombination (OR) av flaggor som anger de utökade formaten. De möjliga flaggorna är RBS_EX_SPLITTER och RBS_EX_TRANSPARENT. Mer information finns i parametern dwMask för metoden CReBarCtrl::SetExtendedStyle .

Anmärkningar

Den här metoden skickar meddelandet RB_GETEXTENDEDSTYLE , som beskrivs i Windows SDK.

CReBarCtrl::GetImageList

Hämtar objektet som CImageList är associerat med en omlistekontroll.

CImageList* GetImageList() const;

Returvärde

En pekare till ett CImageList-objekt . Returnerar NULL om ingen bildlista har angetts för kontrollen.

Anmärkningar

Den här medlemsfunktionen använder storleks- och maskinformation som lagras i REBARINFO-strukturen enligt beskrivningen i Windows SDK.

CReBarCtrl::GetPalette

Hämtar omlistkontrollens aktuella palett.

CPalette* GetPalette() const;

Returvärde

En pekare till ett CPalette-objekt som anger omlistkontrollens aktuella palett.

Anmärkningar

Observera att den här medlemsfunktionen använder ett CPalette objekt som sitt returvärde i stället för en HPALETTE.

Exempel

CPalette *pPalette = m_wndReBar.GetReBarCtrl().GetPalette();
if (pPalette)
{
   int nEntries = pPalette->GetEntryCount();
   CString msg;
   msg.Format(_T("Number of palette entries: %d"), nEntries);
   AfxMessageBox(msg);
}
else
{
   AfxMessageBox(_T("No palette!"));
}

CReBarCtrl::GetRect

Implementerar beteendet för Win32-meddelandet RB_GETRECT enligt beskrivningen i Windows SDK.

BOOL GetRect(
    UINT uBand,
    LPRECT prc) const;

Parameterar

uBand
Nollbaserat index för ett band i omlist-kontrollen.

Kina
En pekare till en RECT-struktur som tar emot gränserna för rebar-bandet.

Returvärde

Nonzero om det lyckas; annars noll.

Exempel

CRect rc;
m_wndReBar.GetReBarCtrl().GetRect(0, &rc);
CString msg;
msg.Format(_T("rect.left = %d, rect.top = %d, ")
           _T("rect.right = %d, rect.bottom = %d"),
           rc.left,
           rc.top, rc.right, rc.bottom);
AfxMessageBox(msg);

CReBarCtrl::GetRowCount

Implementerar beteendet för Win32-meddelandet RB_GETROWCOUNT enligt beskrivningen i Windows SDK.

UINT GetRowCount() const;

Returvärde

Ett UINT-värde som representerar antalet bandrader i kontrollen.

Exempel

UINT nRowCount = m_wndReBar.GetReBarCtrl().GetRowCount();
CString msg;
msg.Format(_T("Row Count is %d"), nRowCount);
AfxMessageBox(msg);

CReBarCtrl::GetRowHeight

Implementerar beteendet för Win32-meddelandet RB_GETROWHEIGHT enligt beskrivningen i Windows SDK.

UINT GetRowHeight(UINT uRow) const;

Parameterar

uRow
Nollbaserat index för det band som ska få sin höjd hämtad.

Returvärde

Ett UINT-värde som representerar radhöjden i bildpunkter.

Exempel

int nCount = m_wndReBar.GetReBarCtrl().GetRowCount();
for (int i = 0; i < nCount; i++)
{
   UINT nHeight = m_wndReBar.GetReBarCtrl().GetRowHeight(i);
   CString msg;
   msg.Format(_T("Height of row %d is %u"), i, nHeight);
   AfxMessageBox(msg);
}

CReBarCtrl::GetTextColor

Implementerar beteendet för Win32-meddelandet RB_GETTEXTCOLOR enligt beskrivningen i Windows SDK.

COLORREF GetTextColor() const;

Returvärde

Ett COLORREF-värde som representerar den aktuella standardtextfärgen.

CReBarCtrl::GetToolTips

Implementerar beteendet för Win32-meddelandet RB_GETTOOLTIPS enligt beskrivningen i Windows SDK.

CToolTipCtrl* GetToolTips() const;

Returvärde

En pekare till ett CToolTipCtrl-objekt .

Anmärkningar

Observera att MFC-implementeringen av GetToolTips returnerar en pekare till en CToolTipCtrl, i stället för en HWND.

CReBarCtrl::HitTest

Implementerar beteendet för Win32-meddelandet RB_HITTEST enligt beskrivningen i Windows SDK.

int HitTest(RBHITTESTINFO* prbht);

Parameterar

prbht
En pekare till en RBHITTESTINFO-struktur . Innan meddelandet skickas måste medlemmen i den pt här strukturen initieras till den punkt som ska testas i klientkoordinater.

Returvärde

Det nollbaserade indexet för bandet vid den angivna punkten, eller -1 om inget omlistband var vid tidpunkten.

CReBarCtrl::IDToIndex

Implementerar beteendet för Win32-meddelandet RB_IDTOINDEX enligt beskrivningen i Windows SDK.

int IDToIndex(UINT uBandID) const;

Parameterar

uBandID
Den programdefinierade identifieraren för det angivna bandet, som skickades i medlemmen i wIDREBARBANDINFO-strukturen när bandet infogas.

Returvärde

Det nollbaserade bandindexet om det lyckas eller -1 annat. Om dubbletter av bandindex finns returneras den första.

CReBarCtrl::InsertBand

Implementerar beteendet för Win32-meddelandet RB_INSERTBAND enligt beskrivningen i Windows SDK.

BOOL InsertBand(
    UINT uIndex,
    REBARBANDINFO* prbbi);

Parameterar

uIndex
Nollbaserat index för platsen där bandet ska infogas. Om du anger den här parametern till -1 lägger kontrollen till det nya bandet på den sista platsen.

prbbi
En pekare till en REBARBANDINFO-struktur som definierar det band som ska infogas. Du måste ange cbSize-medlemmen i den här strukturen till sizeof(REBARBANDINFO) innan du anropar den här funktionen.

Returvärde

Nonzero om det lyckas; annars noll.

Exempel

REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);

TCHAR szText[80];
rbbi.lpText = szText;
rbbi.cch = sizeof(szText) / sizeof(szText[0]);

rbbi.fMask = RBBIM_BACKGROUND | RBBIM_CHILD |
             RBBIM_CHILDSIZE | RBBIM_COLORS | RBBIM_HEADERSIZE |
             RBBIM_IDEALSIZE | RBBIM_ID | RBBIM_IMAGE |
             RBBIM_LPARAM | RBBIM_SIZE | RBBIM_STYLE | RBBIM_TEXT;

m_wndReBar.GetReBarCtrl().GetBandInfo(0, &rbbi);

m_wndReBar.GetReBarCtrl().InsertBand(1, &rbbi);

CReBarCtrl::MaximizeBand

Ändrar storlek på ett band i en omlistekontroll till sin största storlek.

void MaximizeBand(UINT uBand);

Parameterar

uBand
Nollbaserat index för bandet som ska maximeras.

Anmärkningar

Implementerar beteendet för Win32-meddelandet RB_MAXIMIZEBAND med fIdeal värdet 0, enligt beskrivningen i Windows SDK.

Exempel

CReBarCtrl& refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.MaximizeBand(i);   

CReBarCtrl::MinimizeBand

Ändrar storlek på ett band i en omlistekontroll till sin minsta storlek.

void MinimizeBand(UINT uBand);

Parameterar

uBand
Nollbaserat index för det band som ska minimeras.

Anmärkningar

Implementerar beteendet för Win32-meddelandet RB_MINIMIZEBAND enligt beskrivningen i Windows SDK.

Exempel

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.MinimizeBand(i);

CReBarCtrl::MoveBand

Implementerar beteendet för Win32-meddelandet RB_MOVEBAND enligt beskrivningen i Windows SDK.

BOOL MoveBand(
    UINT uFrom,
    UINT uTo);

Parameterar

uFrom
Nollbaserat index för det band som ska flyttas.

uTo
Nollbaserat index för den nya bandpositionen. Det här parametervärdet får aldrig vara större än antalet band minus ett. Om du vill hämta antalet band anropar du GetBandCount.

Returvärde

Nonzero om det lyckas; annars noll.

CReBarCtrl::P ushChevron

Implementerar beteendet för Win32-meddelandet RB_PUSHCHEVRON enligt beskrivningen i Windows SDK.

void PushChevron(
    UINT uBand,
    LPARAM lAppValue);

Parameterar

uBand
Nollbaserat index för bandet vars sparr ska push-överföras.

lAppValue
Ett program har definierat 32-bitarsvärde. Se lAppValue i RB_PUSHCHEVRON i Windows SDK.

CReBarCtrl::RestoreBand

Ändrar storlek på ett band i en omlistekontroll till den ideala storleken.

void RestoreBand(UINT uBand);

Parameterar

uBand
Nollbaserat index för bandet som ska maximeras.

Anmärkningar

Implementerar beteendet för Win32-meddelandet RB_MAXIMIZEBAND med fIdeal värdet 1, enligt beskrivningen i Windows SDK.

Exempel

CReBarCtrl &refReBarCtrl = m_wndReBar.GetReBarCtrl();
UINT nCount = refReBarCtrl.GetBandCount();

for (UINT i = 0; i < nCount; i++)
   refReBarCtrl.RestoreBand(i);

CReBarCtrl::SetBandInfo

Implementerar beteendet för Win32-meddelandet RB_SETBANDINFO enligt beskrivningen i Windows SDK.

BOOL SetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi);

Parameterar

uBand
Nollbaserat index för bandet för att ta emot de nya inställningarna.

prbbi
Pekare till en REBARBANDINFO-struktur som definierar det band som ska infogas. Du måste ange medlemmen i den cbSize här strukturen till sizeof(REBARBANDINFO) innan du skickar det här meddelandet.

Returvärde

Nonzero om det lyckas; annars noll.

Exempel

int nCount = m_wndReBar.GetReBarCtrl().GetBandCount();
CString strText;
REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);
for (int i = 0; i < nCount; i++)
{
   strText.Format(_T("Band #: %d"), i);
   rbbi.lpText = strText.GetBuffer();
   rbbi.cch = strText.GetLength() + 1;
   rbbi.fMask = RBBIM_TEXT;

   m_wndReBar.GetReBarCtrl().SetBandInfo(i, &rbbi);

   strText.ReleaseBuffer();
}

CReBarCtrl::SetBandWidth

Anger bredden på det angivna dockade bandet i den aktuella omlistkontrollen.

BOOL SetBandWidth(
    UINT uBand,
    int cxWidth);

Parameterar

uBand
[i] Nollbaserat index för ett omlistringsband.

cxWidth
[i] Ny bredd på omstapelbandet i bildpunkter.

Returvärde

TRUE om metoden lyckas. annars FALSKT.

Anmärkningar

Den här metoden skickar meddelandet RB_SETBANDWIDTH , som beskrivs i Windows SDK.

Exempel

I det första kodexemplet definieras variabeln , m_rebarsom används för att komma åt den aktuella omlistkontrollen. Den här variabeln används i nästa exempel.

public:
CReBarCtrl m_rebar;
BOOL bRet;
static const int TOTAL_BANDS = 5;
static const int BUFFER_SIZE = 10;

I nästa kodexempel anges varje omlisteband till samma bredd.

// Set the width of each band.
m_rebar.GetClientRect(&rect);
int iWidth = rect.Width() / TOTAL_BANDS;
for (int iIndex = 0; iIndex < TOTAL_BANDS; iIndex++)
   bRet = m_rebar.SetBandWidth(iIndex, iWidth);

CReBarCtrl::SetBarInfo

Implementerar beteendet för Win32-meddelandet RB_SETBARINFO enligt beskrivningen i Windows SDK.

BOOL SetBarInfo(REBARINFO* prbi);

Parameterar

prbi
En pekare till en REBARINFO-struktur som innehåller den information som ska anges. Du måste ange medlemmen i den cbSize här strukturen till sizeof(REBARINFO) innan du skickar det här meddelandet

Returvärde

Nonzero om det lyckas; annars noll.

Exempel

REBARINFO rbi = {0};
rbi.cbSize = sizeof(REBARINFO);
rbi.fMask = 0;
rbi.himl = 0;
m_wndReBar.GetReBarCtrl().SetBarInfo(&rbi);

CReBarCtrl::SetBkColor

Implementerar beteendet för Win32-meddelandet RB_SETBKCOLOR enligt beskrivningen i Windows SDK.

COLORREF SetBkColor(COLORREF clr);

Parameterar

Clr
COLORREF-värdet som representerar den nya standardbakgrundsfärgen.

Returvärde

Ett COLORREF-värde som representerar den tidigare standardbakgrundsfärgen.

Anmärkningar

Mer information om när du ska ange bakgrundsfärgen och hur du anger standardinställningen finns i det här avsnittet.

CReBarCtrl::SetColorScheme

Anger färgschemat för knapparna på en omlistekontroll.

void SetColorScheme(const COLORSCHEME* lpcs);

Parameterar

lpcs
En pekare till en COLORSCHEME-struktur enligt beskrivningen i Windows SDK.

Anmärkningar

Strukturen COLORSCHEME innehåller både knappens markeringsfärg och knappens skuggfärg.

CReBarCtrl::SetExtendedStyle

Anger de utökade formatmallarna för den aktuella omlistekontrollen.

DWORD SetExtendedStyle(
    DWORD dwMask,
    DWORD dwStyleEx);

Parameterar

dwMask
[i] En bitvis kombination (OR) av flaggor som anger vilka flaggor i dwStyleEx-parametern som ska tillämpas. Använd ett eller flera av följande värden:

• RBS_EX_SPLITTER: Som standard visar du splittern längst ned i vågrätt läge och till höger i lodrätt läge.
• RBS_EX_TRANSPARENT: Vidarebefordra meddelandet WM_ERASEBKGND till det överordnade fönstret.

dwStyleEx
[i] En bitvis kombination (OR) av flaggor som anger vilka formatmallar som ska tillämpas. Om du vill ange ett format anger du samma flagga som används i parametern dwMask . Om du vill återställa ett format anger du binär noll.

Returvärde

Det tidigare utökade formatet.

Anmärkningar

Den här metoden skickar meddelandet RB_SETEXTENDEDSTYLE , som beskrivs i Windows SDK.

CReBarCtrl::SetImageList

Tilldelar en bildlista till en omlistekontroll.

BOOL SetImageList(CImageList* pImageList);

Parameterar

pImageList
En pekare till ett CImageList-objekt som innehåller den bildlista som ska tilldelas till omlist-kontrollen.

Returvärde

Nonzero om det lyckas; annars noll.

CReBarCtrl::SetOwner

Implementerar beteendet för Win32-meddelandet RB_SETPARENT enligt beskrivningen i Windows SDK.

CWnd* SetOwner(CWnd* pWnd);

Parameterar

pWnd
En pekare till ett CWnd objekt som ska anges som ägare till omlistkontrollen.

Returvärde

En pekare till ett CWnd-objekt som är den aktuella ägaren av kontrollen.

Anmärkningar

Observera att den här medlemsfunktionen använder pekare till CWnd objekt för både den aktuella och valda ägaren av omlist-kontrollen i stället för handtag till fönster.

CReBarCtrl::SetPalette

Implementerar beteendet för Win32-meddelandet RB_SETPALETTE enligt beskrivningen i Windows SDK.

CPalette* SetPalette(HPALETTE hPal);

Parameterar

hPal
En HPALETTE som anger den nya paletten som omlistkontrollen ska använda.

Returvärde

En pekare till ett CPalette-objekt som anger omlistkontrollens föregående palett.

Anmärkningar

Observera att den här medlemsfunktionen använder ett CPalette objekt som sitt returvärde i stället för en HPALETTE.

CReBarCtrl::SetTextColor

Implementerar beteendet för Win32-meddelandet RB_SETTEXTCOLOR enligt beskrivningen i Windows SDK.

COLORREF SetTextColor(COLORREF clr);

Parameterar

Clr
Ett COLORREF-värde som representerar den nya textfärgen CReBarCtrl i objektet.

Returvärde

COLORREF-värdet som representerar den tidigare textfärgen CReBarCtrl som är associerad med objektet.

Anmärkningar

Den tillhandahålls för att ge stöd för flexibilitet i textfärg i en omlistekontroll.

CReBarCtrl::SetToolTips

Associerar en knappbeskrivningskontroll med en omlistkontroll.

void SetToolTips(CToolTipCtrl* pToolTip);

Parameterar

pToolTip
En pekare till ett CToolTipCtrl-objekt

Anmärkningar

Du måste förstöra CToolTipCtrl objektet när du är klar med det.

CReBarCtrl::SetWindowTheme

Anger det visuella formatet för omlistkontrollen.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parameterar

pszSubAppName
En pekare till en Unicode-sträng som innehåller det visuella formatmallen för omlistning som ska anges.

Returvärde

Returvärdet används inte.

Anmärkningar

Den här medlemsfunktionen emulerar funktionerna i RB_SETWINDOWTHEME-meddelandet enligt beskrivningen i Windows SDK.

CReBarCtrl::ShowBand

Implementerar beteendet för Win32-meddelandet RB_SHOWBAND enligt beskrivningen i Windows SDK.

BOOL ShowBand(
    UINT uBand,
    BOOL fShow = TRUE);

Parameterar

uBand
Nollbaserat index för ett band i omlist-kontrollen.

fShow
Anger om bandet ska visas eller döljas. Om det här värdet är TRUE visas bandet. Annars döljs bandet.

Returvärde

Nonzero om det lyckas; annars noll.

CReBarCtrl::SizeToRect

Implementerar beteendet för Win32-meddelandet RB_SIZETORECT, enligt beskrivningen i Windows SDK.

BOOL SizeToRect(CRect& rect);

Parameterar

rekt
En referens till ett CRect-objekt som anger den rektangel som omlistkontrollen ska vara storleksanpassad till.

Returvärde

Nonzero om det lyckas; annars noll.

Anmärkningar

Observera att den här medlemsfunktionen använder ett CRect objekt som en parameter i stället för en RECT struktur.

Se även

CWnd-klass
hierarkidiagram