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
| Jméno | popis |
|---|---|
| CReBarCtrl::CReBarCtrl | CReBarCtrl Vytvoří objekt. |
Veřejné metody
| Jméno | 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 | Aktualizace umístění přetažení v ovládacím prvku panelu 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::GetTool Tipy | 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::SetTool Tipy | 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
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.
Vrácená hodnota
Nenulové, pokud byl objekt úspěšně vytvořen; jinak 0.
Poznámky
Vytvořte ovládací prvek rebar ve dvou krocích:
Volání CReBarCtrl k vytvoření objektu
CReBarCtrl.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.
Vrácená 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.
Vrácená 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;
Vrácená 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.
Vrácená 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;
Vrácená 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) .
Vrácená 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;
Vrácená 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.
Vrácená 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;
Vrácená hodnota
Ukazatel na rozhraní IDropTarget .
CReBarCtrl::GetExtendedStyle
Získá rozšířené styly aktuální rebar ovládacího prvku.
DWORD GetExtendedStyle() const;
Vrácená 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;
Vrácená 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;
Vrácená 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.
Vrácená 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;
Vrácená 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.
Vrácená 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;
Vrácená hodnota
Hodnota COLORREF, která představuje aktuální výchozí barvu textu.
CReBarCtrl::GetTool Tipy
Implementuje chování zprávy Win32 RB_GETTOOLTIPS, jak je popsáno v sadě Windows SDK.
CToolTipCtrl* GetToolTips() const;
Vrácená 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.
Vrácená 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 wIDstruktury REBARBANDINFO při vložení pásma.
Vrácená 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) .
Vrácená 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.
Vrácená 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) .
Vrácená 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.
Vrácená 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)
Vrácená 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í.
Vrácená 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.
Vrácená 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.
Vrácená 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.
Vrácená 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.
Vrácená 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 .
Vrácená 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::SetTool Tipy
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.
Vrácená 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á.
Vrácená 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.
Vrácená 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é
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro