CReBarCtrl osztály

A gyermekablak tárolójának számító sávvezérlő funkcióit foglalja magában.

Szemantika

class CReBarCtrl : public CWnd

Tagok

Nyilvános konstruktorok

Név	Leírás
CReBarCtrl::CReBarCtrl	Egy CReBarCtrl objektumot hoz létre.

Nyilvános metódusok

Név	Leírás
CReBarCtrl::BeginDrag	A rebar vezérlőt húzási módban helyezi el.
CReBarCtrl::Létrehozás	Létrehozza a rebar vezérlőt, és csatolja az CReBarCtrl objektumhoz.
CReBarCtrl::CreateEx	Létrehoz egy sávvezérlőt a megadott Bővített Windows-stílusokkal, és csatolja azt egy CReBarCtrl objektumhoz.
CReBarCtrl::D eleteBand	Sáv törlése egy sávvezérlőből.
CReBarCtrl::D ragMove	Frissíti a rebar vezérlő húzási pozícióját BeginDraga hívás után.
CReBarCtrl::EndDrag	Leállítja a rebar vezérlő húzási műveletét.
CReBarCtrl::GetBandBorders	Beolvassa egy sáv szegélyeit.
CReBarCtrl::GetBandCount	Lekéri a sávvezérlőben jelenleg lévő sávok számát.
CReBarCtrl::GetBandInfo	Egy adott sáv adatainak lekérése egy rebar vezérlőelemben.
CReBarCtrl::GetBandMargins	Egy sáv margóit kéri le.
CReBarCtrl::GetBarHeight	Lekéri a sávvezérlő magasságát.
CReBarCtrl::GetBarInfo	Adatokat kér le a sávvezérlőről és az általa használt képlistáról.
CReBarCtrl::GetBkColor	Lekéri a rebar vezérlő alapértelmezett háttérszínét.
CReBarCtrl::GetColorScheme	Lekéri a rebar vezérlőelemhez társított COLORSCHEME-struktúrát .
CReBarCtrl::GetDropTarget	Lekéri a rebar vezérlő felületi mutatóját IDropTarget .
CReBarCtrl::GetExtendedStyle	Lekéri az aktuális sávvezérlő kiterjesztett stílusát.
CReBarCtrl::GetImageList	Lekéri a rebar vezérlőelemhez társított képlistát.
CReBarCtrl::GetPalette	Lekéri a sávvezérlő aktuális palettáját.
CReBarCtrl::GetRect	Lekéri egy adott sáv határolókeretét egy sávvezérlőben.
CReBarCtrl::GetRowCount	Lekéri a sávsorok számát egy rebar vezérlőelemben.
CReBarCtrl::GetRowHeight	Lekéri egy adott sor magasságát egy rebar vezérlőelemben.
CReBarCtrl::GetTextColor	Beolvassa a rebar vezérlő alapértelmezett szövegszínét.
CReBarCtrl::GetToolTips	Lekéri a fogópontot a rebar vezérlőelemhez társított szerszámhegy-vezérlőhöz.
CReBarCtrl::HitTest	Meghatározza, hogy egy sáv melyik része található a képernyőn egy adott ponton, ha az adott ponton van egy sávsáv.
CReBarCtrl::IDToIndex	Sávazonosítót (ID) sávindexpé alakít át egy sávvezérlőben.
CReBarCtrl::InsertBand	Új sáv beszúrása egy sávvezérlőbe.
CReBarCtrl::MaximizeBand	Átméretez egy sávot egy sáv vezérlőelemben a legnagyobb méretre.
CReBarCtrl::MinimizeBand	Átméretez egy sávot egy rebar vezérlőben a legkisebb méretre.
CReBarCtrl::MoveBand	Sáv áthelyezése egyik indexből a másikba.
CReBarCtrl::P ushChevron	Programozott módon leküld egy chevront.
CReBarCtrl::RestoreBand	Átméretez egy sávot egy sávvezérlőben az ideális méretre.
CReBarCtrl::SetBandInfo	Egy meglévő sáv jellemzőit állítja be egy rebar vezérlőelemben.
CReBarCtrl::SetBandWidth	Beállítja a megadott rögzített sáv szélességét az aktuális sávvezérlőben.
CReBarCtrl::SetBarInfo	Beállítja a sávvezérlő jellemzőit.
CReBarCtrl::SetBkColor	Beállítja a sávvezérlő alapértelmezett háttérszínét.
CReBarCtrl::SetColorScheme	Beállítja a gombok színsémát egy rebar vezérlőelemen.
CReBarCtrl::SetExtendedStyle	Az aktuális sávvezérlő kiterjesztett stílusainak beállítása.
CReBarCtrl::SetImageList	Beállítja a rebar vezérlő képlistáját.
CReBarCtrl::SetOwner	Beállítja a sávvezérlő tulajdonosi ablakát.
CReBarCtrl::SetPalette	Beállítja a sávvezérlő aktuális palettáját.
CReBarCtrl::SetTextColor	Beállítja a sávvezérlő alapértelmezett szövegszínét.
CReBarCtrl::SetToolTips	Eszközleírás-vezérlő társítása a rebar vezérlővel.
CReBarCtrl::SetWindowTheme	Beállítja a sávvezérlő vizuális stílusát.
CReBarCtrl::ShowBand	Egy adott sáv megjelenítése vagy elrejtése egy sávvezérlőben.
CReBarCtrl::SizeToRect	Egy adott téglalaphoz illeszti a sávvezérlőt.

Megjegyzések

Az az alkalmazás, amelyben a sávvezérlő található, hozzárendeli a rebar vezérlő által tartalmazott gyermekablakot a sávsávhoz. A gyermekablak általában egy másik gyakori vezérlő.

A sávvezérlők egy vagy több sávot tartalmaznak. Minden sáv tartalmazhat fogósáv, bitkép, szövegfelirat és gyermekablak kombinációját. A sáv csak egy ilyen elemet tartalmazhat.

A rebar vezérlő megjelenítheti a gyermekablakot egy megadott háttérbitképen. Az összes rebar vezérlősáv átméretezhető, kivéve azokat, amelyek a RBBS_FIXEDSIZE stílust használják. Amikor áthelyez vagy átméretez egy sávvezérlő sávot, a sávvezérlő kezeli a sávhoz rendelt gyermekablak méretét és pozícióját. A vezérlőelemen belüli sávok sorrendjének átméretezéséhez vagy módosításához kattintson és húzza a sáv fogósávját.

Az alábbi ábrán egy három sávból álló sávvezérlő látható:

• A 0 sáv egy lapos, áttetsző eszköztár vezérlőelemet tartalmaz.

• Az 1. sáv transzparens standard és átlátszó legördülő gombokat is tartalmaz.

• A 2. sáv egy kombinált listát és négy szabványos gombot tartalmaz.

  

Betonacél ellenőrzés

A rebar vezérlők támogatása:

• Képlisták.

• Üzenetkezelés.

• Egyéni rajzfunkciók.

• A szabványos ablakstílusok mellett számos különféle vezérlőstílus is elérhető. A stílusok listáját a Windows SDK-ban található sávvezérlési stílusok című témakörben találja.

További információ: A CReBarCtrl használata.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CReBarCtrl

Követelmények

fejléc: afxcmn.h

CReBarCtrl::BeginDrag

Implementálja a Win32-üzenet viselkedését RB_BEGINDRAG, a Windows SDK-ban leírtak szerint.

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

Paraméterek

uBand
A húzási művelet által érintett sáv nullaalapú indexe.

dwPos
A kezdő egér koordinátáit tartalmazó DWORD érték. A vízszintes koordinátát a LOWORD tartalmazza, a függőleges koordinátát pedig a HIWORD tartalmazza. Ha átadja a (DWORD)-1 értéket, a rebar vezérlő az egér pozícióját fogja használni, amikor a vezérlő szálának legutóbbi hívása GetMessage vagy PeekMessage.

CReBarCtrl::Létrehozás

Létrehozza a rebar vezérlőt, és csatolja az CReBarCtrl objektumhoz.

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

Paraméterek

dwStyle
A vezérlőre alkalmazott sávvezérlési stílusok kombinációját adja meg. A támogatott stílusok listáját a Windows SDK sávvezérlési stílusai között találja.

téglalap
Hivatkozás egy CRect objektumra vagy RECT-struktúrára , amely a sávvezérlő pozíciója és mérete.

pParentWnd
Mutató egy CWnd objektumra, amely a sávvezérlő szülőablaka. Nem lehet NULL.

Nid
A rebar vezérlő vezérlőazonosítóját adja meg.

Visszaadott érték

Nonzero, ha az objektum sikeresen létrejött; egyéb esetben 0.

Megjegyzések

Hozzon létre egy rebar vezérlőt két lépésben:

1. A CReBarCtrl meghívása objektum CReBarCtrl létrehozásához.

2. Hívja meg ezt a tagfüggvényt, amely létrehozza a Windows-rebar vezérlőt, és csatolja az CReBarCtrl objektumhoz.

Híváskor Createa rendszer inicializálja a gyakori vezérlőket.

példa

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

// Use ReBar Control.

delete pReBarCtrl;

CReBarCtrl::CreateEx

Létrehoz egy vezérlőt (egy gyermekablakot), és társítja azt a CReBarCtrl objektummal.

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

Paraméterek

dwExStyle
A létrehozott vezérlőelem kiterjesztett stílusát adja meg. A bővített Windows-stílusok listáját a CreateWindowExdwExStyle paraméterében találja a Windows SDK-ban.

dwStyle
A vezérlőre alkalmazott sávvezérlési stílusok kombinációját adja meg. A támogatott stílusok listáját a Windows SDK-ban található sávvezérlési stílusok című témakörben találja.

téglalap
Hivatkozás egy RECT szerkezetre, amely leírja a létrehozandó ablak méretét és pozícióját pParentWndügyfélkoordinátáiban.

pParentWnd
A vezérlő szülőablakára mutató mutató.

Nid
A vezérlő gyermekablak-azonosítója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A CreateExLétrehozás helyett kiterjesztett Windows-stílusokat alkalmazhat, amelyeket a Windows bővített stílus előszavában WS_EX_.

CReBarCtrl::CReBarCtrl

Létrehoz egy CReBarCtrl objektumot.

CReBarCtrl();

példa

Lásd a CReBarCtrl::Létrehozás című példát.

CReBarCtrl::D eleteBand

A Windows SDK-ban leírtaknak megfelelően implementálja a Win32-üzenet RB_DELETEBAND viselkedését.

BOOL DeleteBand(UINT uBand);

Paraméterek

uBand
A törölni kívánt sáv nullaalapú indexe.

Visszaadott érték

Nonzero, ha a sáv sikeresen törölve lett; ellenkező esetben nulla.

példa

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

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

CReBarCtrl::D ragMove

Implementálja a Win32-üzenet viselkedését RB_DRAGMOVE a Windows SDK-ban leírtak szerint.

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

Paraméterek

dwPos
Az új egérkoordinátákat tartalmazó DWORD érték. A vízszintes koordinátát a LOWORD tartalmazza, a függőleges koordinátát pedig a HIWORD tartalmazza. Ha átadja a (DWORD)-1 értéket, a rebar vezérlő az egér pozícióját fogja használni, amikor a vezérlő szálának legutóbbi hívása GetMessage vagy PeekMessage.

CReBarCtrl::EndDrag

Implementálja a Win32-üzenet RB_ENDDRAG viselkedését a Windows SDK-ban leírtak szerint.

void EndDrag();

CReBarCtrl::GetBandBorders

Implementálja a Win32-üzenet viselkedését RB_GETBANDBORDERS, a Windows SDK-ban leírtak szerint.

void GetBandBorders(
    UINT uBand,
    LPRECT prc) const;

Paraméterek

uBand
Annak a sávnak a nullaalapú indexe, amelyhez a szegélyek le lesznek kérve.

Knk
A sávszegélyeket fogadó RECT-struktúra mutatója. Ha a sávvezérlő RBS_BANDBORDERS stílust használ, a szerkezet minden tagja megkapja a szegélyt alkotó képpontok számát a sáv megfelelő oldalán. Ha a sávvezérlő nem rendelkezik RBS_BANDBORDERS stílussal, csak a struktúra bal oldali tagja kap érvényes információt. A sávvezérlési stílusok leírását a Windows SDK-ban található Sávvezérlési stílusok című témakörben találhatja meg.

CReBarCtrl::GetBandCount

Implementálja a Win32-üzenet viselkedését RB_GETBANDCOUNT, a Windows SDK-ban leírtak szerint.

UINT GetBandCount() const;

Visszaadott érték

A vezérlőelemhez rendelt sávok száma.

CReBarCtrl::GetBandInfo

Implementálja a Win32-üzenet viselkedését RB_GETBANDINFO a Windows SDK-ban leírtak szerint.

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

Paraméterek

uBand
Annak a sávnak a nullaalapú indexe, amelyhez az adatokat lekéri a rendszer.

prbbi
Egy REBARBANDINFO-struktúra mutatója a sávinformációk fogadásához. Az üzenet elküldése előtt be kell állítania ennek a cbSize struktúrának sizeof(REBARBANDINFO) a tagját, és be kell állítania fMask a lekérni kívánt elemeket.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

CReBarCtrl::GetBandMargins

Lekéri a sáv margóit.

void GetBandMargins(PMARGINS pMargins);

Paraméterek

pMargins
Az információkat fogadó MARGINS-struktúra mutatója.

Megjegyzések

Ez a tagfüggvény a Windows SDK-ban leírtak szerint emulálja a RB_GETBANDMARGINS üzenet funkcióit.

CReBarCtrl::GetBarHeight

Lekéri a sáv magasságát.

UINT GetBarHeight() const;

Visszaadott érték

A vezérlőelem magasságát képpontban kifejező érték.

CReBarCtrl::GetBarInfo

Implementálja a Win32-üzenet viselkedését RB_GETBARINFO, a Windows SDK-ban leírtak szerint.

BOOL GetBarInfo(REBARINFO* prbi) const;

Paraméterek

prbi
Egy REBARINFO-struktúra mutatója, amely megkapja a sávvezérlő adatait. Az üzenet elküldése előtt be kell állítania ennek a struktúrának a sizeof(REBARINFO) tagját.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

CReBarCtrl::GetBkColor

Implementálja a Win32-üzenet RB_GETBKCOLOR viselkedését a Windows SDK-ban leírtak szerint.

COLORREF GetBkColor() const;

Visszaadott érték

Az aktuális alapértelmezett háttérszínt képviselő COLORREF érték.

CReBarCtrl::GetColorScheme

Lekéri a színösszeállítás-vezérlő COLORSCHEME szerkezetét.

BOOL GetColorScheme(COLORSCHEME* lpcs);

Paraméterek

lpcs
A Windows SDK-ban leírtak szerint egy COLORSCHEME-struktúrára mutató mutató.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

A COLORSCHEME struktúra tartalmazza a gombkiemelés színét és a gomb árnyékszínét.

CReBarCtrl::GetDropTarget

Implementálja a Win32-üzenet viselkedését RB_GETDROPTARGET, a Windows SDK-ban leírtak szerint.

IDropTarget* GetDropTarget() const;

Visszaadott érték

Egy IDropTarget-felületre mutató mutató.

CReBarCtrl::GetExtendedStyle

Lekéri az aktuális sávvezérlő kiterjesztett stílusait.

DWORD GetExtendedStyle() const;

Visszaadott érték

A kiterjesztett stílusokat jelző jelzők bitenkénti kombinációja (OR). A lehetséges jelzők RBS_EX_SPLITTER és RBS_EX_TRANSPARENT. További információt a CReBarCtrl::SetExtendedStyle metódus dwMask paraméterében talál.

Megjegyzések

Ez a metódus elküldi a Windows SDK-ban leírt RB_GETEXTENDEDSTYLE üzenetet.

CReBarCtrl::GetImageList

Lekéri a CImageList sávvezérlőhöz társított objektumot.

CImageList* GetImageList() const;

Visszaadott érték

Mutató egy CImageList-objektumra . Null értéket ad vissza, ha nincs beállítva képlista a vezérlőelemhez.

Megjegyzések

Ez a tagfüggvény a REBARINFO struktúrában tárolt méret- és maszkadatokat használja a Windows SDK-ban leírtak szerint.

CReBarCtrl::GetPalette

Lekéri a sávvezérlő aktuális palettáját.

CPalette* GetPalette() const;

Visszaadott érték

Mutató egy CPalette objektumra, amely megadja a sávvezérlő aktuális palettáját.

Megjegyzések

Vegye figyelembe, hogy ez a tagfüggvény egy CPalette objektumot használ visszatérési értékként a HPALETTE helyett.

példa

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

Implementálja a Win32-üzenet viselkedését RB_GETRECT, a Windows SDK-ban leírtak szerint.

BOOL GetRect(
    UINT uBand,
    LPRECT prc) const;

Paraméterek

uBand
Sáv nullaalapú indexe a sávvezérlőben.

Knk
Egy RECT-struktúra mutatója, amely megkapja a sávsáv határait.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

példa

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

Implementálja a Win32-üzenet viselkedését RB_GETROWCOUNT, a Windows SDK-ban leírtak szerint.

UINT GetRowCount() const;

Visszaadott érték

UINT-érték, amely a vezérlőelem sávsorainak számát jelöli.

példa

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

CReBarCtrl::GetRowHeight

Implementálja a Win32-üzenet viselkedését RB_GETROWHEIGHT, a Windows SDK-ban leírtak szerint.

UINT GetRowHeight(UINT uRow) const;

Paraméterek

uRow
Annak a sávnak a nullaalapú indexe, amelynek a magassága le lesz kérve.

Visszaadott érték

A sormagasságot képpontban kifejező UINT-érték.

példa

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

Implementálja a Win32-üzenet viselkedését RB_GETTEXTCOLOR, a Windows SDK-ban leírtak szerint.

COLORREF GetTextColor() const;

Visszaadott érték

Az aktuális alapértelmezett szövegszínt képviselő COLORREF érték.

CReBarCtrl::GetToolTips

Implementálja a Win32-üzenet RB_GETTOOLTIPS viselkedését a Windows SDK-ban leírtak szerint.

CToolTipCtrl* GetToolTips() const;

Visszaadott érték

Egy CToolTipCtrl-objektumra mutató mutató.

Megjegyzések

Vegye figyelembe, hogy a HWND helyett az MFC implementációja GetToolTips egy mutatót CToolTipCtrlad vissza.

CReBarCtrl::HitTest

Implementálja a Win32-üzenet viselkedését RB_HITTEST, a Windows SDK-ban leírtak szerint.

int HitTest(RBHITTESTINFO* prbht);

Paraméterek

prbht
RBHITTESTINFO-struktúra mutatója. Az üzenet elküldése előtt a pt struktúra tagját inicializálni kell a tesztelni kívánt pontra, ügyfélkoordinátákban.

Visszaadott érték

A sáv nullaalapú indexe az adott ponton, vagy -1, ha nem volt sávsáv a ponton.

CReBarCtrl::IDToIndex

Implementálja a Win32-üzenet viselkedését RB_IDTOINDEX, a Windows SDK-ban leírtak szerint.

int IDToIndex(UINT uBandID) const;

Paraméterek

uBandID
A megadott sáv alkalmazás által definiált azonosítója, amelyet a sáv beszúrásakor a wIDREBARBANDINFO struktúra tagjának ad át.

Visszaadott érték

Ha a nulla alapú sáv indexe sikeres, vagy más -1. Ha ismétlődő sávindexek léteznek, a rendszer az elsőt adja vissza.

CReBarCtrl::InsertBand

Implementálja a Win32-üzenet viselkedését RB_INSERTBAND, a Windows SDK-ban leírtak szerint.

BOOL InsertBand(
    UINT uIndex,
    REBARBANDINFO* prbbi);

Paraméterek

uIndex
A sáv beszúrási helyének nullaalapú indexe. Ha ezt a paramétert -1 értékre állítja, a vezérlő az utolsó helyen adja hozzá az új sávot.

prbbi
A beszúrni kívánt sávot meghatározó REBARBANDINFO-struktúra mutatója. A függvény meghívása előtt be kell állítania ennek a struktúrának a sizeof(REBARBANDINFO) tagját.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

példa

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

Átméretez egy sávot egy sáv vezérlőelemben a legnagyobb méretre.

void MaximizeBand(UINT uBand);

Paraméterek

uBand
A maximálisan maximalizálandó sáv nullaalapú indexe.

Megjegyzések

A Win32-üzenet viselkedését 0 értékre állítja fIdeal a Windows SDK-ban leírtak szerint.

példa

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

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

CReBarCtrl::MinimizeBand

Átméretez egy sávot egy rebar vezérlőben a legkisebb méretre.

void MinimizeBand(UINT uBand);

Paraméterek

uBand
A minimalizálni kívánt sáv nullaalapú indexe.

Megjegyzések

Implementálja a Win32-üzenet viselkedését RB_MINIMIZEBAND, a Windows SDK-ban leírtak szerint.

példa

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

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

CReBarCtrl::MoveBand

A Windows SDK-ban leírtak szerint implementálja a Win32-üzenet RB_MOVEBAND viselkedését.

BOOL MoveBand(
    UINT uFrom,
    UINT uTo);

Paraméterek

uFrom
Az áthelyezendő sáv nullaalapú indexe.

uTo
Az új sávpozíció nullaalapú indexe. Ez a paraméterérték soha nem lehet nagyobb, mint a sávok száma mínusz egy. A sávok számának lekéréséhez hívja meg a GetBandCountot.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

CReBarCtrl::P ushChevron

Implementálja a Win32-üzenet RB_PUSHCHEVRON viselkedését a Windows SDK-ban leírtak szerint.

void PushChevron(
    UINT uBand,
    LPARAM lAppValue);

Paraméterek

uBand
Annak a sávnak a nullaalapú indexe, amelynek a sávját le kell küldeni.

lAppValue
Egy alkalmazás 32 bites értéket definiált. Lásd: lAppValue a RB_PUSHCHEVRON a Windows SDK-ban.

CReBarCtrl::RestoreBand

Átméretez egy sávot egy sávvezérlőben az ideális méretre.

void RestoreBand(UINT uBand);

Paraméterek

uBand
A maximálisan maximalizálandó sáv nullaalapú indexe.

Megjegyzések

Implementálja a Win32-üzenet viselkedését , RB_MAXIMIZEBAND a Windows SDK-ban leírtak szerint 1 értékre fIdeal van állítva.

példa

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

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

CReBarCtrl::SetBandInfo

Implementálja a Win32-üzenet viselkedését RB_SETBANDINFO, a Windows SDK-ban leírtak szerint.

BOOL SetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi);

Paraméterek

uBand
Az új beállítások fogadásához a sáv nullaalapú indexe.

prbbi
Mutasson egy REBARBANDINFO struktúrára, amely meghatározza a beszúrni kívánt sávot. Az üzenet elküldése előtt be kell állítania ennek a cbSize struktúrának sizeof(REBARBANDINFO) a tagját.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

példa

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

Beállítja a megadott rögzített sáv szélességét az aktuális sávvezérlőben.

BOOL SetBandWidth(
    UINT uBand,
    int cxWidth);

Paraméterek

uBand
[in] Egy sávsáv nullaalapú indexe.

cxWidth
[in] A sávsáv új szélessége képpontban.

Visszaadott érték

IGAZ, ha a módszer sikeres; egyéb esetben HAMIS.

Megjegyzések

Ez a metódus elküldi a Windows SDK-ban leírt RB_SETBANDWIDTH üzenetet.

példa

Az első példakód az aktuális sávvezérlő eléréséhez használt változót m_rebarhatározza meg. Ezt a változót a következő példában használjuk.

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

A következő példakód az egyes sávsávokat azonos szélességűre állítja.

// 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

Implementálja a Win32-üzenet viselkedését RB_SETBARINFO, a Windows SDK-ban leírtak szerint.

BOOL SetBarInfo(REBARINFO* prbi);

Paraméterek

prbi
Egy REBARINFO-struktúra mutatója, amely tartalmazza a beállítandó információkat. Az üzenet elküldése előtt be kell állítania ennek a cbSize struktúrának sizeof(REBARINFO) a tagját

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

példa

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

CReBarCtrl::SetBkColor

Implementálja a Win32-üzenet viselkedését RB_SETBKCOLOR, a Windows SDK-ban leírtak szerint.

COLORREF SetBkColor(COLORREF clr);

Paraméterek

Clr
Az új alapértelmezett háttérszínt képviselő COLORREF érték.

Visszaadott érték

A COLORREF érték, amely az előző alapértelmezett háttérszínt jelöli.

Megjegyzések

Ebben a témakörben további információt talál a háttérszín beállításáról és az alapértelmezett beállításról.

CReBarCtrl::SetColorScheme

Beállítja a gombok színsémát egy rebar vezérlőelemen.

void SetColorScheme(const COLORSCHEME* lpcs);

Paraméterek

lpcs
A Windows SDK-ban leírtak szerint egy COLORSCHEME-struktúrára mutató mutató.

Megjegyzések

A COLORSCHEME struktúra tartalmazza a gombkiemelő színt és a gomb árnyékszínét is.

CReBarCtrl::SetExtendedStyle

Az aktuális sávvezérlő kiterjesztett stílusainak beállítása.

DWORD SetExtendedStyle(
    DWORD dwMask,
    DWORD dwStyleEx);

Paraméterek

dwMask
[in] A dwStyleEx paraméterben szereplő jelölők bitenkénti kombinációja (OR). Az alábbi értékek közül legalább egyet használjon:

• RBS_EX_SPLITTER: Alapértelmezés szerint vízszintes módban alul, függőleges módban jobbra pedig az elválasztó jelenik meg.
• RBS_EX_TRANSPARENT: A WM_ERASEBKGND üzenet továbbítása a szülőablakba.

dwStyleEx
[in] A jelölők bitenkénti kombinációja (OR), amely meghatározza az alkalmazandó stílusokat. Stílus beállításához adja meg a dwMask paraméterben használt jelölőt. Stílus alaphelyzetbe állításához adja meg a bináris nullát.

Visszaadott érték

Az előző bővített stílus.

Megjegyzések

Ez a metódus elküldi a Windows SDK-ban leírt RB_SETEXTENDEDSTYLE üzenetet.

CReBarCtrl::SetImageList

Képlistát rendel egy sávvezérlőhöz.

BOOL SetImageList(CImageList* pImageList);

Paraméterek

pImageList
Egy CImageList objektumra mutató mutató, amely tartalmazza a rebar vezérlőelemhez hozzárendelni kívánt képlistát.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

CReBarCtrl::SetOwner

Implementálja a Win32-üzenet viselkedését RB_SETPARENT, a Windows SDK-ban leírtak szerint.

CWnd* SetOwner(CWnd* pWnd);

Paraméterek

pWnd
Mutató egy CWnd objektumra, amely a sávvezérlő tulajdonosaként van beállítva.

Visszaadott érték

Mutató egy CWnd objektumra, amely a sávvezérlő aktuális tulajdonosa.

Megjegyzések

Vegye figyelembe, hogy ez a tagfüggvény a fogópontok helyett az CWnd aktuális és a kijelölt tulajdonos objektumait használja az ablakokhoz.

Megjegyzés:

Ez a tagfüggvény nem módosítja a vezérlő létrehozásakor beállított tényleges szülőt; ehelyett értesítési üzeneteket küld a megadott ablaknak.

CReBarCtrl::SetPalette

A Windows SDK-ban leírtaknak megfelelően implementálja a Win32-üzenet RB_SETPALETTE viselkedését.

CPalette* SetPalette(HPALETTE hPal);

Paraméterek

hPal
Egy HPALETTE, amely megadja az új palettát, amelyet a sávvezérlő használni fog.

Visszaadott érték

Egy CPalette objektumra mutató mutató, amely megadja a sávvezérlő előző palettáját.

Megjegyzések

Vegye figyelembe, hogy ez a tagfüggvény egy CPalette objektumot használ visszatérési értékként a HPALETTE helyett.

CReBarCtrl::SetTextColor

Implementálja a Win32-üzenet viselkedését RB_SETTEXTCOLOR, a Windows SDK-ban leírtak szerint.

COLORREF SetTextColor(COLORREF clr);

Paraméterek

Clr
A COLORREF érték, amely az objektum új szövegszínét CReBarCtrl jelöli.

Visszaadott érték

Az objektumhoz társított korábbi szövegszínt képviselő CReBarCtrl érték.

Megjegyzések

Ez a beállítás támogatja a szövegszín rugalmasságát egy rebar vezérlőelemben.

CReBarCtrl::SetToolTips

Eszközleírás-vezérlő társítása egy rebar vezérlővel.

void SetToolTips(CToolTipCtrl* pToolTip);

Paraméterek

pToolTip
Mutató egy CToolTipCtrl-objektumra

Megjegyzések

Ha végzett vele, el kell pusztítania az CToolTipCtrl objektumot.

CReBarCtrl::SetWindowTheme

Beállítja a sávvezérlő vizuális stílusát.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Paraméterek

pszSubAppName
Egy olyan Unicode-sztringre mutató mutató, amely a beállított rebar vizualizációstílust tartalmazza.

Visszaadott érték

A visszatérési érték nem használatos.

Megjegyzések

Ez a tagfüggvény a Windows SDK-ban leírtak szerint emulálja az RB_SETWINDOWTHEME üzenet funkcióit.

CReBarCtrl::ShowBand

Implementálja a Win32-üzenet viselkedését RB_SHOWBAND, a Windows SDK-ban leírtak szerint.

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

Paraméterek

uBand
Sáv nullaalapú indexe a sávvezérlőben.

fShow
Azt jelzi, hogy a sávnak láthatónak vagy rejtettnek kell-e lennie. Ha ez az érték IGAZ, a sáv megjelenik. Ellenkező esetben a zenekar el lesz rejtve.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

CReBarCtrl::SizeToRect

A Windows SDK-ban leírtaknak megfelelően implementálja a Win32-üzenet RB_SIZETORECT viselkedését.

BOOL SizeToRect(CRect& rect);

Paraméterek

téglalap
Hivatkozás egy CRect objektumra, amely meghatározza azt a téglalapot, amelybe a sávvezérlőt méretezni kell.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Vegye figyelembe, hogy ez a tagfüggvény objektumot CRect használ paraméterként, nem pedig struktúrát RECT .

Lásd még

CWnd osztály
hierarchiadiagram