Klasa CReBarCtrl
Hermetyzuje funkcjonalność kontrolki paska pomocniczego, która jest kontenerem dla okna podrzędnego.
Składnia
class CReBarCtrl : public CWnd
Członkowie
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 | Aktualizacje 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::GetTool Wskazówki | 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::SetTool Wskazówki | 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
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ę
CReBarCtrlCReBarCtrl, aby skonstruować obiekt.Wywołaj tę funkcję składową, która tworzy kontrolkę paska pomocniczego
CReBarCtrlsystemu 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.
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 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ć cbSizesizeof(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::GetTool Wskazówki
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::SetTool Wskazówki
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ż
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla