CReBarCtrl – třída

Zapouzdřuje funkce ovládacího prvku rebar, což je kontejner pro podřízené okno.

Syntaxe

class CReBarCtrl : public CWnd

Členové

Veřejné konstruktory

Název	Popis
CReBarCtrl::CReBarCtrl	CReBarCtrl Vytvoří objekt.

Veřejné metody

Název	Popis
CReBarCtrl::BeginDrag	Umístí ovládací prvek rebar do režimu přetažení.
CReBarCtrl::Create	Vytvoří ovládací prvek rebar a připojí ho k objektu CReBarCtrl .
CReBarCtrl::CreateEx	Vytvoří ovládací prvek rebar se zadanými rozšířenými styly Windows a připojí ho k objektu CReBarCtrl .
CReBarCtrl::D eleteBand	Odstraní pruh z ovládacího prvku panelu.
CReBarCtrl::D ragMove	Aktualizuje pozici přetažení v ovládacím prvku rebar po volání BeginDrag.
CReBarCtrl::EndDrag	Ukončí operaci přetažení a přetažení ovládacího prvku rebaru.
CReBarCtrl::GetBandBorders	Načte ohraničení pásma.
CReBarCtrl::GetBandCount	Načte početpásch
CReBarCtrl::GetBandInfo	Načte informace o zadaném pásmu v ovládacím prvku panelu.
CReBarCtrl::GetBandMargins	Načte okraje pásma.
CReBarCtrl::GetBarHeight	Načte výšku ovládacího prvku rebar.
CReBarCtrl::GetBarInfo	Načte informace o ovládacím prvku rebar a seznamu obrázků, který používá.
CReBarCtrl::GetBkColor	Načte výchozí barvu pozadí ovládacího prvku rebar.
CReBarCtrl::GetColorScheme	Načte strukturu COLORSCHEME přidruženou k ovládacímu prvku rebar.
CReBarCtrl::GetDropTarget	Načte ukazatel rozhraní ovládacího prvku IDropTarget rebar.
CReBarCtrl::GetExtendedStyle	Získá rozšířený styl aktuálního rebar ovládacího prvku.
CReBarCtrl::GetImageList	Načte seznam obrázků přidružený k ovládacímu prvku rebar.
CReBarCtrl::GetPalette	Načte aktuální paletu ovládacího prvku rebar.
CReBarCtrl::GetRect	Načte ohraničující obdélník pro daný pruh v ovládacím prvku panelu.
CReBarCtrl::GetRowCount	Načte počet pruhových řádků v ovládacím prvku panelu.
CReBarCtrl::GetRowHeight	Načte výšku zadaného řádku v ovládacím prvku panelu.
CReBarCtrl::GetTextColor	Načte výchozí barvu textu ovládacího prvku rebar.
CReBarCtrl::GetToolTips	Načte popisovač na jakýkoli ovládací prvek popisku, který je přidružený k ovládacímu prvku panelu.
CReBarCtrl::HitTest	Určuje, která část pruhového pruhu je v daném bodě na obrazovce, pokud v tomto okamžiku existuje pruhový pruh.
CReBarCtrl::IDToIndex	Převede identifikátor pásma (ID) na index pásma v ovládacím prvku panelu.
CReBarCtrl::InsertBand	Vloží nový pruh do ovládacího prvku panelu.
CReBarCtrl::MaximizeBand	Změní velikost pruhu v ovládacím prvku rebar na jeho největší velikost.
CReBarCtrl::MinimizeBand	Změní velikost pásma v ovládacím prvku rebar na jeho nejmenší velikost.
CReBarCtrl::MoveBand	Přesune pruh z jednoho indexu do druhého.
CReBarCtrl::P ushChevron	Naprogramuje dvojitou šipku.
CReBarCtrl::RestoreBand	Změní velikost pásu v ovládacím prvku panelu na ideální velikost.
CReBarCtrl::SetBandInfo	Nastaví vlastnosti existujícího pásma v ovládacím prvku panelu.
CReBarCtrl::SetBandWidth	Nastaví šířku zadaného ukotveného pásma v aktuálním ovládacím prvku rebar.
CReBarCtrl::SetBarInfo	Nastaví vlastnosti ovládacího prvku rebar.
CReBarCtrl::SetBkColor	Nastaví výchozí barvu pozadí ovládacího prvku rebar.
CReBarCtrl::SetColorScheme	Nastaví barevné schéma tlačítek na ovládacím prvku panelu.
CReBarCtrl::SetExtendedStyle	Nastaví rozšířené styly pro aktuální ovládací prvek panelu.
CReBarCtrl::SetImageList	Nastaví seznam obrázků ovládacího prvku rebar.
CReBarCtrl::SetOwner	Nastaví okno vlastníka ovládacího prvku rebar.
CReBarCtrl::SetPalette	Nastaví aktuální paletu ovládacího prvku rebar.
CReBarCtrl::SetTextColor	Nastaví výchozí barvu textu ovládacího prvku rebar.
CReBarCtrl::SetToolTips	Přidruží ovládací prvek popisku nástroje k ovládacímu prvku panelu.
CReBarCtrl::SetWindowTheme	Nastaví vizuální styl ovládacího prvku rebar.
CReBarCtrl::ShowBand	Zobrazí nebo skryje daný pruh v ovládacím prvku panelu.
CReBarCtrl::SizeToRect	Do zadaného obdélníku se přizpůsobí ovládací prvek rebar.

Poznámky

Aplikace, ve které se nachází ovládací prvek panelu, přiřadí podřízené okno obsažené ovládacím prvku panelu do pruhu. Podřízené okno je obvykle dalším běžným ovládacím prvek.

Ovládací prvky rebar obsahují jedno nebo více pásem. Každý pruh může obsahovat kombinaci úchytu, rastrového obrázku, textového popisku a podřízeného okna. Pruh může obsahovat pouze jednu z těchto položek.

Ovládací prvek rebar může zobrazit podřízené okno nad zadaným rastrovým obrázkem pozadí. Velikost všech ovládacích pásem rebaru lze změnit, s výjimkou těch, které používají styl RBBS_FIXEDSIZE. Při přemísťování nebo změně velikosti ovládacího pásma rebaru řídí ovládací prvek panelu velikost a umístění podřízeného okna přiřazeného k této pásce. Pokud chcete změnit pořadí pásem v ovládacím prvku, klikněte na úchyt pásu a přetáhněte ho.

Následující obrázek znázorňuje ovládací prvek rebaru, který má tři pruhy:

• Pruh 0 obsahuje plochý průhledný ovládací prvek panelu nástrojů.

• Pruh 1 obsahuje průhledná standardní i průhledná rozevírací tlačítka.

• Pruh 2 obsahuje pole se seznamem a čtyři standardní tlačítka.

  

Ovládací prvek Rebar

Podpora ovládacích prvků rebaru:

• Seznamy obrázků

• Zpracování zpráv

• Vlastní funkce kreslení

• Kromě standardních stylů oken můžete kromě standardních stylů oken používat i různé styly ovládacích prvků. Seznam těchto stylů najdete v tématu Styly ovládacích prvků panelu v sadě Windows SDK.

Další informace naleznete v tématu Použití CReBarCtrl.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CWnd

CReBarCtrl

Požadavky

Hlavička: afxcmn.h

CReBarCtrl::BeginDrag

Implementuje chování zprávy Win32 RB_BEGINDRAG, jak je popsáno v sadě Windows SDK.

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

Parametry

uBand
Nulový index pásma, na který bude mít vliv operace přetažení.

DwPos
Hodnota DWORD, která obsahuje počáteční souřadnice myši. Vodorovná souřadnice je obsažena v LOWORDu a svislá souřadnice je obsažena v HIWORD. Pokud předáte (DWORD)-1, ovládací prvek rebar použije pozici myši při posledním zavolání GetMessage vlákna ovládacího prvku nebo PeekMessage.

CReBarCtrl::Create

Vytvoří ovládací prvek rebar a připojí ho k objektu CReBarCtrl .

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

Parametry

dwStyle
Určuje kombinaci stylů ovládacích prvků rebar použitých u ovládacího prvku. Seznam podporovaných stylů najdete v části Styly ovládacích prvků na panelu v sadě Windows SDK.

Rect
Odkaz na objekt CRect nebo STRUKTURU RECT , což je pozice a velikost ovládacího prvku rebar.

pParentWnd
Ukazatel na objekt CWnd , který je nadřazeným oknem ovládacího prvku rebar. Nesmí mít hodnotu NULL.

Nid
Určuje ID ovládacího prvku rebaru.

Návratová hodnota

Nenulové, pokud byl objekt úspěšně vytvořen; jinak 0.

Poznámky

Vytvořte ovládací prvek rebar ve dvou krocích:

1. Volání CReBarCtrl k vytvoření objektu CReBarCtrl .

2. Volání této členské funkce, která vytvoří ovládací prvek panelu Windows a připojí ho k objektu CReBarCtrl .

Při volání Createse inicializují běžné ovládací prvky.

Příklad

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

// Use ReBar Control.

delete pReBarCtrl;

CReBarCtrl::CreateEx

Vytvoří ovládací prvek (podřízené okno) a přidruží ho k objektu CReBarCtrl .

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

Parametry

dwExStyle
Určuje rozšířený styl vytvářeného ovládacího prvku. Seznam rozšířených stylů Windows naleznete v části dwExStyle parametr pro CreateWindowEx v sadě Windows SDK.

dwStyle
Určuje kombinaci stylů ovládacích prvků rebar použitých u ovládacího prvku. Seznam podporovaných stylů najdete v tématu Styly ovládacích prvků panelu v sadě Windows SDK.

Rect
Odkaz na strukturu RECT popisující velikost a umístění okna, které se má vytvořit, v souřadnicích klienta pParentWnd.

pParentWnd
Ukazatel na okno, které je nadřazeným objektem ovládacího prvku.

Nid
ID podřízeného okna ovládacího prvku.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Místo příkazu Vytvořit použijte CreateEx rozšířené styly Windows určené před WS_EX_ rozšířeného stylu Windows.

CReBarCtrl::CReBarCtrl

CReBarCtrl Vytvoří objekt.

CReBarCtrl();

Příklad

Podívejte se na příklad pro CReBarCtrl::Create.

CReBarCtrl::D eleteBand

Implementuje chování zprávy Win32 RB_DELETEBAND, jak je popsáno v sadě Windows SDK.

BOOL DeleteBand(UINT uBand);

Parametry

uBand
Nulový index pásma, který se má odstranit.

Návratová hodnota

Nenulové, pokud se pásma úspěšně odstranila; jinak nula.

Příklad

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

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

CReBarCtrl::D ragMove

Implementuje chování zprávy Win32 RB_DRAGMOVE, jak je popsáno v sadě Windows SDK.

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

Parametry

DwPos
Hodnota DWORD, která obsahuje nové souřadnice myši. Vodorovná souřadnice je obsažena v LOWORDu a svislá souřadnice je obsažena v HIWORD. Pokud předáte (DWORD)-1, ovládací prvek rebar použije pozici myši při posledním zavolání GetMessage vlákna ovládacího prvku nebo PeekMessage.

CReBarCtrl::EndDrag

Implementuje chování zprávy Win32 RB_ENDDRAG, jak je popsáno v sadě Windows SDK.

void EndDrag();

CReBarCtrl::GetBandBorders

Implementuje chování zprávy Win32 RB_GETBANDBORDERS, jak je popsáno v sadě Windows SDK.

void GetBandBorders(
    UINT uBand,
    LPRECT prc) const;

Parametry

uBand
Index pruhu, pro který se ohraničení načte, je nulový.

Člr
Ukazatel na strukturu RECT , která bude přijímat ohraničení pásem. Pokud má ovládací prvek rebar styl RBS_BANDBORDERS, každý člen této struktury obdrží počet pixelů na odpovídající straně pásma, které tvoří ohraničení. Pokud ovládací prvek rebar nemá styl RBS_BANDBORDERS, obdrží platné informace pouze levý člen této struktury. Popis stylů ovládacích prvků rebar naleznete v tématu Styly ovládacích prvků panelu v sadě Windows SDK.

CReBarCtrl::GetBandCount

Implementuje chování zprávy Win32 RB_GETBANDCOUNT, jak je popsáno v sadě Windows SDK.

UINT GetBandCount() const;

Návratová hodnota

Počet pásem přiřazených ovládacímu prvku.

CReBarCtrl::GetBandInfo

Implementuje chování zprávy Win32 RB_GETBANDINFO , jak je popsáno v sadě Windows SDK.

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

Parametry

uBand
Index na základě nuly pásma, pro který budou informace načteny.

prbbi
Ukazatel na strukturu REBARBANDINFO pro příjem informací o pásmu. Před odesláním této zprávy musíte nastavit cbSize člena této struktury sizeof(REBARBANDINFO) a nastavit ho fMask na položky, které chcete načíst.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

CReBarCtrl::GetBandMargins

Načte okraje pásma.

void GetBandMargins(PMARGINS pMargins);

Parametry

PMargins
Ukazatel na strukturu MARGINS, která obdrží informace.

Poznámky

Tato členová funkce emuluje funkce RB_GETBANDMARGINS zprávy, jak je popsáno v sadě Windows SDK.

CReBarCtrl::GetBarHeight

Načte výšku pruhu rebaru.

UINT GetBarHeight() const;

Návratová hodnota

Hodnota, která představuje výšku ovládacího prvku v pixelech.

CReBarCtrl::GetBarInfo

Implementuje chování zprávy Win32 RB_GETBARINFO, jak je popsáno v sadě Windows SDK.

BOOL GetBarInfo(REBARINFO* prbi) const;

Parametry

prbi
Ukazatel na strukturu REBARINFO , která obdrží informace o ovládacím prvku panelu. Před odesláním této zprávy je nutné nastavit člen cbSize této struktury sizeof(REBARINFO) .

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

CReBarCtrl::GetBkColor

Implementuje chování zprávy Win32 RB_GETBKCOLOR, jak je popsáno v sadě Windows SDK.

COLORREF GetBkColor() const;

Návratová hodnota

Hodnota COLORREF, která představuje aktuální výchozí barvu pozadí.

CReBarCtrl::GetColorScheme

Načte strukturu COLORSCHEME pro ovládací prvek rebar.

BOOL GetColorScheme(COLORSCHEME* lpcs);

Parametry

lpcs
Ukazatel na strukturu COLORSCHEME , jak je popsáno v sadě Windows SDK.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Struktura COLORSCHEME obsahuje barvu zvýraznění tlačítka a barvu stínu tlačítka.

CReBarCtrl::GetDropTarget

Implementuje chování zprávy Win32 RB_GETDROPTARGET, jak je popsáno v sadě Windows SDK.

IDropTarget* GetDropTarget() const;

Návratová hodnota

Ukazatel na rozhraní IDropTarget .

CReBarCtrl::GetExtendedStyle

Získá rozšířené styly aktuální rebar ovládacího prvku.

DWORD GetExtendedStyle() const;

Návratová hodnota

Bitové kombinace (OR) příznaků, které označují rozšířené styly. Možné příznaky jsou RBS_EX_SPLITTER a RBS_EX_TRANSPARENT. Další informace naleznete v dwMask parametr CReBarCtrl::SetExtendedStyle metoda.

Poznámky

Tato metoda odešle RB_GETEXTENDEDSTYLE zprávu, která je popsaná v sadě Windows SDK.

CReBarCtrl::GetImageList

CImageList Získá objekt přidružený k ovládacímu prvku rebar.

CImageList* GetImageList() const;

Návratová hodnota

Ukazatel na objekt CImageList . Vrátí hodnotu NULL, pokud není pro ovládací prvek nastaven žádný seznam obrázků.

Poznámky

Tato členová funkce používá informace o velikosti a maskách uložené ve struktuře REBARINFO , jak je popsáno v sadě Windows SDK.

CReBarCtrl::GetPalette

Načte aktuální paletu ovládacího prvku rebar.

CPalette* GetPalette() const;

Návratová hodnota

Ukazatel na objekt CPalette určující aktuální paletu ovládacího prvku rebar.

Poznámky

Všimněte si, že tato členová funkce jako návratovou CPalette hodnotu používá objekt, nikoli hpALETTE.

Příklad

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

Implementuje chování zprávy Win32 RB_GETRECT, jak je popsáno v sadě Windows SDK.

BOOL GetRect(
    UINT uBand,
    LPRECT prc) const;

Parametry

uBand
Index pruhu založený na nule v ovládacím prvku panelu

Člr
Ukazatel na strukturu RECT , která obdrží hranice pruhu pruhu.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Příklad

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

Implementuje chování zprávy Win32 RB_GETROWCOUNT, jak je popsáno v sadě Windows SDK.

UINT GetRowCount() const;

Návratová hodnota

Hodnota UINT, která představuje počet pruhových řádků v ovládacím prvku.

Příklad

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

CReBarCtrl::GetRowHeight

Implementuje chování zprávy Win32 RB_GETROWHEIGHT, jak je popsáno v sadě Windows SDK.

UINT GetRowHeight(UINT uRow) const;

Parametry

uRow
Index pruhu založený na nule, který bude mít načtenou výšku.

Návratová hodnota

Hodnota UINT, která představuje výšku řádku v pixelech.

Příklad

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

Implementuje chování zprávy Win32 RB_GETTEXTCOLOR, jak je popsáno v sadě Windows SDK.

COLORREF GetTextColor() const;

Návratová hodnota

Hodnota COLORREF, která představuje aktuální výchozí barvu textu.

CReBarCtrl::GetToolTips

Implementuje chování zprávy Win32 RB_GETTOOLTIPS, jak je popsáno v sadě Windows SDK.

CToolTipCtrl* GetToolTips() const;

Návratová hodnota

Ukazatel na objekt CToolTipCtrl .

Poznámky

Všimněte si, že implementace GetToolTips MFC vrátí ukazatel na CToolTipCtrl, spíše než HWND.

CReBarCtrl::HitTest

Implementuje chování zprávy Win32 RB_HITTEST, jak je popsáno v sadě Windows SDK.

int HitTest(RBHITTESTINFO* prbht);

Parametry

prbht
Ukazatel na strukturu RBHITTESTINFO . Před odesláním zprávy pt musí být člen této struktury inicializován do bodu, který bude testován v souřadnicích klienta.

Návratová hodnota

Index pruhu založený na nule v daném bodě nebo -1, pokud v bodě nebyl žádný pruhový pruh.

CReBarCtrl::IDToIndex

Implementuje chování zprávy Win32 RB_IDTOINDEX, jak je popsáno v sadě Windows SDK.

int IDToIndex(UINT uBandID) const;

Parametry

uBandID
Identifikátor definovaný aplikací zadaného pásma předaný členem wID struktury REBARBANDINFO při vložení pásma.

Návratová hodnota

Index založený na nulovém pásmu, pokud je úspěšný, nebo -1 jinak. Pokud existují duplicitní indexy pásem, vrátí se první index.

CReBarCtrl::InsertBand

Implementuje chování zprávy Win32 RB_INSERTBAND, jak je popsáno v sadě Windows SDK.

BOOL InsertBand(
    UINT uIndex,
    REBARBANDINFO* prbbi);

Parametry

uIndex
Index založený na nule umístění, kam bude pruh vložen. Pokud tento parametr nastavíte na hodnotu -1, ovládací prvek přidá novou skupinu na poslední místo.

prbbi
Ukazatel na strukturu REBARBANDINFO , která definuje pruh, který se má vložit. Před voláním této funkce musíte nastavit člen cbSize této struktury sizeof(REBARBANDINFO) .

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Příklad

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

Změní velikost pruhu v ovládacím prvku rebar na jeho největší velikost.

void MaximizeBand(UINT uBand);

Parametry

uBand
Index pásma založený na nule, který se má maximalizovat.

Poznámky

Implementuje chování zprávy Win32 RB_MAXIMIZEBAND s nastavenou fIdeal na hodnotu 0, jak je popsáno v sadě Windows SDK.

Příklad

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

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

CReBarCtrl::MinimizeBand

Změní velikost pásma v ovládacím prvku rebar na jeho nejmenší velikost.

void MinimizeBand(UINT uBand);

Parametry

uBand
Index pásma založený na nule, který se má minimalizovat.

Poznámky

Implementuje chování zprávy Win32 RB_MINIMIZEBAND, jak je popsáno v sadě Windows SDK.

Příklad

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

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

CReBarCtrl::MoveBand

Implementuje chování zprávy Win32 RB_MOVEBAND, jak je popsáno v sadě Windows SDK.

BOOL MoveBand(
    UINT uFrom,
    UINT uTo);

Parametry

uFrom
Index pásma, který se má přesunout, je založený na nule.

uTo
Index založený na nule nové pozice pásem. Tato hodnota parametru nesmí být nikdy větší než počet pásem minus jedna. Pokud chcete získat počet pásem, zavolejte GetBandCount.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

CReBarCtrl::P ushChevron

Implementuje chování zprávy Win32 RB_PUSHCHEVRON, jak je popsáno v sadě Windows SDK.

void PushChevron(
    UINT uBand,
    LPARAM lAppValue);

Parametry

uBand
Nulový index pásma, jehož dvojitá šipka se má nasdílit.

lAppValue
Aplikace definovala 32bitovou hodnotu. Viz lAppValue v RB_PUSHCHEVRON v sadě Windows SDK.

CReBarCtrl::RestoreBand

Změní velikost pásu v ovládacím prvku panelu na ideální velikost.

void RestoreBand(UINT uBand);

Parametry

uBand
Index pásma založený na nule, který se má maximalizovat.

Poznámky

Implementuje chování zprávy Win32 RB_MAXIMIZEBAND s nastavenou fIdeal na hodnotu 1, jak je popsáno v sadě Windows SDK.

Příklad

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

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

CReBarCtrl::SetBandInfo

Implementuje chování zprávy Win32 RB_SETBANDINFO, jak je popsáno v sadě Windows SDK.

BOOL SetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi);

Parametry

uBand
Nulový index pásma pro příjem nových nastavení.

prbbi
Ukazatel na strukturu REBARBANDINFO , která definuje pruh, který se má vložit. Před odesláním této zprávy musíte nastavit cbSize člena této struktury sizeof(REBARBANDINFO) .

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Příklad

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

Nastaví šířku zadaného ukotveného pásma v aktuálním ovládacím prvku rebar.

BOOL SetBandWidth(
    UINT uBand,
    int cxWidth);

Parametry

uBand
[v] Index pruhu s nulovou hodnotou.

cxWidth
[v] Nová šířka pruhového pruhu v pixelech.

Návratová hodnota

TRUE, pokud je metoda úspěšná; jinak NEPRAVDA.

Poznámky

Tato metoda odešle RB_SETBANDWIDTH zprávu, která je popsaná v sadě Windows SDK.

Příklad

První příklad kódu definuje proměnnou , m_rebarkterá se používá pro přístup k aktuálnímu ovládacímu prvku rebar. Tato proměnná se používá v dalším příkladu.

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

V dalším příkladu kódu se nastaví všechna pruhová pásma na stejnou šířku.

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

Implementuje chování zprávy Win32 RB_SETBARINFO, jak je popsáno v sadě Windows SDK.

BOOL SetBarInfo(REBARINFO* prbi);

Parametry

prbi
Ukazatel na strukturu REBARINFO , která obsahuje informace, které mají být nastaveny. Před odesláním této zprávy musíte nastavit cbSize člena této struktury.sizeof(REBARINFO)

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Příklad

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

CReBarCtrl::SetBkColor

Implementuje chování zprávy Win32 RB_SETBKCOLOR, jak je popsáno v sadě Windows SDK.

COLORREF SetBkColor(COLORREF clr);

Parametry

clr
Hodnota COLORREF, která představuje novou výchozí barvu pozadí.

Návratová hodnota

Hodnota COLORREF, která představuje předchozí výchozí barvu pozadí.

Poznámky

Další informace o tom, kdy nastavit barvu pozadí a jak nastavit výchozí nastavení, najdete v tomto tématu.

CReBarCtrl::SetColorScheme

Nastaví barevné schéma tlačítek na ovládacím prvku panelu.

void SetColorScheme(const COLORSCHEME* lpcs);

Parametry

lpcs
Ukazatel na strukturu COLORSCHEME , jak je popsáno v sadě Windows SDK.

Poznámky

Struktura COLORSCHEME zahrnuje barvu zvýraznění tlačítka i barvu stínu tlačítka.

CReBarCtrl::SetExtendedStyle

Nastaví rozšířené styly pro aktuální ovládací prvek panelu.

DWORD SetExtendedStyle(
    DWORD dwMask,
    DWORD dwStyleEx);

Parametry

DwMask
[v] Bitové kombinace (OR) příznaků, které určují, které příznaky v dwStyleEx parametru platí. Použijte jednu nebo více následujících hodnot:

• RBS_EX_SPLITTER: Ve výchozím nastavení zobrazte rozdělovač v dolní části vodorovného režimu a vpravo ve svislém režimu.
• RBS_EX_TRANSPARENT: Přeposlání WM_ERASEBKGND zprávy do nadřazeného okna.

dwStyleEx
[v] Bitové kombinace (OR) příznaků, které určují styly, které se mají použít. Pokud chcete nastavit styl, zadejte stejný příznak, který se používá v parametru dwMask . Pokud chcete obnovit styl, zadejte binární nulu.

Návratová hodnota

Předchozí rozšířený styl.

Poznámky

Tato metoda odešle RB_SETEXTENDEDSTYLE zprávu, která je popsaná v sadě Windows SDK.

CReBarCtrl::SetImageList

Přiřadí seznam obrázků ovládacímu prvku rebar.

BOOL SetImageList(CImageList* pImageList);

Parametry

pImageList
Ukazatel na objekt CImageList obsahující seznam obrázků, který má být přiřazen ovládacímu prvku rebar.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

CReBarCtrl::SetOwner

Implementuje chování zprávy Win32 RB_SETPARENT, jak je popsáno v sadě Windows SDK.

CWnd* SetOwner(CWnd* pWnd);

Parametry

pWnd
Ukazatel na CWnd objekt, který se nastaví jako vlastník ovládacího prvku panelu.

Návratová hodnota

Ukazatel na objekt CWnd , který je aktuálním vlastníkem ovládacího prvku rebar.

Poznámky

Všimněte si, že tato členová funkce používá ukazatele na CWnd objekty pro aktuálního i vybraného vlastníka ovládacího prvku rebar, nikoli úchyty pro okna.

Poznámka:

Tato členová funkce nezmění skutečný nadřazený objekt, který byl nastaven při vytvoření ovládacího prvku; místo toho odesílá zprávy s oznámením do zadaného okna.

CReBarCtrl::SetPalette

Implementuje chování zprávy Win32 RB_SETPALETTE, jak je popsáno v sadě Windows SDK.

CPalette* SetPalette(HPALETTE hPal);

Parametry

hPal
HPALETTE, která určuje novou paletu, kterou bude ovládací prvek panelu používat.

Návratová hodnota

Ukazatel na objekt CPalette určující předchozí paletu ovládacího prvku rebar.

Poznámky

Všimněte si, že tato členová funkce jako návratovou CPalette hodnotu používá objekt, nikoli hpALETTE.

CReBarCtrl::SetTextColor

Implementuje chování zprávy Win32 RB_SETTEXTCOLOR, jak je popsáno v sadě Windows SDK.

COLORREF SetTextColor(COLORREF clr);

Parametry

clr
Hodnota COLORREF, která představuje novou barvu textu v objektu CReBarCtrl .

Návratová hodnota

Hodnota COLORREF představující předchozí barvu textu přidruženou k objektu CReBarCtrl .

Poznámky

Poskytuje se k podpoře flexibility barev textu v ovládacím prvku panelu.

CReBarCtrl::SetToolTips

Přidruží ovládací prvek popisku nástroje k ovládacímu prvku panelu.

void SetToolTips(CToolTipCtrl* pToolTip);

Parametry

pToolTip
Ukazatel na objekt CToolTipCtrl

Poznámky

Jakmile s CToolTipCtrl ním budete hotovi, musíte objekt zničit.

CReBarCtrl::SetWindowTheme

Nastaví vizuální styl ovládacího prvku rebar.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parametry

pszSubAppName
Ukazatel na řetězec Unicode, který obsahuje vizuální styl panelu, který chcete nastavit.

Návratová hodnota

Vrácená hodnota se nepoužívá.

Poznámky

Tato členová funkce emuluje funkce RB_SETWINDOWTHEME zprávy, jak je popsáno v sadě Windows SDK.

CReBarCtrl::ShowBand

Implementuje chování zprávy Win32 RB_SHOWBAND, jak je popsáno v sadě Windows SDK.

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

Parametry

uBand
Index pruhu založený na nule v ovládacím prvku panelu

fShow
Označuje, jestli má být pruh zobrazený nebo skrytý. Pokud je tato hodnota PRAVDA, zobrazí se pásma. Jinak bude skupina skrytá.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

CReBarCtrl::SizeToRect

Implementuje chování zprávy Win32 RB_SIZETORECT, jak je popsáno v sadě Windows SDK.

BOOL SizeToRect(CRect& rect);

Parametry

Rect
Odkaz na objekt CRect , který určuje obdélník, na který má mít ovládací prvek rebar velikost.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Všimněte si, že tato členová funkce používá CRect objekt jako parametr, nikoli RECT strukturu.

Viz také

CWnd – třída
Graf hierarchie