Klasa CReBarCtrl

Artykuł
10/12/2023

Hermetyzuje funkcjonalność kontrolki paska pomocniczego, która jest kontenerem dla okna podrzędnego.

Składnia

class CReBarCtrl : public CWnd

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CReBarCtrl::CReBarCtrl	`CReBarCtrl` Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CReBarCtrl::BeginDrag	Umieszcza kontrolkę paska pomocniczego w trybie przeciągania i upuszczania.
CReBarCtrl::Create	Tworzy kontrolkę paska pomocniczego `CReBarCtrl` i dołącza ją do obiektu.
CReBarCtrl::CreateEx	Tworzy kontrolkę paska pomocniczego z określonymi stylami rozszerzonymi systemu Windows i dołącza ją do `CReBarCtrl` obiektu.
CReBarCtrl::D eleteBand	Usuwa pasm z kontrolki paska pomocniczego.
CReBarCtrl::D ragMove	Aktualizuje położenie przeciągania w kontrolce paska pomocniczego po wywołaniu metody `BeginDrag`.
CReBarCtrl::EndDrag	Przerywa operację przeciągania i upuszczania kontrolki paska.
CReBarCtrl::GetBandBorders	Pobiera obramowania przedziału.
CReBarCtrl::GetBandCount	Pobiera liczbę pasm aktualnie w kontrolce paska pomocniczego.
CReBarCtrl::GetBandInfo	Pobiera informacje o określonym pasmie w kontrolce paska pomocniczego.
CReBarCtrl::GetBandMargins	Pobiera marginesy przedziału.
CReBarCtrl::GetBarHeight	Pobiera wysokość kontrolki paska pomocniczego.
CReBarCtrl::GetBarInfo	Pobiera informacje o kontrolce paska pomocniczego i używanej liście obrazów.
CReBarCtrl::GetBkColor	Pobiera domyślny kolor tła kontrolki paska pomocniczego.
CReBarCtrl::GetColorScheme	Pobiera strukturę COLORSCHEME skojarzona z kontrolką paska pomocniczego.
CReBarCtrl::GetDropTarget	Pobiera wskaźnik interfejsu kontrolki paska pomocniczego `IDropTarget` .
CReBarCtrl::GetExtendedStyle	Pobiera rozszerzony styl bieżącej kontrolki paska pomocniczego.
CReBarCtrl::GetImageList	Pobiera listę obrazów skojarzona z kontrolką paska pomocniczego.
CReBarCtrl::GetPalette	Pobiera bieżącą paletę kontrolki paska pomocniczego.
CReBarCtrl::GetRect	Pobiera prostokąt ograniczenia dla danego przedziału w kontrolce paska pomocniczego.
CReBarCtrl::GetRowCount	Pobiera liczbę wierszy pasm w kontrolce paska pomocniczego.
CReBarCtrl::GetRowHeight	Pobiera wysokość określonego wiersza w kontrolce paska pomocniczego.
CReBarCtrl::GetTextColor	Pobiera domyślny kolor tekstu kontrolki paska pomocniczego.
CReBarCtrl::GetToolTips	Pobiera uchwyt do dowolnej kontrolki porad narzędzia skojarzonej z kontrolką paska pomocniczego.
CReBarCtrl::HitTest	Określa, która część paska paska rebar znajduje się w danym punkcie na ekranie, jeśli w tym momencie istnieje pasmo paska.
CReBarCtrl::IDToIndex	Konwertuje identyfikator przedziału (ID) na indeks pasmowy w kontrolce paska pomocniczego.
CReBarCtrl::InsertBand	Wstawia nowy pasek w kontrolce paska pomocniczego.
CReBarCtrl::MaximizeBand	Zmienia rozmiar paska w kontrolce paska pomocniczego na największy rozmiar.
CReBarCtrl::MinimalBand	Zmienia rozmiar paska w kontrolce paska pomocniczego na najmniejszy rozmiar.
CReBarCtrl::MoveBand	Przenosi przedział z jednego indeksu do drugiego.
CReBarCtrl::P ushChevron	Programowo wypycha pagon.
CReBarCtrl::RestoreBand	Zmienia rozmiar paska w kontrolce paska pomocniczego na idealny rozmiar.
CReBarCtrl::SetBandInfo	Ustawia charakterystykę istniejącego pasma w kontrolce paska pomocniczego.
CReBarCtrl::SetBandWidth	Ustawia szerokość określonego zadokowanego pasa w bieżącej kontrolce paska pomocniczego.
CReBarCtrl::SetBarInfo	Ustawia cechy kontrolki paska pomocniczego.
CReBarCtrl::SetBkColor	Ustawia domyślny kolor tła kontrolki paska pomocniczego.
CReBarCtrl::SetColorScheme	Ustawia schemat kolorów przycisków na kontrolce paska pomocniczego.
CReBarCtrl::SetExtendedStyle	Ustawia style rozszerzone dla bieżącej kontrolki paska pomocniczego.
CReBarCtrl::SetImageList	Ustawia listę obrazów kontrolki paska pomocniczego.
CReBarCtrl::SetOwner	Ustawia okno właściciela kontrolki paska pomocniczego.
CReBarCtrl::SetPalette	Ustawia bieżącą paletę kontrolki paska pomocniczego.
CReBarCtrl::SetTextColor	Ustawia domyślny kolor tekstu kontrolki paska pomocniczego.
CReBarCtrl::SetToolTips	Kojarzy kontrolkę porad narzędzia z kontrolką paska pomocniczego.
CReBarCtrl::SetWindowTheme	Ustawia styl wizualny kontrolki paska pomocniczego.
CReBarCtrl::ShowBand	Pokazuje lub ukrywa dany przedział w kontrolce paska pomocniczego.
CReBarCtrl::SizeToRect	Dopasowuje kontrolkę paska do określonego prostokąta.

Uwagi

Aplikacja, w której znajduje się kontrolka paska pomocniczego, przypisuje okno podrzędne zawarte przez kontrolkę paska pomocniczego do pasm paska pomocniczego. Okno podrzędne jest zwykle inną wspólną kontrolką.

Kontrolki paska pomocniczego zawierają co najmniej jeden przedział. Każdy zespół może zawierać kombinację paska uchwytu, mapy bitowej, etykiety tekstowej i okna podrzędnego. Zespół może zawierać tylko jeden z tych elementów.

Kontrolka paska pomocniczego może wyświetlać okno podrzędne na określonej mapie bitowej tła. Rozmiar wszystkich pasków sterowania paskami można zmienić, z wyjątkiem tych, które używają stylu RBBS_FIXEDSIZE. Gdy zmieniasz położenie lub zmieniasz rozmiar pasa sterującego paska, kontrolka paska pomocniczego zarządza rozmiarem i położeniem okna podrzędnego przypisanego do tego przedziału. Aby zmienić lub zmienić kolejność pasków w kontrolce, kliknij i przeciągnij pasek uchwytu zespołu.

Poniższa ilustracja przedstawia kontrolkę paska pomocniczego z trzema przedziałami:

Pasek 0 zawiera płaską, przezroczystą kontrolkę paska narzędzi.
Pasek 1 zawiera zarówno standardowe, jak i przezroczyste przyciski listy rozwijanej.
Przedział 2 zawiera pole kombi i cztery standardowe przyciski.

Kontrolka paska pomocniczego

Obsługa kontrolek paska pomocniczego:

Listy obrazów.
Obsługa komunikatów.
Niestandardowe funkcje rysowania.
Oprócz standardowych stylów okien oprócz standardowych stylów okien. Aby uzyskać listę tych stylów, zobacz Style kontrolek paska ponownego w zestawie Windows SDK.

Aby uzyskać więcej informacji, zobacz Using CReBarCtrl (Korzystanie z CReBarCtrl).

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CReBarCtrl

Wymagania

Nagłówek: afxcmn.h

CReBarCtrl::BeginDrag

Implementuje zachowanie RB_BEGINDRAG komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

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

Parametry

uBand
Zerowy indeks przedziału, na który będzie wpływać operacja przeciągania i upuszczania.

dwPos
Wartość DWORD zawierająca współrzędne początkowej myszy. Współrzędna pozioma jest zawarta w wartości LOWORD, a współrzędna pionowa znajduje się w HIWORD. Jeśli przejdziesz (DWORD)-1, kontrolka paska pomocniczego użyje pozycji myszy podczas ostatniego wywołania wątku GetMessage kontrolki lub PeekMessage.

CReBarCtrl::Create

Tworzy kontrolkę paska pomocniczego CReBarCtrl i dołącza ją do obiektu.

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

Parametry

dwStyle
Określa kombinację stylów kontrolek paska pomocniczego zastosowanych do kontrolki. Aby uzyskać listę obsługiwanych stylów, zobacz Style kontrolek paska ponownego w zestawie Windows SDK.

Rect
Odwołanie do obiektu CRect lub struktury RECT , która jest pozycją i rozmiarem kontrolki paska pomocniczego.

pParentWnd
Wskaźnik do obiektu CWnd, który jest oknem nadrzędnym kontrolki paska pomocniczego. Nie może mieć wartości NULL.

Nid
Określa identyfikator kontrolki paska pomocniczego.

Wartość zwracana

Niezero, jeśli obiekt został utworzony pomyślnie; w przeciwnym razie 0.

Uwagi

Utwórz kontrolkę paska ponownego w dwóch krokach:

Wywołaj metodę CReBarCtrl CReBarCtrl, aby skonstruować obiekt.
Wywołaj tę funkcję składową, która tworzy kontrolkę paska pomocniczego CReBarCtrl systemu Windows i dołącza ją do obiektu.

Podczas wywoływania Createmetody typowe kontrolki są inicjowane.

Przykład

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

// Use ReBar Control.

delete pReBarCtrl;

CReBarCtrl::CreateEx

Tworzy kontrolkę (okno podrzędne) i kojarzy ją z obiektem CReBarCtrl .

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

Parametry

dwExStyle
Określa rozszerzony styl tworzonej kontrolki. Aby uzyskać listę rozszerzonych stylów systemu Windows, zobacz parametr dwExStyle dla polecenia CreateWindowEx w zestawie WINDOWS SDK.

Rect
Odwołanie do struktury RECT opisującej rozmiar i położenie okna do utworzenia w współrzędnych klienta pParentWnd.

pParentWnd
Wskaźnik do okna, który jest elementem nadrzędnym kontrolki.

Nid
Identyfikator okna podrzędnego kontrolki.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Użyj CreateEx zamiast opcji Utwórz, aby zastosować rozszerzone style systemu Windows określone przez WS_EX_ stylu rozszerzonego systemu Windows.

CReBarCtrl::CReBarCtrl

Tworzy obiekt CReBarCtrl.

CReBarCtrl();

Przykład

Zobacz przykład CReBarCtrl ::Create.

CReBarCtrl::D eleteBand

Implementuje zachowanie RB_DELETEBAND komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

BOOL DeleteBand(UINT uBand);

Parametry

uBand
Indeks zerowy przedziału do usunięcia.

Wartość zwracana

Niezero, jeśli zespół został usunięty pomyślnie; w przeciwnym razie zero.

Przykład

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

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

CReBarCtrl::D ragMove

Implementuje zachowanie komunikatu Win32 RB_DRAGMOVE zgodnie z opisem w zestawie WINDOWS SDK.

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

Parametry

dwPos
Wartość DWORD zawierająca nowe współrzędne myszy. Współrzędna pozioma jest zawarta w wartości LOWORD, a współrzędna pionowa znajduje się w HIWORD. Jeśli przejdziesz (DWORD)-1, kontrolka paska pomocniczego użyje pozycji myszy podczas ostatniego wywołania wątku GetMessage kontrolki lub PeekMessage.

CReBarCtrl::EndDrag

Implementuje zachowanie RB_ENDDRAG komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

void EndDrag();

CReBarCtrl::GetBandBorders

Implementuje zachowanie komunikatu Win32 RB_GETBANDBORDERS zgodnie z opisem w zestawie WINDOWS SDK.

void GetBandBorders(
    UINT uBand,
    LPRECT prc) const;

Parametry

uBand
Zerowy indeks przedziału, dla którego zostaną pobrane obramowania.

Chrl
Wskaźnik do struktury RECT , która będzie otrzymywać obramowania pasm. Jeśli kontrolka paska pomocniczego ma styl RBS_BANDBORDERS, każdy element członkowski tej struktury otrzyma liczbę pikseli po odpowiedniej stronie pasma, które stanowią obramowanie. Jeśli kontrolka paska pomocniczego nie ma stylu RBS_BANDBORDERS, tylko lewy element członkowski tej struktury otrzymuje prawidłowe informacje. Aby uzyskać opis stylów kontrolek paska ponownego, zobacz Style kontrolek paska ponownego w zestawie Windows SDK.

CReBarCtrl::GetBandCount

Implementuje zachowanie komunikatu Win32 RB_GETBANDCOUNT zgodnie z opisem w zestawie Windows SDK.

UINT GetBandCount() const;

Wartość zwracana

Liczba pasm przypisanych do kontrolki.

CReBarCtrl::GetBandInfo

Implementuje zachowanie komunikatu Win32 RB_GETBANDINFO zgodnie z opisem w zestawie WINDOWS SDK.

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

Parametry

uBand
Zerowy indeks przedziału, dla którego zostaną pobrane informacje.

prbbi
Wskaźnik do struktury REBARBANDINFO w celu odbierania informacji o pasmie. Należy ustawić element członkowski tej struktury na i ustawić cbSize sizeof(REBARBANDINFO) fMask element członkowski na elementy, które chcesz pobrać przed wysłaniem tej wiadomości.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

CReBarCtrl::GetBandMargins

Pobiera marginesy przedziału.

void GetBandMargins(PMARGINS pMargins);

Parametry

pMargins
Wskaźnik do struktury MARGINS, która będzie otrzymywać informacje.

Uwagi

Ta funkcja składowa emuluje funkcjonalność komunikatu RB_GETBANDMARGINS zgodnie z opisem w zestawie WINDOWS SDK.

CReBarCtrl::GetBarHeight

Pobiera wysokość paska paska pomocniczego.

UINT GetBarHeight() const;

Wartość zwracana

Wartość reprezentująca wysokość kontrolki w pikselach.

CReBarCtrl::GetBarInfo

Implementuje zachowanie RB_GETBARINFO komunikatu Win32 zgodnie z opisem w zestawie SDK systemu Windows.

BOOL GetBarInfo(REBARINFO* prbi) const;

Parametry

prbi
Wskaźnik do struktury REBARINFO , która będzie otrzymywać informacje o kontrolce paska pomocniczego. Przed wysłaniem tej wiadomości należy ustawić sizeof(REBARINFO) element członkowski cbSize tej struktury.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

CReBarCtrl::GetBkColor

Implementuje zachowanie RB_GETBKCOLOR komunikatu Win32 zgodnie z opisem w zestawie SDK systemu Windows.

COLORREF GetBkColor() const;

Wartość zwracana

Wartość COLORREF reprezentująca bieżący domyślny kolor tła.

CReBarCtrl::GetColorScheme

Pobiera strukturę COLORSCHEME dla kontrolki paska ponownego.

BOOL GetColorScheme(COLORSCHEME* lpcs);

Parametry

lpcs
Wskaźnik do struktury COLORSCHEME, zgodnie z opisem w zestawie Windows SDK.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Struktura COLORSCHEME zawiera kolor wyróżnienia przycisku i kolor cienia przycisku.

CReBarCtrl::GetDropTarget

Implementuje zachowanie RB_GETDROPTARGET komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

IDropTarget* GetDropTarget() const;

Wartość zwracana

Wskaźnik do interfejsu IDropTarget .

CReBarCtrl::GetExtendedStyle

Pobiera rozszerzone style bieżącej kontrolki paska pomocniczego.

DWORD GetExtendedStyle() const;

Wartość zwracana

Kombinacja bitowa (OR) flag wskazująca style rozszerzone. Możliwe flagi są RBS_EX_SPLITTER i RBS_EX_TRANSPARENT. Aby uzyskać więcej informacji, zobacz parametr dwMask metody CReBarCtrl::SetExtendedStyle.

Uwagi

Ta metoda wysyła komunikat RB_GETEXTENDEDSTYLE opisany w zestawie Windows SDK.

CReBarCtrl::GetImageList

CImageList Pobiera obiekt skojarzony z kontrolką paska pomocniczego.

CImageList* GetImageList() const;

Wartość zwracana

Wskaźnik do obiektu CImageList . Zwraca wartość NULL, jeśli dla kontrolki nie ustawiono żadnej listy obrazów.

Uwagi

Ta funkcja składowa używa informacji o rozmiarze i maskach przechowywanych w strukturze REBARINFO zgodnie z opisem w zestawie WINDOWS SDK.

CReBarCtrl::GetPalette

Pobiera bieżącą paletę kontrolki paska pomocniczego.

CPalette* GetPalette() const;

Wartość zwracana

Wskaźnik do obiektu CPalette określający bieżącą paletę kontrolki paska pomocniczego.

Uwagi

Należy pamiętać, że ta funkcja składowa używa CPalette obiektu jako wartości zwracanej, a nie HPALETTE.

Przykład

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 zachowanie komunikatu Win32 RB_GETRECT zgodnie z opisem w zestawie Windows SDK.

BOOL GetRect(
    UINT uBand,
    LPRECT prc) const;

Parametry

uBand
Zerowy indeks przedziału w kontrolce paska pomocniczego.

Chrl
Wskaźnik do struktury RECT , która będzie otrzymywać granice paska paska.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Przykład

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 zachowanie komunikatu Win32 RB_GETROWCOUNT zgodnie z opisem w zestawie Windows SDK.

UINT GetRowCount() const;

Wartość zwracana

Wartość UINT reprezentująca liczbę wierszy przedziału w kontrolce.

Przykład

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

CReBarCtrl::GetRowHeight

Implementuje zachowanie komunikatu Win32 RB_GETROWHEIGHT zgodnie z opisem w zestawie WINDOWS SDK.

UINT GetRowHeight(UINT uRow) const;

Parametry

uRow
Zerowy indeks przedziału, który będzie miał pobraną wysokość.

Wartość zwracana

Wartość UINT reprezentująca wysokość wiersza w pikselach.

Przykład

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 zachowanie RB_GETTEXTCOLOR komunikatu Win32 zgodnie z opisem w zestawie SDK systemu Windows.

COLORREF GetTextColor() const;

Wartość zwracana

Wartość COLORREF reprezentująca bieżący domyślny kolor tekstu.

CReBarCtrl::GetToolTips

Implementuje zachowanie RB_GETTOOLTIPS komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

CToolTipCtrl* GetToolTips() const;

Wartość zwracana

Wskaźnik do obiektu CToolTipCtrl .

Uwagi

Należy pamiętać, że implementacja GetToolTips MFC elementu zwraca wskaźnik do CToolTipCtrlelementu , a nie HWND.

CReBarCtrl::HitTest

Implementuje zachowanie komunikatu Win32 RB_HITTEST zgodnie z opisem w zestawie Windows SDK.

int HitTest(RBHITTESTINFO* prbht);

Parametry

prbht
Wskaźnik do struktury RBHITTESTINFO . Przed wysłaniem komunikatu element pt członkowski tej struktury musi zostać zainicjowany do punktu, który zostanie przetestowany, we współrzędnych klienta.

Wartość zwracana

Zerowy indeks pasma w danym punkcie lub -1, jeśli w punkcie nie było pasków pasków.

CReBarCtrl::IDToIndex

Implementuje zachowanie RB_IDTOINDEX komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

int IDToIndex(UINT uBandID) const;

Parametry

uBandID
Identyfikator zdefiniowany przez aplikację określonego przedziału przekazany w wID składowej struktury REBARBANDINFO po wstawieniu pasma.

Wartość zwracana

Indeks pasmowy oparty na zera, jeśli się powiedzie, lub -1 w przeciwnym razie. Jeśli istnieją zduplikowane indeksy przedziałów, zwracany jest pierwszy z nich.

CReBarCtrl::InsertBand

Implementuje zachowanie RB_INSERTBAND komunikatu Win32 zgodnie z opisem w zestawie SDK systemu Windows.

BOOL InsertBand(
    UINT uIndex,
    REBARBANDINFO* prbbi);

Parametry

uIndex
Indeks zerowy lokalizacji, w której zostanie wstawiony przedział. Jeśli ustawisz ten parametr na -1, kontrolka doda nowy przedział w ostatniej lokalizacji.

prbbi
Wskaźnik do struktury REBARBANDINFO , która definiuje pasm do wstawienia. Przed wywołaniem tej funkcji należy ustawić sizeof(REBARBANDINFO) element członkowski cbSize tej struktury.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Przykład

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

Zmienia rozmiar paska w kontrolce paska pomocniczego na największy rozmiar.

void MaximizeBand(UINT uBand);

Parametry

uBand
Indeks zerowy przedziału, który ma zostać zmaksymalizowany.

Uwagi

Implementuje zachowanie komunikatu Win32 RB_MAXIMIZEBAND z ustawioną wartością 0 zgodnie z fIdeal opisem w zestawie Windows SDK.

Przykład

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

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

CReBarCtrl::MinimalBand

Zmienia rozmiar paska w kontrolce paska pomocniczego na najmniejszy rozmiar.

void MinimizeBand(UINT uBand);

Parametry

uBand
Indeks zerowy przedziału do zminimalizowania.

Uwagi

Implementuje zachowanie RB_MINIMIZEBAND komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

Przykład

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

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

CReBarCtrl::MoveBand

Implementuje zachowanie RB_MOVEBAND komunikatu Win32 zgodnie z opisem w zestawie SDK systemu Windows.

BOOL MoveBand(
    UINT uFrom,
    UINT uTo);

Parametry

uFrom
Indeks zerowy przedziału, który ma zostać przeniesiony.

uTo
Indeks oparty na zerowej pozycji nowego przedziału. Ta wartość parametru nigdy nie może być większa niż liczba przedziałów minus jeden. Aby uzyskać liczbę pasm, wywołaj metodę GetBandCount.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

CReBarCtrl::P ushChevron

Implementuje zachowanie RB_PUSHCHEVRON komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

void PushChevron(
    UINT uBand,
    LPARAM lAppValue);

Parametry

uBand
Zerowy indeks przedziału, którego chevron ma być wypchnięty.

lAppValue
Wartość 32-bitowa zdefiniowana przez aplikację. Zobacz element lAppValue w RB_PUSHCHEVRON w zestawie Windows SDK.

CReBarCtrl::RestoreBand

Zmienia rozmiar paska w kontrolce paska pomocniczego na idealny rozmiar.

void RestoreBand(UINT uBand);

Parametry

uBand
Indeks zerowy przedziału, który ma zostać zmaksymalizowany.

Uwagi

Implementuje zachowanie komunikatu Win32 RB_MAXIMIZEBAND z ustawioną wartością 1 zgodnie z fIdeal opisem w zestawie SDK systemu Windows.

Przykład

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

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

CReBarCtrl::SetBandInfo

Implementuje zachowanie RB_SETBANDINFO komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

BOOL SetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi);

Parametry

uBand
Indeks na podstawie zera przedziału w celu otrzymania nowych ustawień.

prbbi
Wskaźnik do struktury REBARBANDINFO , która definiuje przedział do wstawienia. Przed wysłaniem cbSize tej wiadomości należy ustawić sizeof(REBARBANDINFO) element członkowski tej struktury.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Przykład

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

Ustawia szerokość określonego zadokowanego pasa w bieżącej kontrolce paska pomocniczego.

BOOL SetBandWidth(
    UINT uBand,
    int cxWidth);

Parametry

uBand
[in] Indeks zerowy pasm paska pomocniczego.

cxWidth
[in] Nowa szerokość paska paskowego w pikselach.

Wartość zwracana

Wartość TRUE, jeśli metoda zakończyła się pomyślnie; w przeciwnym razie, FAŁSZ.

Uwagi

Ta metoda wysyła komunikat RB_SETBANDWIDTH opisany w zestawie Windows SDK.

Przykład

Pierwszy przykład kodu definiuje zmienną , m_rebarktóra jest używana do uzyskiwania dostępu do bieżącej kontrolki paska pomocniczego. Ta zmienna jest używana w następnym przykładzie.

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

W następnym przykładzie kodu każdy pasek paska pomocniczego ma taką samą szerokość.

// 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 zachowanie RB_SETBARINFO komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

BOOL SetBarInfo(REBARINFO* prbi);

Parametry

prbi
Wskaźnik do struktury REBARINFO , która zawiera informacje do ustawienia. Przed wysłaniem cbSize tej wiadomości należy ustawić element członkowski tej struktury na sizeof(REBARINFO)

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Przykład

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

CReBarCtrl::SetBkColor

Implementuje zachowanie RB_SETBKCOLOR komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

COLORREF SetBkColor(COLORREF clr);

Parametry

Clr
Wartość COLORREF reprezentująca nowy domyślny kolor tła.

Wartość zwracana

Wartość COLORREF reprezentująca poprzedni domyślny kolor tła.

Uwagi

Zobacz ten temat, aby uzyskać więcej informacji o tym, kiedy ustawić kolor tła i jak ustawić wartość domyślną.

CReBarCtrl::SetColorScheme

Ustawia schemat kolorów przycisków na kontrolce paska pomocniczego.

void SetColorScheme(const COLORSCHEME* lpcs);

Parametry

lpcs
Wskaźnik do struktury COLORSCHEME, zgodnie z opisem w zestawie Windows SDK.

Uwagi

Struktura COLORSCHEME zawiera zarówno kolor wyróżnienia przycisku, jak i kolor cienia przycisku.

CReBarCtrl::SetExtendedStyle

Ustawia style rozszerzone dla bieżącej kontrolki paska pomocniczego.

DWORD SetExtendedStyle(
    DWORD dwMask,
    DWORD dwStyleEx);

Parametry

dwMask
[in] Kombinacja bitowa (OR) flag określających, które flagi w parametrze dwStyleEx mają zastosowanie. Użyj co najmniej jednej z następujących wartości:

RBS_EX_SPLITTER: Domyślnie pokaż rozdzielacz na dole w trybie poziomym i po prawej stronie w trybie pionowym.
RBS_EX_TRANSPARENT: Przekaż komunikat WM_ERASEBKGND do okna nadrzędnego.

dwStyleEx
[in] Kombinacja bitowa (OR) flag określających style do zastosowania. Aby ustawić styl, określ tę samą flagę, która jest używana w parametrze dwMask . Aby zresetować styl, określ zero binarne.

Wartość zwracana

Poprzedni styl rozszerzony.

Uwagi

Ta metoda wysyła komunikat RB_SETEXTENDEDSTYLE opisany w zestawie Windows SDK.

CReBarCtrl::SetImageList

Przypisuje listę obrazów do kontrolki paska pomocniczego.

BOOL SetImageList(CImageList* pImageList);

Parametry

pImageList
Wskaźnik do obiektu CImageList zawierającego listę obrazów, która ma zostać przypisana do kontrolki paska pomocniczego.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

CReBarCtrl::SetOwner

Implementuje zachowanie RB_SETPARENT komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

CWnd* SetOwner(CWnd* pWnd);

Parametry

pWnd
Wskaźnik do CWnd obiektu, który ma być ustawiony jako właściciel kontrolki paska pomocniczego.

Wartość zwracana

Wskaźnik do obiektu CWnd , który jest bieżącym właścicielem kontrolki paska pomocniczego.

Uwagi

Należy pamiętać, że ta funkcja składowa używa wskaźników do CWnd obiektów zarówno dla bieżącego, jak i wybranego właściciela kontrolki paska pomocniczego, a nie uchwytów do okien.

Uwaga

Ta funkcja składowa nie zmienia rzeczywistego elementu nadrzędnego ustawionego podczas tworzenia kontrolki; raczej wysyła komunikaty powiadomień do określonego okna.

CReBarCtrl::SetPalette

Implementuje zachowanie komunikatu Win32 RB_SETPALETTE zgodnie z opisem w zestawie Windows SDK.

CPalette* SetPalette(HPALETTE hPal);

Parametry

hPal
HpALETTE, który określa nową paletę, która będzie używana przez kontrolkę paska pomocniczego.

Wartość zwracana

Wskaźnik do obiektu CPalette określający poprzednią paletę kontrolki paska pomocniczego.

Uwagi

Należy pamiętać, że ta funkcja składowa używa CPalette obiektu jako wartości zwracanej, a nie HPALETTE.

CReBarCtrl::SetTextColor

Implementuje zachowanie RB_SETTEXTCOLOR komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

COLORREF SetTextColor(COLORREF clr);

Parametry

Clr
Wartość COLORREF reprezentująca nowy kolor tekstu w CReBarCtrl obiekcie.

Wartość zwracana

Wartość COLORREF reprezentująca poprzedni kolor tekstu skojarzony z obiektemCReBarCtrl.

Uwagi

Zapewnia obsługę elastyczności koloru tekstu w kontrolce paska pomocniczego.

CReBarCtrl::SetToolTips

Kojarzy kontrolkę porad narzędzia z kontrolką paska pomocniczego.

void SetToolTips(CToolTipCtrl* pToolTip);

Parametry

pToolTip
Wskaźnik do obiektu CToolTipCtrl

Uwagi

Należy zniszczyć obiekt po zakończeniu CToolTipCtrl pracy z nim.

CReBarCtrl::SetWindowTheme

Ustawia styl wizualny kontrolki paska pomocniczego.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parametry

pszSubAppName
Wskaźnik do ciągu Unicode, który zawiera styl wizualizacji paska do ustawienia.

Wartość zwracana

Wartość zwracana nie jest używana.

Uwagi

Ta funkcja składowa emuluje funkcjonalność komunikatu RB_SETWINDOWTHEME zgodnie z opisem w zestawie WINDOWS SDK.

CReBarCtrl::ShowBand

Implementuje zachowanie komunikatu Win32 RB_SHOWBAND zgodnie z opisem w zestawie WINDOWS SDK.

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

Parametry

uBand
Zerowy indeks przedziału w kontrolce paska pomocniczego.

FShow
Wskazuje, czy przedział powinien być wyświetlany, czy ukryty. Jeśli ta wartość ma wartość TRUE, zostanie wyświetlony przedział. W przeciwnym razie zespół będzie ukryty.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

CReBarCtrl::SizeToRect

Implementuje zachowanie RB_SIZETORECT komunikatu Win32 zgodnie z opisem w zestawie WINDOWS SDK.

BOOL SizeToRect(CRect& rect);

Parametry

Rect
Odwołanie do obiektu CRect , który określa prostokąt, do którego ma być rozmiar kontrolki paska pomocniczego.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie zero.

Uwagi

Należy pamiętać, że ta funkcja składowa używa CRect obiektu jako parametru RECT , a nie struktury.

Zobacz też

Klasa CWnd
Wykres hierarchii

Udostępnij za pośrednictwem

Klasa CReBarCtrl

Składnia

Elementy członkowskie

Konstruktory publiczne

Metody publiczne

Uwagi

Kontrolka paska pomocniczego

Hierarchia dziedziczenia

Wymagania

CReBarCtrl::BeginDrag

Parametry

CReBarCtrl::Create

Parametry

Wartość zwracana

Uwagi

Przykład

CReBarCtrl::CreateEx

Parametry

Wartość zwracana

Uwagi

CReBarCtrl::CReBarCtrl

Przykład

CReBarCtrl::D eleteBand

Parametry

Wartość zwracana

Przykład

CReBarCtrl::D ragMove

Parametry

CReBarCtrl::EndDrag

CReBarCtrl::GetBandBorders

Parametry

CReBarCtrl::GetBandCount

Wartość zwracana

CReBarCtrl::GetBandInfo

Parametry

Wartość zwracana

CReBarCtrl::GetBandMargins

Parametry

Uwagi

CReBarCtrl::GetBarHeight

Wartość zwracana

CReBarCtrl::GetBarInfo

Parametry

Wartość zwracana

CReBarCtrl::GetBkColor

Wartość zwracana

CReBarCtrl::GetColorScheme

Parametry

Wartość zwracana

Uwagi

CReBarCtrl::GetDropTarget

Wartość zwracana

CReBarCtrl::GetExtendedStyle

Wartość zwracana

Uwagi

CReBarCtrl::GetImageList

Wartość zwracana

Uwagi

CReBarCtrl::GetPalette

Wartość zwracana

Uwagi

Przykład

CReBarCtrl::GetRect

Parametry

Wartość zwracana

Przykład

CReBarCtrl::GetRowCount

Wartość zwracana

Przykład

CReBarCtrl::GetRowHeight

Parametry

Wartość zwracana

Przykład

CReBarCtrl::GetTextColor

Wartość zwracana

CReBarCtrl::GetToolTips

Wartość zwracana

Uwagi

CReBarCtrl::HitTest