CReBarCtrl Sınıfı

Makale
08/04/2024

Bir alt pencere için kapsayıcı olan bir rebar denetiminin işlevselliğini kapsüller.

Sözdizimi

class CReBarCtrl : public CWnd

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CReBarCtrl::CReBarCtrl	Bir `CReBarCtrl` nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CReBarCtrl::BeginDrag	Rebar denetimini sürükleyip bırakma moduna geçirir.
CReBarCtrl::Create	Rebar denetimini oluşturur ve nesnesine `CReBarCtrl` ekler.
CReBarCtrl::CreateEx	Belirtilen Windows genişletilmiş stilleriyle bir rebar denetimi oluşturur ve bunu bir `CReBarCtrl` nesneye ekler.
CReBarCtrl::D eleteBand	Bir bandı bir rebar denetiminden siler.
CReBarCtrl::D ragMove	çağrısından `BeginDrag`sonra rebar denetimindeki sürükleme konumunu güncelleştirir.
CReBarCtrl::EndDrag	Rebar denetiminin sürükle ve bırak işlemini sonlandırır.
CReBarCtrl::GetBandBorders	Bir bandın kenarlıklarını alır.
CReBarCtrl::GetBandCount	Şu anda rebar denetiminde bulunan bantların sayısını alır.
CReBarCtrl::GetBandInfo	Bir rebar denetiminde belirtilen bant hakkındaki bilgileri alır.
CReBarCtrl::GetBandMargins	Bir bandın kenar boşluklarını alır.
CReBarCtrl::GetBarHeight	Rebar denetiminin yüksekliğini alır.
CReBarCtrl::GetBarInfo	Rebar denetimi ve kullandığı görüntü listesi hakkındaki bilgileri alır.
CReBarCtrl::GetBkColor	Bir rebar denetiminin varsayılan arka plan rengini alır.
CReBarCtrl::GetColorScheme	Rebar denetimiyle ilişkili COLORSCHEME yapısını alır.
CReBarCtrl::GetDropTarget	Bir rebar denetiminin `IDropTarget` arabirim işaretçisini alır.
CReBarCtrl::GetExtendedStyle	Geçerli rebar denetiminin genişletilmiş stilini alır.
CReBarCtrl::GetImageList	Bir rebar denetimiyle ilişkili görüntü listesini alır.
CReBarCtrl::GetPalette	Rebar denetiminin geçerli paletini alır.
CReBarCtrl::GetRect	Bir rebar denetimindeki belirli bir bant için sınırlayıcı dikdörtgeni alır.
CReBarCtrl::GetRowCount	Bir rebar denetimindeki bant satırlarının sayısını alır.
CReBarCtrl::GetRowHeight	Bir rebar denetiminde belirtilen satırın yüksekliğini alır.
CReBarCtrl::GetTextColor	Bir rebar denetiminin varsayılan metin rengini alır.
CReBarCtrl::GetToolTips	Tutamacı, rebar denetimiyle ilişkili herhangi bir araç ipucu denetimine alır.
CReBarCtrl::HitTest	Bu noktada bir rebar bandı varsa, bir rebar bandının hangi bölümünün ekranda belirli bir noktada olduğunu belirler.
CReBarCtrl::IDToIndex	Bir bant tanımlayıcısını (ID) bir rebar denetimindeki bant dizinine dönüştürür.
CReBarCtrl::InsertBand	Bir rebar denetimine yeni bir bant ekler.
CReBarCtrl::MaximizeBand	Bir rebar denetimindeki bir bandı en büyük boyutuna göre yeniden boyutlandırıyor.
CReBarCtrl::MinimizeBand	Bir rebar denetimindeki bir bandı en küçük boyutuna kadar yeniden boyutlandırıyor.
CReBarCtrl::MoveBand	Bir bandı bir dizinden diğerine taşır.
CReBarCtrl::P ushChevron	Program aracılığıyla bir köşeli çift ayraç iter.
CReBarCtrl::RestoreBand	Bir rebar denetimindeki bandı ideal boyutuna göre yeniden boyutlandırıyor.
CReBarCtrl::SetBandInfo	Bir rebar denetimindeki mevcut bandın özelliklerini ayarlar.
CReBarCtrl::SetBandWidth	Geçerli rebar denetiminde belirtilen yerleşik bandın genişliğini ayarlar.
CReBarCtrl::SetBarInfo	Bir rebar denetiminin özelliklerini ayarlar.
CReBarCtrl::SetBkColor	Bir rebar denetiminin varsayılan arka plan rengini ayarlar.
CReBarCtrl::SetColorScheme	Bir rebar denetimindeki düğmelerin renk düzenini ayarlar.
CReBarCtrl::SetExtendedStyle	Geçerli rebar denetimi için genişletilmiş stilleri ayarlar.
CReBarCtrl::SetImageList	Bir rebar denetiminin görüntü listesini ayarlar.
CReBarCtrl::SetOwner	Bir rebar denetiminin sahip penceresini ayarlar.
CReBarCtrl::SetPalette	Rebar denetiminin geçerli paletini ayarlar.
CReBarCtrl::SetTextColor	Bir rebar denetiminin varsayılan metin rengini ayarlar.
CReBarCtrl::SetToolTips	Araç ipucu denetimini rebar denetimiyle ilişkilendirir.
CReBarCtrl::SetWindowTheme	Rebar denetiminin görsel stilini ayarlar.
CReBarCtrl::ShowBand	Bir rebar denetiminde belirli bir bandı gösterir veya gizler.
CReBarCtrl::SizeToRect	Bir rebar denetimini belirtilen dikdörtgene sığdırıyor.

Açıklamalar

Rebar denetiminin bulunduğu uygulama, rebar denetiminin içerdiği alt pencereyi rebar bandına atar. Alt pencere genellikle başka bir yaygın denetimdir.

Rebar denetimleri bir veya daha fazla bant içerir. Her bant bir kavrama çubuğu, bit eşlem, metin etiketi ve alt pencerenin birleşimini içerebilir. Bant bu öğelerin yalnızca birini içerebilir.

Rebar denetimi, alt pencereyi belirtilen bir arka plan bit eşlemi üzerinde görüntüleyebilir. RBBS_FIXEDSIZE stilini kullananlar dışında tüm rebar denetim bantları yeniden boyutlandırılabilir. Bir rebar denetim bandını yeniden konumlandırdığınızda veya yeniden boyutlandırdığınızda, rebar denetimi bu banda atanan alt pencerenin boyutunu ve konumunu yönetir. Denetimdeki bantların sırasını yeniden boyutlandırmak veya değiştirmek için, bir bandın kavrama çubuğuna tıklayın ve sürükleyin.

Aşağıdaki çizimde üç bant içeren bir rebar denetimi gösterilmektedir:

Bant 0 düz, saydam bir araç çubuğu denetimi içerir.
Bant 1 hem saydam standart hem de saydam açılan düğmeler içerir.
Band 2'de birleşik giriş kutusu ve dört standart düğme bulunur.

Çubuk denetimi

Rebar denetimleri desteği:

Resim listeleri.
İleti işleme.
Özel çizim işlevi.
Standart pencere stillerine ek olarak çeşitli denetim stilleri. Bu stillerin listesi için bkz . Windows SDK'sında Rebar Denetim Stilleri .

Daha fazla bilgi için bkz . CReBarCtrl kullanma.

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CReBarCtrl

Gereksinimler

Üst bilgi: afxcmn.h

CReBarCtrl::BeginDrag

Windows SDK'sında açıklandığı gibi Win32 iletisinin davranışını RB_BEGINDRAG uygular.

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

Parametreler

uBand
Sürükle ve bırak işleminin etkileyeceği bandın sıfır tabanlı dizini.

dwPos
Başlangıç faresi koordinatlarını içeren bir DWORD değeri. Yatay koordinat LOWORD içinde, dikey koordinat ise HIWORD içinde yer alır. (DWORD)-1'i geçirirseniz, rebar denetimi, denetimin iş parçacığının en PeekMessageson veya çağrısında GetMessage farenin konumunu kullanır.

CReBarCtrl::Create

Rebar denetimini oluşturur ve nesnesine CReBarCtrl ekler.

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

Parametreler

dwStyle
Denetime uygulanan rebar denetim stillerinin birleşimini belirtir. Desteklenen stillerin listesi için bkz . Windows SDK'sında Rebar Denetim Stilleri .

Rect
Rebar denetiminin konumu ve boyutu olan CRect nesnesine veya RECT yapısına başvuru.

pParentWnd
Rebar denetiminin üst penceresi olan bir CWnd nesnesine işaretçi. NULL olmamalıdır.

Nıd
Rebar denetiminin denetim kimliğini belirtir.

Dönüş Değeri

Nesne başarıyla oluşturulduysa sıfır olmayan; aksi takdirde 0.

Açıklamalar

İki adımda bir rebar denetimi oluşturun:

Nesne CReBarCtrl oluşturmak için CReBarCtrl çağrısı yapın.
Windows rebar denetimini oluşturan ve nesneye ekleyen bu üye işlevini çağırın CReBarCtrl .

çağırdığınızda Createortak denetimler başlatılır.

Örnek

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

// Use ReBar Control.

delete pReBarCtrl;

CReBarCtrl::CreateEx

Bir denetim (alt pencere) oluşturur ve bunu nesnesiyle CReBarCtrl ilişkilendirir.

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

Parametreler

dwExStyle
Oluşturulan denetimin genişletilmiş stilini belirtir. Genişletilmiş Windows stillerinin listesi için Windows SDK'sında CreateWindowEx için dwExStyle parametresine bakın.

dwStyle
Denetime uygulanan rebar denetim stillerinin birleşimini belirtir. Desteklenen stillerin listesi için bkz . Windows SDK'sında Rebar Denetim Stilleri .

Rect
pParentWnd istemci koordinatlarında oluşturulacak pencerenin boyutunu ve konumunu açıklayan rect yapısına başvuru.

pParentWnd
Denetimin üst öğesi olan pencere işaretçisi.

Nıd
Denetimin alt pencere kimliği.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Windows genişletilmiş stil ön biçimi WS_EX_ tarafından belirtilen genişletilmiş Windows stillerini uygulamak için Oluştur yerine kullanınCreateEx.

CReBarCtrl::CReBarCtrl

Bir CReBarCtrl nesnesi oluşturur.

CReBarCtrl();

Örnek

CReBarCtrl::Create örneğine bakın.

CReBarCtrl::D eleteBand

Windows SDK'sında açıklandığı gibi Win32 ileti RB_DELETEBAND davranışını uygular.

BOOL DeleteBand(UINT uBand);

Parametreler

uBand
Silinecek bandın sıfır tabanlı dizini.

Dönüş Değeri

Bant başarıyla silindiyse sıfır olmayan; aksi takdirde sıfır.

Örnek

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

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

CReBarCtrl::D ragMove

Windows SDK'sında açıklandığı gibi Win32 ileti RB_DRAGMOVE davranışını uygular.

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

Parametreler

dwPos
Yeni fare koordinatlarını içeren bir DWORD değeri. Yatay koordinat LOWORD içinde, dikey koordinat ise HIWORD içinde yer alır. (DWORD)-1'i geçirirseniz, rebar denetimi, denetimin iş parçacığının en PeekMessageson veya çağrısında GetMessage farenin konumunu kullanır.

CReBarCtrl::EndDrag

Windows SDK'da açıklandığı gibi Win32 iletisinin davranışını RB_ENDDRAG uygular.

void EndDrag();

CReBarCtrl::GetBandBorders

Windows SDK'da açıklandığı gibi Win32 ileti RB_GETBANDBORDERS davranışını uygular.

void GetBandBorders(
    UINT uBand,
    LPRECT prc) const;

Parametreler

uBand
Kenarlıkların alınacağı bandın sıfır tabanlı dizini.

Çhc
Bant kenarlıklarını alacak rect yapısının işaretçisi. Rebar denetimi RBS_BANDBORDERS stiline sahipse, bu yapının her üyesi bandın ilgili tarafında kenarlık oluşturan piksel sayısını alır. Rebar denetimi RBS_BANDBORDERS stiline sahip değilse, yalnızca bu yapının sol üyesi geçerli bilgileri alır. Rebar denetim stillerinin açıklaması için bkz . Windows SDK'sında Rebar Denetim Stilleri .

CReBarCtrl::GetBandCount

Windows SDK'sında açıklandığı gibi Win32 ileti RB_GETBANDCOUNT davranışını uygular.

UINT GetBandCount() const;

Dönüş Değeri

Denetime atanan bant sayısı.

CReBarCtrl::GetBandInfo

Windows SDK'sında açıklandığı gibi Win32 iletisinin davranışını RB_GETBANDINFO uygular.

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

Parametreler

uBand
Bilgilerin alınacağı bandın sıfır tabanlı dizini.

prbbi
Bant bilgilerini almak için REBARBANDINFO yapısının işaretçisi. Bu yapının sizeof(REBARBANDINFO) üyesini cbSize olarak ayarlamanız ve bu iletiyi göndermeden önce üyeyi almak istediğiniz öğelere ayarlamanız fMask gerekir.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

CReBarCtrl::GetBandMargins

Bandın kenar boşluklarını alır.

void GetBandMargins(PMARGINS pMargins);

Parametreler

pMargins
Bilgileri alacak MARGINS yapısının işaretçisi.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi RB_GETBANDMARGINS iletisinin işlevselliğine öykünmektedir.

CReBarCtrl::GetBarHeight

Rebar çubuğunun yüksekliğini alır.

UINT GetBarHeight() const;

Dönüş Değeri

Denetimin yüksekliğini piksel cinsinden temsil eden değer.

CReBarCtrl::GetBarInfo

Windows SDK'da açıklandığı gibi Win32 ileti RB_GETBARINFO davranışını uygular.

BOOL GetBarInfo(REBARINFO* prbi) const;

Parametreler

prbi
Rebar denetim bilgilerini alacak reBARINFO yapısının işaretçisi. Bu iletiyi göndermeden önce bu yapının cbSize üyesini olarak sizeof(REBARINFO) ayarlamanız gerekir.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

CReBarCtrl::GetBkColor

Windows SDK'sında açıklandığı gibi Win32 ileti RB_GETBKCOLOR davranışını uygular.

COLORREF GetBkColor() const;

Dönüş Değeri

Geçerli varsayılan arka plan rengini temsil eden COLORREF değeri.

CReBarCtrl::GetColorScheme

Rebar denetimi için COLORSCHEME yapısını alır.

BOOL GetColorScheme(COLORSCHEME* lpcs);

Parametreler

lpcs
Windows SDK'sında açıklandığı gibi COLORSCHEME yapısının işaretçisi.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

Yapı, COLORSCHEME düğme vurgu rengini ve düğme gölge rengini içerir.

CReBarCtrl::GetDropTarget

Windows SDK'da açıklandığı gibi Win32 iletisinin davranışını RB_GETDROPTARGET uygular.

IDropTarget* GetDropTarget() const;

Dönüş Değeri

IDropTarget arabirimine yönelik bir işaretçi.

CReBarCtrl::GetExtendedStyle

Geçerli rebar denetiminin genişletilmiş stillerini alır.

DWORD GetExtendedStyle() const;

Dönüş Değeri

Genişletilmiş stilleri gösteren bit düzeyinde bir bayrak bileşimi (OR). Olası bayraklar RBS_EX_SPLITTER ve RBS_EX_TRANSPARENT. Daha fazla bilgi için CReBarCtrl::SetExtendedStyle yönteminin dwMask parametresine bakın.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan RB_GETEXTENDEDSTYLE iletisini gönderir.

CReBarCtrl::GetImageList

CImageList Bir rebar denetimiyle ilişkili nesneyi alır.

CImageList* GetImageList() const;

Dönüş Değeri

CImageList nesnesinin işaretçisi. Denetim için resim listesi ayarlı değilse NULL döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi REBARINFO yapısında depolanan boyut ve maske bilgilerini kullanır.

CReBarCtrl::GetPalette

Rebar denetiminin geçerli paletini alır.

CPalette* GetPalette() const;

Dönüş Değeri

Rebar denetiminin geçerli paletini belirten bir CPalette nesnesi işaretçisi.

Açıklamalar

Bu üye işlevinin, HPALETTE yerine dönüş değeri olarak bir CPalette nesne kullandığını unutmayın.

Örnek

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

Windows SDK'da açıklandığı gibi Win32 ileti RB_GETRECT davranışını uygular.

BOOL GetRect(
    UINT uBand,
    LPRECT prc) const;

Parametreler

uBand
Rebar denetimindeki bir bandın sıfır tabanlı dizini.

Çhc
Rebar bandının sınırlarını alacak rect yapısının işaretçisi.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

Örnek

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

Windows SDK'da açıklandığı gibi Win32 ileti RB_GETROWCOUNT davranışını uygular.

UINT GetRowCount() const;

Dönüş Değeri

Denetimdeki bant satırlarının sayısını temsil eden bir UINT değeri.

Örnek

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

CReBarCtrl::GetRowHeight

Windows SDK'da açıklandığı gibi Win32 ileti RB_GETROWHEIGHT davranışını uygular.

UINT GetRowHeight(UINT uRow) const;

Parametreler

uRow
Yüksekliği alınacak bandın sıfır tabanlı dizini.

Dönüş Değeri

Satır yüksekliğini piksel cinsinden temsil eden bir UINT değeri.

Örnek

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

Windows SDK'da açıklandığı gibi Win32 ileti RB_GETTEXTCOLOR davranışını uygular.

COLORREF GetTextColor() const;

Dönüş Değeri

Geçerli varsayılan metin rengini temsil eden COLORREF değeri.

CReBarCtrl::GetToolTips

Windows SDK'da açıklandığı gibi Win32 iletisinin davranışını RB_GETTOOLTIPS uygular.

CToolTipCtrl* GetToolTips() const;

Dönüş Değeri

CToolTipCtrl nesnesinin işaretçisi.

Açıklamalar

MFC uygulamasının GetToolTips , HWND yerine öğesine CToolTipCtrlbir işaretçi döndürdüğünü unutmayın.

CReBarCtrl::HitTest

Windows SDK'da açıklandığı gibi Win32 ileti RB_HITTEST davranışını uygular.

int HitTest(RBHITTESTINFO* prbht);

Parametreler

prbht
RBHITTESTINFO yapısının işaretçisi. İletiyi göndermeden önce, pt bu yapının üyesi istemci koordinatlarında test edilecek noktaya başlatılmalıdır.

Dönüş Değeri

Belirtilen noktada bandın sıfır tabanlı dizini veya bu noktada bir rebar bandı yoksa -1.

CReBarCtrl::IDToIndex

Windows SDK'da açıklandığı gibi Win32 iletisinin davranışını RB_IDTOINDEX uygular.

int IDToIndex(UINT uBandID) const;

Parametreler

uBandID
Belirtilen bandın uygulama tanımlı tanımlayıcısı, bant eklendiğinde REBARBANDINFO yapısının üyesine geçirilirwID.

Dönüş Değeri

Başarılı olursa sıfır tabanlı bant dizini veya aksi takdirde -1. Yinelenen bant dizinleri varsa, ilki döndürülür.

CReBarCtrl::InsertBand

Windows SDK'da açıklandığı gibi Win32 ileti RB_INSERTBAND davranışını uygular.

BOOL InsertBand(
    UINT uIndex,
    REBARBANDINFO* prbbi);

Parametreler

uIndex
Bandın eklendiği konumun sıfır tabanlı dizini. Bu parametreyi -1 olarak ayarlarsanız, denetim yeni bandı son konuma ekler.

prbbi
Eklenecek bandı tanımlayan REBARBANDINFO yapısının işaretçisi. Bu işlevi çağırmadan önce bu yapının cbSize üyesini olarak sizeof(REBARBANDINFO) ayarlamanız gerekir.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

Örnek

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

Bir rebar denetimindeki bir bandı en büyük boyutuna göre yeniden boyutlandırıyor.

void MaximizeBand(UINT uBand);

Parametreler

uBand
En üst düzeye çıkarılacak bandın sıfır tabanlı dizini.

Açıklamalar

Windows SDK'da açıklandığı gibi Win32 iletisinin davranışını fIdeal 0 olarak ayarlanmış RB_MAXIMIZEBAND uygular.

Örnek

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

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

CReBarCtrl::MinimizeBand

Bir rebar denetimindeki bir bandı en küçük boyutuna kadar yeniden boyutlandırıyor.

void MinimizeBand(UINT uBand);

Parametreler

uBand
Simge durumuna küçültülecek bandın sıfır tabanlı dizini.

Açıklamalar

Windows SDK'da açıklandığı gibi Win32 ileti RB_MINIMIZEBAND davranışını uygular.

Örnek

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

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

CReBarCtrl::MoveBand

Windows SDK'da açıklandığı gibi Win32 ileti RB_MOVEBAND davranışını uygular.

BOOL MoveBand(
    UINT uFrom,
    UINT uTo);

Parametreler

uFrom
Taşınacak bandın sıfır tabanlı dizini.

uTo
Yeni bant konumunun sıfır tabanlı dizini. Bu parametre değeri hiçbir zaman bant sayısı eksi bir değerinden büyük olmamalıdır. Bant sayısını almak için GetBandCount'u çağırın.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

CReBarCtrl::P ushChevron

Windows SDK'sında açıklandığı gibi Win32 iletisinin davranışını RB_PUSHCHEVRON uygular.

void PushChevron(
    UINT uBand,
    LPARAM lAppValue);

Parametreler

uBand
Köşeli çift ayraç gönderilecek olan bandın sıfır tabanlı dizini.

lAppValue
Uygulama tanımlı 32 bit değer. Bkz. Windows SDK'sında RB_PUSHCHEVRON lAppValue.

CReBarCtrl::RestoreBand

Bir rebar denetimindeki bandı ideal boyutuna göre yeniden boyutlandırıyor.

void RestoreBand(UINT uBand);

Parametreler

uBand
En üst düzeye çıkarılacak bandın sıfır tabanlı dizini.

Açıklamalar

Windows SDK'sında açıklandığı gibi, 1 olarak ayarlanmış win32 iletisi RB_MAXIMIZEBAND fIdeal davranışını uygular.

Örnek

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

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

CReBarCtrl::SetBandInfo

Windows SDK'sında açıklandığı gibi Win32 iletisinin davranışını RB_SETBANDINFO uygular.

BOOL SetBandInfo(
    UINT uBand,
    REBARBANDINFO* prbbi);

Parametreler

uBand
Yeni ayarları almak için bandın sıfır tabanlı dizini.

prbbi
Eklenecek bandı tanımlayan REBARBANDINFO yapısının işaretçisi. Bu iletiyi göndermeden önce bu yapının üyesini olarak sizeof(REBARBANDINFO) ayarlamanız cbSize gerekir.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

Örnek

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

Geçerli rebar denetiminde belirtilen yerleşik bandın genişliğini ayarlar.

BOOL SetBandWidth(
    UINT uBand,
    int cxWidth);

Parametreler

uBand
[in] Bir rebar bandının sıfır tabanlı dizini.

cxWidth
[in] Rebar bandının piksel cinsinden yeni genişliği.

Dönüş Değeri

Yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan RB_SETBANDWIDTH iletisini gönderir.

Örnek

İlk kod örneği, m_rebargeçerli rebar denetimine erişmek için kullanılan değişkenini tanımlar. Bu değişken sonraki örnekte kullanılır.

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

Sonraki kod örneği, her bir rebar bandını aynı genişlikte olacak şekilde ayarlar.

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

Windows SDK'sında açıklandığı gibi Win32 ileti RB_SETBARINFO davranışını uygular.

BOOL SetBarInfo(REBARINFO* prbi);

Parametreler

prbi
Ayarlanacak bilgileri içeren REBARINFO yapısının işaretçisi. Bu iletiyi göndermeden önce bu yapının üyesini olarak sizeof(REBARINFO) ayarlamanız cbSize gerekir

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

Örnek

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

CReBarCtrl::SetBkColor

Windows SDK'da açıklandığı gibi Win32 iletisinin davranışını RB_SETBKCOLOR uygular.

COLORREF SetBkColor(COLORREF clr);

Parametreler

Clr
Yeni varsayılan arka plan rengini temsil eden COLORREF değeri.

Dönüş Değeri

Önceki varsayılan arka plan rengini temsil eden COLORREF değeri.

Açıklamalar

Arka plan renginin ne zaman ayarlanacağı ve varsayılanın nasıl ayarlanacağı hakkında daha fazla bilgi için bu konuya bakın.

CReBarCtrl::SetColorScheme

Bir rebar denetimindeki düğmelerin renk düzenini ayarlar.

void SetColorScheme(const COLORSCHEME* lpcs);

Parametreler

lpcs
Windows SDK'sında açıklandığı gibi COLORSCHEME yapısının işaretçisi.

Açıklamalar

Yapı hem COLORSCHEME düğme vurgu rengini hem de düğme gölge rengini içerir.

CReBarCtrl::SetExtendedStyle

Geçerli rebar denetimi için genişletilmiş stilleri ayarlar.

DWORD SetExtendedStyle(
    DWORD dwMask,
    DWORD dwStyleEx);

Parametreler

dwMask
[in] dwStyleEx parametresindeki hangi bayrakların uygulanacağını belirten bit düzeyinde bir bayrak bileşimi (OR). Aşağıdaki değerlerden birini veya daha fazlasını kullanın:

RBS_EX_SPLITTER: Varsayılan olarak, bölmeyi yatay modda altta ve sağda dikey modda gösterin.
RBS_EX_TRANSPARENT: WM_ERASEBKGND iletisini üst pencereye iletin.

dwStyleEx
[in] Uygulanacak stilleri belirten bit düzeyinde bir bayrak bileşimi (VEYA). Stil ayarlamak için dwMask parametresinde kullanılan bayrağın aynısını belirtin. Stili sıfırlamak için ikili sıfır belirtin.

Dönüş Değeri

Önceki genişletilmiş stil.

Açıklamalar

Bu yöntem, Windows SDK'sında açıklanan RB_SETEXTENDEDSTYLE iletisini gönderir.

CReBarCtrl::SetImageList

Rebar denetimine bir görüntü listesi atar.

BOOL SetImageList(CImageList* pImageList);

Parametreler

pImageList
Rebar denetimine atanacak görüntü listesini içeren bir CImageList nesnesine yönelik işaretçi.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

CReBarCtrl::SetOwner

Windows SDK'da açıklandığı gibi Win32 ileti RB_SETPARENT davranışını uygular.

CWnd* SetOwner(CWnd* pWnd);

Parametreler

pWnd
Bir nesnenin rebar denetiminin sahibi olarak ayarlanacağı işaretçi CWnd .

Dönüş Değeri

Rebar denetiminin geçerli sahibi olan bir CWnd nesnesine işaretçi.

Açıklamalar

Bu üye işlevinin, pencere tutamaçları CWnd yerine, hem geçerli hem de seçili rebar denetiminin sahibi için nesnelere yönelik işaretçiler kullandığını unutmayın.

Not

Bu üye işlevi, denetim oluşturulduğunda ayarlanan gerçek üst öğeyi değiştirmez; bunun yerine, belirttiğiniz pencereye bildirim iletileri gönderir.

CReBarCtrl::SetPalette

Windows SDK'da açıklandığı gibi Win32 ileti RB_SETPALETTE davranışını uygular.

CPalette* SetPalette(HPALETTE hPal);

Parametreler

hPal
Rebar denetiminin kullanacağı yeni paleti belirten bir HPALETTE.

Dönüş Değeri

Rebar denetiminin önceki paletini belirten bir CPalette nesnesi işaretçisi.

Açıklamalar

Bu üye işlevinin, HPALETTE yerine dönüş değeri olarak bir CPalette nesne kullandığını unutmayın.

CReBarCtrl::SetTextColor

Windows SDK'da açıklandığı gibi Win32 ileti RB_SETTEXTCOLOR davranışını uygular.

COLORREF SetTextColor(COLORREF clr);

Parametreler

Clr
Nesnedeki yeni metin rengini CReBarCtrl temsil eden COLORREF değeri.

Dönüş Değeri

Nesneyle CReBarCtrl ilişkili önceki metin rengini temsil eden COLORREF değeri.

Açıklamalar

Bir rebar denetiminde metin rengi esnekliğini desteklemek için sağlanır.

CReBarCtrl::SetToolTips

Araç ipucu denetimini bir rebar denetimiyle ilişkilendirir.

void SetToolTips(CToolTipCtrl* pToolTip);

Parametreler

pToolTip
CToolTipCtrl nesnesine işaretçi

Açıklamalar

İşiniz bittiğinde nesneyi yok CToolTipCtrl etmeniz gerekir.

CReBarCtrl::SetWindowTheme

Rebar denetiminin görsel stilini ayarlar.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parametreler

pszSubAppName
Ayarlanacağı rebar görsel stilini içeren unicode dize işaretçisi.

Dönüş Değeri

Dönüş değeri kullanılmaz.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi RB_SETWINDOWTHEME iletisinin işlevselliğine öykünmektedir.

CReBarCtrl::ShowBand

Windows SDK'da açıklandığı gibi Win32 iletisinin davranışını RB_SHOWBAND uygular.

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

Parametreler

uBand
Rebar denetimindeki bir bandın sıfır tabanlı dizini.

fShow
Bandın gösterilmesi mi yoksa gizlenmesi mi gerektiğini gösterir. Bu değer TRUE ise bant gösterilir. Aksi takdirde, bant gizlenir.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

CReBarCtrl::SizeToRect

Windows SDK'sında açıklandığı gibi Win32 ileti RB_SIZETORECT davranışını uygular.

BOOL SizeToRect(CRect& rect);

Parametreler

Rect
Rebar denetiminin boyutlandırılacağı dikdörtgeni belirten bir CRect nesnesi başvurusu.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

Bu üye işlevinin yapı yerine parametre olarak bir CRect RECT nesnesi kullandığını unutmayın.

Ayrıca bkz.

CWnd Sınıfı
Hiyerarşi Grafiği

Aracılığıyla paylaş

CReBarCtrl Sınıfı

Sözdizimi

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Açıklamalar

Çubuk denetimi

Devralma Hiyerarşisi

Gereksinimler

CReBarCtrl::BeginDrag

Parametreler

CReBarCtrl::Create

Parametreler

Dönüş Değeri

Açıklamalar

Örnek

CReBarCtrl::CreateEx

Parametreler

Dönüş Değeri

Açıklamalar

CReBarCtrl::CReBarCtrl

Örnek

CReBarCtrl::D eleteBand

Parametreler

Dönüş Değeri

Örnek

CReBarCtrl::D ragMove

Parametreler

CReBarCtrl::EndDrag

CReBarCtrl::GetBandBorders

Parametreler

CReBarCtrl::GetBandCount

Dönüş Değeri

CReBarCtrl::GetBandInfo

Parametreler

Dönüş Değeri

CReBarCtrl::GetBandMargins

Parametreler

Açıklamalar

CReBarCtrl::GetBarHeight

Dönüş Değeri

CReBarCtrl::GetBarInfo

Parametreler

Dönüş Değeri

CReBarCtrl::GetBkColor

Dönüş Değeri

CReBarCtrl::GetColorScheme

Parametreler

Dönüş Değeri

Açıklamalar

CReBarCtrl::GetDropTarget

Dönüş Değeri

CReBarCtrl::GetExtendedStyle

Dönüş Değeri

Açıklamalar

CReBarCtrl::GetImageList

Dönüş Değeri

Açıklamalar

CReBarCtrl::GetPalette

Dönüş Değeri

Açıklamalar

Örnek

CReBarCtrl::GetRect

Parametreler

Dönüş Değeri

Örnek

CReBarCtrl::GetRowCount

Dönüş Değeri

Örnek

CReBarCtrl::GetRowHeight

Parametreler

Dönüş Değeri

Örnek

CReBarCtrl::GetTextColor

Dönüş Değeri

CReBarCtrl::GetToolTips

Dönüş Değeri

Açıklamalar

CReBarCtrl::HitTest