Aracılığıyla paylaş


CMFCToolBar Sınıfı

sınıfı Sınıf'a CMFCToolBarCToolBarbenzer, ancak kullanıcı arabirimi özellikleri için ek destek sağlar. Bunlar düz araç çubukları, etkin görüntüler içeren araç çubukları, büyük simgeler, çağrı düğmeleri, kilitli araç çubukları, rebar denetimleri, resimlerin altındaki metinler, arka plan resimleri ve sekmeli araç çubuklarıdır. Sınıfı CMFCToolBar ayrıca araç çubukları ve menülerin kullanıcı özelleştirmesi, araç çubukları ve menüler arasında sürükleyip bırakma, birleşik giriş kutusu düğmeleri, düzenleme kutusu düğmeleri, renk seçiciler ve toplama düğmeleri için yerleşik destek içerir.

Daha fazla ayrıntı için bkz. Visual Studio yüklemenizde bulunan kaynak kodu, örneğin, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Sözdizimi

class CMFCToolBar : public CMFCBaseToolBar

Üyeler

Ortak Oluşturucular

Ad Tanım
CMFCToolBar::CMFCToolBar Varsayılan oluşturucu.
CMFCToolBar::~CMFCToolBar Yıkıcı.

Genel Yöntemler

Ad Tanım
CMFCToolBar::AddBasicCommand Kullanıcı bir menüyü açtığında her zaman görüntülenen komut listesine bir menü komutu ekler.
CMFCToolBar::AddCommandUsage Verilen komutla ilişkili sayacı bir artırır.
CMFCToolBar::AddToolBarForImageCollection Uygulamadaki görüntü koleksiyonuna kullanıcı arabirimi kaynaklarından görüntüler ekler.
CMFCToolBar::AdjustLayout Araç çubuğunun boyutunu ve konumunu yeniden hesaplar. (Geçersiz Kılmalar CBasePane::AdjustLayout).
CMFCToolBar::AdjustSize Araç çubuğunun boyutunu yeniden hesaplar.
CMFCToolBar::AllowChangeTextLabels Araç çubuğu düğmelerindeki resimlerin altında metin etiketlerinin gösterilip gösterilmeyebileceğini belirtir.
CMFCToolBar::AreTextLabels Resimlerin altındaki metin etiketlerinin şu anda araç çubuğu düğmelerinde görüntülenip görüntülenmeyeceğini belirtir.
CMFCToolBar::AutoGrayInactiveImages Etkin olmayan düğme görüntülerinin otomatik olarak oluşturulmasını etkinleştirir veya devre dışı bırakır.
CMFCToolBar::ButtonToIndex Bu araç çubuğunda belirtilen CMFCToolBarButton Sınıf nesnesinin dizinini döndürür.
CMFCToolBar::CalcFixedLayout Araç çubuğunun yatay boyutunu hesaplar. (Geçersiz Kılmalar CBasePane::CalcFixedLayout.)
CMFCToolBar::CalcSize Düzen hesaplama işleminin bir parçası olarak çerçeve tarafından çağrılır. (Geçersiz Kılmalar CPane::CalcSize.)
CMFCToolBar::CanHandleSiblings Araç çubuğunun ve eşdüzey öğesinin aynı bölmede konumlandırılıp konumlandırılmayacağını belirler.
CMFCToolBar::CleanUpImages Araç çubuğu görüntüleri için ayrılan sistem kaynaklarını serbestleştirir.
CMFCToolBar::CleanUpLockedImages Kilitli araç çubuğu görüntüleri için ayrılan sistem kaynaklarını serbestleştirir.
CMFCToolBar::CanBeClosed Bir kullanıcının araç çubuğunu kapatıp kapatamayacağını belirtir. (Geçersiz Kılmalar CBasePane::CanBeClosed.)
CMFCToolBar::CanBeRestored Özelleştirmeden sonra sistemin bir araç çubuğunu özgün durumuna geri yükleyip yükleyemeyeceğini belirler.
CMFCToolBar::CanFocus Bölmenin odağı alıp alamayacağını belirtir. (Geçersiz Kılmalar CBasePane::CanFocus.)
CMFCToolBar::CanHandleSiblings Araç çubuğunun ve eşdüzey öğesinin aynı bölmede konumlandırılıp konumlandırılmayacağını belirler.
CMFCToolBar::CommandToIndex Belirtilen komut kimliğine sahip araç çubuğundaki düğmenin dizinini döndürür.
CMFCToolBar::Create Bir CMFCToolBar nesnesi oluşturur.
CMFCToolBar::CreateEx Büyük simgeler gibi ek stil seçeneklerini kullanan bir CMFCToolBar nesne oluşturur.
CMFCToolBar::Deactivate Araç çubuğunu devre dışı bırakır.
CMFCToolBar::EnableCustomizeButton Araç çubuğunun sonunda görünen Düğme Ekle veya Kaldır düğmesini etkinleştirir veya devre dışı bırakır.
CMFCToolBar::EnableDocking Bölmenin ana çerçeveye yerleştirilmesine olanak tanır. (Geçersiz Kılmalar CBasePane::EnableDocking.)
CMFCToolBar::EnableLargeIcons Araç çubuğu düğmelerinde büyük simgeleri etkinleştirir veya devre dışı bırakır.
CMFCToolBar::EnableQuickCustomization Kullanıcının Alt tuşuna basıp düğmeyi yeni bir konuma sürükleyebilmesi için araç çubuklarının hızlı özelleştirmesini etkinleştirir veya devre dışı bırakır.
CMFCToolBar::EnableReflections Komut yansımasını etkinleştirir veya devre dışı bırakır.
CMFCToolBar::EnableTextLabels Araç çubuğu düğmesi resimleri altındaki metin etiketlerini etkinleştirir veya devre dışı bırakır.
CMFCToolBar::FromHandlePermanent Verilen pencere tutamacını CMFCToolBar içeren nesnenin işaretçisini alır.
CMFCToolBar::GetAllButtons Araç çubuğundaki düğmelerin salt okunur listesini döndürür.
CMFCToolBar::GetAllToolbars Uygulamadaki tüm araç çubuklarının salt okunur listesini döndürür.
CMFCToolBar::GetBasicCommands Uygulamada tanımlanan temel komutların salt okunur bir listesini döndürür.
CMFCToolBar::GetButton Belirtilen araç çubuğu düğme dizinine sahip nesneye CMFCToolBarButton bir işaretçi döndürür.
CMFCToolBar::GetButtonInfo Belirtilen dizindeki düğmenin komut kimliğini, stilini ve görüntü dizinini döndürür.
CMFCToolBar::GetButtonSize Araç çubuğundaki her düğmenin boyutlarını döndürür.
CMFCToolBar::GetButtonStyle Belirtilen dizinde bulunan araç çubuğu düğmesinin geçerli stilini döndürür.
CMFCToolBar::GetButtonText Belirtilen dizine sahip bir düğmenin metin etiketini döndürür.
CMFCToolBar::GetColdImages Uygulamadaki soğuk araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi döndürür.
CMFCToolBar::GetColumnWidth Araç çubuğu düğmelerinin genişliğini döndürür.
CMFCToolBar::GetCommandButtons Uygulamadaki tüm araç çubuklarından belirtilen komut kimliğine sahip düğmelerin listesini döndürür.
CMFCToolBar::GetCount Araç çubuğundaki düğmelerin ve ayırıcıların sayısını döndürür.
CMFCToolBar::GetCustomizeButton Araç çubuğuyla ilişkili nesnenin CMFCCustomizeButton işaretçisini alır.
CMFCToolBar::GetDefaultImage Belirtilen komut kimliğine sahip bir araç çubuğu düğmesi için varsayılan görüntünün dizinini döndürür.
CMFCToolBar::GetDisabledImages Uygulamadaki devre dışı bırakılmış araç çubuğu düğmeleri için kullanılan görüntü koleksiyonuna yönelik bir işaretçi döndürür.
CMFCToolBar::GetDisabledMenuImages Uygulamadaki devre dışı menü düğmeleri için kullanılan görüntü koleksiyonuna yönelik bir işaretçi döndürür.
CMFCToolBar::GetDroppedDownMenu Şu anda alt menüsünü görüntüleyen menü düğmesi nesnesinin işaretçisini alır.
CMFCToolBar::GetGrayDisabledButtons Devre dışı bırakılan düğmelerin görüntülerinin normal düğme görüntülerinin soluk sürümleri mi yoksa devre dışı bırakılan düğme görüntüleri koleksiyonundan mı alındığını belirtir.
CMFCToolBar::GetHighlightedButton Şu anda vurgulanmış araç çubuğu düğmesinin işaretçisini döndürür.
CMFCToolBar::GetHotBorder Araç çubuğu düğmelerinin etkin izlenip izlenmediğini belirler.
CMFCToolBar::GetHotTextColor Vurgulanan araç çubuğu düğmelerinin metin rengini döndürür.
CMFCToolBar::GetHwndLastFocus Araç çubuğundan hemen önce giriş odağına sahip olan pencere tutamacını döndürür.
CMFCToolBar::GetIgnoreSetText Düğme etiketlerini ayarlama çağrılarının yoksayılıp yoksayılmayacağını belirtir.
CMFCToolBar::GetImageSize Araç çubuğu düğme görüntülerinin geçerli boyutunu döndürür.
CMFCToolBar::GetImages Uygulamadaki varsayılan düğme görüntüleri koleksiyonuna bir işaretçi döndürür.
CMFCToolBar::GetImagesOffset Bu araç çubuğunun araç çubuğu düğme görüntülerinin genel listesinde araç çubuğu düğme görüntülerini bulmak için kullanılan dizin uzaklığını döndürür.
CMFCToolBar::GetInvalidateItemRect verilen dizindeki düğme için yeniden çizilmesi gereken istemci alanının bölgesini alır.
CMFCToolBar::GetItemID Belirtilen dizinde araç çubuğu düğmesinin komut kimliğini döndürür.
CMFCToolBar::GetItemRect Belirtilen dizindeki düğmenin sınırlayıcı dikdörtgenini döndürür.
CMFCToolBar::GetLargeColdImages Uygulamadaki büyük soğuk araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi döndürür.
CMFCToolBar::GetLargeDisabledImages Uygulamadaki devre dışı bırakılmış büyük araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi döndürür.
CMFCToolBar::GetLargeImages Uygulamadaki büyük araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi döndürür.
CMFCToolBar::GetLockedColdImages Araç çubuğundaki kilitli soğuk görüntülerin koleksiyonuna bir işaretçi döndürür.
CMFCToolBar::GetLockedDisabledImages Araç çubuğundaki kilitli devre dışı görüntülerin koleksiyonuna bir işaretçi döndürür.
CMFCToolBar::GetLockedImages Araç çubuğundaki kilitli düğme görüntüleri koleksiyonuna bir işaretçi döndürür.
CMFCToolBar::GetLockedImageSize Kilitli araç çubuğu görüntülerinin varsayılan boyutunu döndürür.
CMFCToolBar::GetLockedMenuImages Araç çubuğundaki kilitli araç çubuğu menü görüntüleri koleksiyonuna bir işaretçi döndürür.
CMFCToolBar::GetMenuButtonSize Uygulamadaki menü düğmelerinin boyutunu döndürür.
CMFCToolBar::GetMenuImageSize Uygulamadaki menü düğmesi görüntülerinin boyutunu döndürür.
CMFCToolBar::GetMenuImages Uygulamadaki menü düğmesi görüntüleri koleksiyonuna bir işaretçi döndürür.
CMFCToolBar::GetOrigButtons Araç çubuğunun özelleştirilmemiş düğmeleri koleksiyonunu alır.
CMFCToolBar::GetOrigResetButtons Araç çubuğunun özelleştirilmemiş sıfırlama düğmeleri koleksiyonunu alır.
CMFCToolBar::GetResourceID Araç çubuğunun kaynak kimliğini alır.
CMFCToolBar::GetRouteCommandsViaFrame Üst çerçeve veya sahip olan hangi nesnenin araç çubuğuna komut gönderdiğini belirler.
CMFCToolBar::GetRowHeight Araç çubuğu düğmelerinin yüksekliğini döndürür.
CMFCToolBar::GetShowTooltips Araç çubuğu düğmeleri için araç ipuçlarının görüntülenip görüntülenmeyeceğini belirtir.
CMFCToolBar::GetSiblingToolBar Araç çubuğunun eşdüzeyini alır.
CMFCToolBar::GetUserImages Uygulamadaki kullanıcı tanımlı araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi döndürür.
CMFCToolBar::HitTest Belirtilen konumda bulunan araç çubuğu düğmesinin dizinini döndürür.
CMFCToolBar::InsertButton Araç çubuğuna bir düğme ekler.
CMFCToolBar::InsertSeparator Araç çubuğuna bir ayırıcı ekler.
CMFCToolBar::InvalidateButton Sağlanan dizinde bulunan araç çubuğu düğmesinin istemci alanını geçersiz kılma.
CMFCToolBar::IsAddRemoveQuickCustomize Özelleştir menü seçeneğini kullanarak bir kullanıcının araç çubuğu düğmeleri ekleyip ekleyemeyeceğini veya kaldırabileceğini belirler.
CMFCToolBar::IsAltCustomizeMode Bir düğmeyi sürüklemek için hızlı özelleştirmenin kullanılıp kullanılmadığını belirtir.
CMFCToolBar::IsAutoGrayInactiveImages Etkin olmayan (vurgulanmamış) düğme görüntülerinin otomatik olarak oluşturulup etkinleştirilmediğini belirtir.
CMFCToolBar::IsBasicCommand Bir komutun temel komutlar listesinde olup olmadığını belirler.
CMFCToolBar::IsButtonExtraSizeAvailable Araç çubuğunun genişletilmiş kenarlıklara sahip düğmeleri görüntüleyip görüntüleyemeyeceğini belirler.
CMFCToolBar::IsButtonHighlighted Araç çubuğundaki bir düğmenin vurgulanıp vurgulu olmadığını belirler.
CMFCToolBar::IsCommandPermitted Bir komuta izin verilip verilmeyeceğini belirler.
CMFCToolBar::IsCommandRarelyUsed Bir komutun nadiren kullanılıp kullanılmadığını belirler (bkz CMFCToolBar::SetCommandUsageOptions. ).
CMFCToolBar::IsCustomizeMode Araç çubuğu çerçevesinin özelleştirme modunda olup olmadığını belirtir.
CMFCToolBar::IsDragButton Bir araç çubuğu düğmesinin sürüklenip sürüklenmediğini belirler.
CMFCToolBar::IsExistCustomizeButton Araç çubuğunun Özelleştir düğmesini içerip içermediğini belirler.
CMFCToolBar::IsFloating Araç çubuğunun kayan olup olmadığını belirler.
CMFCToolBar::IsLargeIcons Uygulamadaki araç çubuklarının şu anda büyük simgeler görüntüleyip görüntülemeyeceğini belirtir.
CMFCToolBar::IsLastCommandFromButton En son yürütülen komutun belirtilen araç çubuğu düğmesinden gönderilip gönderilmediğini belirler.
CMFCToolBar::IsLocked Araç çubuğunun kilitli olup olmadığını belirler.
CMFCToolBar::IsOneRowWithSibling Araç çubuğunun ve eşdüzey araç çubuğunun aynı satırda konumlandırılıp konumlandırılmayacağını belirler.
CMFCToolBar::IsUserDefined Araç çubuğunun kullanıcı tanımlı olup olmadığını belirtir.
CMFCToolBar::LoadBitmap Uygulama kaynaklarından araç çubuğu görüntülerini yükler.
CMFCToolBar::LoadBitmapEx Uygulama kaynaklarından araç çubuğu görüntülerini yükler. Büyük görüntüler içerir.
CMFCToolBar::LoadParameters Windows kayıt defterinden genel araç çubuğu seçeneklerini yükler.
CMFCToolBar::LoadState Windows kayıt defterinden araç çubuğu durum bilgilerini yükler. (Geçersiz Kılmalar CPane::LoadState.)
CMFCToolBar::LoadToolBar Araç çubuğunu uygulama kaynaklarından yükler.
CMFCToolBar::LoadToolBarEx Uygulamanın büyük görüntüler kullanmasını sağlamak için yardımcı sınıfını CMFCToolBarInfo kullanarak uygulama kaynaklarından araç çubuğunu yükler.
CMFCToolBar::OnChangeHot Kullanıcı araç çubuğunda bir düğme seçtiğinde çerçeve tarafından çağrılır.
CMFCToolBar::OnFillBackground Araç çubuğunun arka planını doldurmak için framework CBasePane::DoPaint tarafından çağrılır.
CMFCToolBar::OnReset Araç çubuğunu özgün durumuna geri yükler.
CMFCToolBar::OnSetAccData (Geçersiz Kılmalar CBasePane::OnSetAccData.)
CMFCToolBar::OnSetDefaultButtonText Araç çubuğu düğmesinin metnini varsayılan durumuna geri yükler.
CMFCToolBar::OnUpdateCmdUI Dahili olarak kullanılır.
CMFCToolBar::RemoveAllButtons Araç çubuğundaki tüm düğmeleri kaldırır.
CMFCToolBar::RemoveButton Belirtilen dizine sahip düğmeyi araç çubuğundan kaldırır.
CMFCToolBar::RemoveStateFromRegistry Araç çubuğunun durum bilgilerini Windows kayıt defterinden siler.
CMFCToolBar::ReplaceButton Araç çubuğu düğmesini başka bir araç çubuğu düğmesiyle değiştirir.
CMFCToolBar::ResetAll Tüm araç çubuklarını özgün durumlarına geri yükler.
CMFCToolBar::ResetAllImages Uygulamadaki tüm araç çubuğu görüntü koleksiyonlarını temizler.
CMFCToolBar::RestoreOriginalState Bir araç çubuğunun özgün durumunu geri yükler.
CMFCToolBar::SaveState Araç çubuğunun durum bilgilerini Windows kayıt defterine kaydeder. (Geçersiz Kılmalar CPane::SaveState.)
CMFCToolBar::Serialize (Geçersiz Kılmalar CBasePane::Serialize.)
CMFCToolBar::SetBasicCommands Kullanıcı bir menüyü açtığında her zaman görüntülenen komutların listesini ayarlar.
CMFCToolBar::SetButtonInfo Araç çubuğu düğmesinin komut kimliğini, stilini ve görüntü kimliğini ayarlar.
CMFCToolBar::SetButtonStyle Belirtilen dizindeki araç çubuğu düğmesinin stilini ayarlar.
CMFCToolBar::SetButtonText Araç çubuğu düğmesinin metin etiketini ayarlar.
CMFCToolBar::SetButtons Araç çubuğunun düğmelerini ayarlar.
CMFCToolBar::SetCommandUsageOptions Nadiren kullanılan komutların uygulama menüsünde görünmediğini belirtir.
CMFCToolBar::SetCustomizeMode Uygulamadaki tüm araç çubukları için özelleştirme modunu etkinleştirir veya devre dışı bırakır.
CMFCToolBar::SetGrayDisabledButtons Araç çubuğundaki devre dışı bırakılan düğmelerin soluk mu yoksa devre dışı bırakılan düğmeler için devre dışı bırakılmış görüntülerin mi kullanılacağını belirtir.
CMFCToolBar::SetHeight Araç çubuğunun yüksekliğini ayarlar.
CMFCToolBar::SetHotBorder Araç çubuğu düğmelerinin etkin izlenip izlenmeyeceğini belirtir.
CMFCToolBar::SetHotTextColor Kısayol araç çubuğu düğmeleri için metin rengini ayarlar.
CMFCToolBar::SetLargeIcons Araç çubuğu düğmelerinin büyük simgeler görüntüleyip görüntülemeyeceğini belirtir.
CMFCToolBar::SetLockedSizes Araç çubuğundaki kilitli düğmelerin ve kilitli görüntülerin boyutlarını ayarlar.
CMFCToolBar::SetMenuSizes Araç çubuğu menü düğmelerinin ve görüntülerinin boyutunu ayarlar.
CMFCToolBar::SetNonPermittedCommands Kullanıcı tarafından yürütülemeyen komutların listesini ayarlar.
CMFCToolBar::SetOneRowWithSibling Araç çubuğunu ve eşdüzeyini aynı satıra konumlandırın.
CMFCToolBar::SetPermament Bir kullanıcının araç çubuğunu kapatıp kapatamayacağını belirtir.
CMFCToolBar::SetRouteCommandsViaFrame Üst çerçevenin veya sahibin araç çubuğuna komut gönderip göndermediğini belirtir.
CMFCToolBar::SetShowTooltips Çerçevenin araç ipuçlarını görüntüleyip görüntülemeyeceğini belirtir.
CMFCToolBar::SetSiblingToolBar Araç çubuğunun eşdüzeyini belirtir.
CMFCToolBar::SetSizes Tüm araç çubuklarındaki düğmelerin ve görüntülerin boyutlarını belirtir.
CMFCToolBar::SetToolBarBtnText Araç çubuğundaki bir düğmenin özelliklerini belirtir.
CMFCToolBar::SetTwoRowsWithSibling Araç çubuğunu ve eşdüzeyini ayrı satırlara yerleştirir.
CMFCToolBar::SetUserImages Uygulamadaki kullanıcı tanımlı görüntülerin koleksiyonunu ayarlar.
CMFCToolBar::StretchPane Araç çubuğunu dikey veya yatay olarak uzatır. (Geçersiz Kılmalar CBasePane::StretchPane.)
CMFCToolBar::TranslateChar Belirtilen tuş kodu geçerli bir klavye kısayoluna karşılık geliyorsa bir düğme komutu yürütür.
CMFCToolBar::UpdateButton Belirtilen düğmenin durumunu Güncelleştirmeler.
CMFCToolBar::WrapToolBar Araç çubuğu düğmelerini verilen boyutlar içinde yeniden konumlandırır.

Korumalı Yöntemler

Ad Tanım
CMFCToolBar::AllowShowOnList Araç çubuğunun Özelleştir iletişim kutusunun Araç Çubukları bölmesindeki listede görüntülenip görüntülenmeyeceğini belirler.
CMFCToolBar::CalcMaxButtonHeight Araç çubuğundaki bir düğmenin en yüksek yüksekliğini hesaplar.
CMFCToolBar::DoPaint Araç çubuğunu yeniden boyar.
CMFCToolBar::DrawButton Araç çubuğu düğmesini yeniden boyar.
CMFCToolBar::DrawSeparator Araç çubuğundaki ayırıcıyı yeniden boyar.
CMFCToolBar::OnUserToolTip Bir düğmenin araç ipucu görüntülenmek üzereyken çerçeve tarafından çağrılır.

Veri Üyeleri

Ad Tanım
CMFCToolBar::m_bDontScaleImages Yüksek DPI modunda araç çubuğu görüntülerinin ölçeklendirilip ölçeklendirilmeyeceğini belirtir.
CMFCToolBar::m_dblLargeImageRatio Büyük resimlerin boyutu (yükseklik veya genişlik) ile normal görüntülerin boyutu arasındaki oranı belirtir.

Açıklamalar

Bir nesneyi uygulamanıza eklemek CMFCToolBar için şu adımları izleyin:

  1. Ana çerçeve penceresine bir CMFCToolBar nesne ekleyin.

  2. Ana çerçeve penceresi için WM_CREATE iletisini işlerken, araç çubuğunu oluşturmak ve stilini belirtmek için veya CMFCToolBar::CreateEx öğesini çağırınCMFCToolBar::Create.

  3. Yerleştirme stilini belirtmek için çağırın CBasePane::EnableDocking .

Birleşik giriş kutusu veya açılan araç çubuğu gibi özel bir düğme eklemek için, üst kaynakta bir sahte düğme ayırın ve kullanarak CMFCToolBar::ReplaceButtonçalışma zamanında sahte düğmeyi değiştirin. Daha fazla bilgi için bkz . İzlenecek yol: Denetimleri Araç Çubuklarına Yerleştirme.

CMFCToolBarSınıf, CMFCPopupMenuBar Sınıf ve CMFCDropDownToolBar Sınıf MFC Kitaplık sınıfları CMFCMenuBar için temel sınıftır.

Örnek

Aşağıdaki örnekte, sınıftaki çeşitli yöntemlerin nasıl kullanılacağı gösterilmektedir CMFCToolBar . Örnek araç çubuğunun pencere etiketinin metnini ayarlamayı, kenarlıkları ayarlamayı, bölmenin stilini ayarlamayı ve araç çubuğunun sonunda görüntülenen Düğme Ekle veya Kaldır düğmesini etkinleştirmeyi gösterir. Bu kod parçacığı, IE Tanıtım örneğinin bir parçasıdır.

CMFCToolBar m_wndToolBar;
m_wndToolBar.SetWindowText(_T("Standard"));
m_wndToolBar.SetBorders();

//------------------------------------
// Remove toolbar gripper and borders:
//------------------------------------
m_wndToolBar.SetPaneStyle(m_wndToolBar.GetPaneStyle() &
                          ~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));

m_wndToolBar.EnableCustomizeButton(TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));

Gereksinimler

Üstbilgi:afxtoolbar.h

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCToolBar::AddBasicCommand

Kullanıcı bir menüyü açtığında her zaman görüntülenen komut listesine bir menü komutu ekler.

static void __stdcall AddBasicCommand(UINT uiCmd);

Parametreler

uiCmd
[in] Eklenecek komutu belirtir.

Açıklamalar

Menü açıldığında her zaman temel bir komut görüntülenir. Kullanıcı son kullanılan komutları görüntülemeyi seçtiğinde bu yöntem anlamlıdır.

CMFCToolBar::SetBasicCommands Kullanıcı bir menüyü açtığında her zaman görüntülenen komutların listesini ayarlamak için yöntemini kullanın. CMFCToolBar::GetBasicCommands Uygulamanız tarafından kullanılan temel komutların listesini almak için yöntemini kullanın.

CMFCToolBar::AddCommandUsage

Verilen komutla ilişkili sayacı bir artırır.

static void __stdcall AddCommandUsage(UINT uiCommand);

Parametreler

uiCommand
[in] Artıracak komut sayacını belirtir.

Açıklamalar

Kullanıcı bir menü öğesi seçtiğinde çerçeve bu yöntemi çağırır.

Çerçeve, son kullanılan menü öğelerini görüntülemek için komut sayaçlarını kullanır.

Bu yöntem, yöntemini kullanarak komut sayacını CMFCCmdUsageCount::AddCmd artırır.

CMFCToolBar::AddToolBarForImageCollection

Uygulamadaki görüntü koleksiyonuna kullanıcı arabirimi kaynaklarından görüntüler ekler.

static BOOL __stdcall AddToolBarForImageCollection(
    UINT uiResID,
    UINT uiBmpResID=0,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parametreler

uiResID
[in] Yüklenecek görüntüleri içeren bir araç çubuğunun kaynak kimliği.

uiBmpResID
[in] Araç çubuğu görüntüleriyle bit eşlem kaynak kimliği.

uiColdResID
[in] "Soğuk" araç çubuğu görüntüleriyle bit eşlem kaynak kimliği.

uiMenuResID
[in] Menü görüntüleri içeren bit eşlem kaynak kimliği.

uiDisabledResID
[in] Devre dışı bırakılmış araç çubuğu görüntüleriyle bit eşlem kaynak kimliği.

uiMenuDisabledResID
[in] Devre dışı menü görüntüleriyle bit eşlem kaynak kimliği.

İade Değeri

TRUE yöntem başarılı olursa; FALSE geçerli kaynaklar belirtmezse uiResID veya uiBmpResID belirtmezseniz veya başka bir hata oluşur.

Açıklamalar

Araç çubuğu görüntüleriyle bit eşlem yüklemek ve araç çubuğu görüntüleri koleksiyonuna eklemek için bu yöntemi çağırın. Bu yöntem geçici bir araç çubuğu nesnesi oluşturur ve öğesini çağırır CMFCToolBar::LoadToolBar.

CMFCToolBar::AdjustLayout

Araç çubuğunun boyutunu ve konumunu yeniden hesaplar.

virtual void AdjustLayout();

Açıklamalar

Araç çubuğu boyutunu ve konumunu yeniden hesaplamak için oluşturulduğunda bu yöntemi çağırın.

Çerçeve, araç çubuğunun düzeninin değiştirilmesi gerektiğinde bu yöntemi çağırır. Örneğin, kullanıcı başka bir denetim çubuğunu taşırken, bir uygulama penceresini yeniden boyutlandırdığında veya araç çubuğunu özelleştirdiğinde düzenin değişmesi gerekir.

'den CMFCToolbartüretdiğiniz sınıflarda kendi dinamik düzeninizi sağlamak için bu yöntemi geçersiz kılın.

CMFCToolBar::AdjustSize

Araç çubuğunun boyutunu yeniden hesaplar.

void AdjustSize();

Açıklamalar

Bu yöntem, araç çubuğunun üst çerçevenin sınırlarına sığmasını sağlar. Araç çubuğunun üst çerçevesi yoksa bu yöntem hiçbir şey yapmaz.

yöntemi, CMFCToolBar::AdjustLayout araç çubuğunun üst öğesi bir CMFCReBar nesne değilse boyutu yeniden hesaplamak için bu yöntemi çağırır.

CMFCToolBar::AllowChangeTextLabels

Araç çubuğu düğmelerindeki resimlerin altında metin etiketlerinin gösterilip gösterilmeyebileceğini belirtir.

virtual BOOL AllowChangeTextLabels() const;

İade Değeri

TRUE resimlerin altında metin etiketleri görüntülemesine izin veriliyorsa; aksi takdirde FALSE.

Açıklamalar

Bu yöntem, seçili araç çubuğunun Araç Çubukları sayfasında Metin etiketlerini göster onay kutusunun etkinleştirilip etkinleştirilmeyeceğini belirlemek için özelleştirme iletişim kutusu tarafından çağrılır.

Varsayılan uygulama döndürür TRUE.

Bu yöntemi, öğesinden CMFCToolBar türetilen bir nesnede geçersiz kılın ve kullanıcının resimlerin altındaki araç çubuğu düğmelerinde metin etiketlerinin görüntülenip görüntülenmeyeceğine karar vermesini istemediğinizde döndürebilirsiniz FALSE .

CMFCToolBar::AllowShowOnList

Araç çubuğunun Özelleştir iletişim kutusunun Araç Çubukları bölmesindeki araç çubukları listesinde görüntülenip görüntülenmeyeceğini belirler.

virtual BOOL AllowShowOnList() const;

İade Değeri

TRUE araç çubuğu nesnesi araç çubuğu özelleştirme sayfasındaki liste kutusunda görüntülenebiliyorsa; aksi takdirde FALSE.

Açıklamalar

Bu yöntem, araç çubuğu özelleştirme sayfasındaki listenin öğesinden CMFCToolBartüretilmiş belirli bir nesne içerip içermeyeceğini belirlemek için çerçeve tarafından çağrılır.

Varsayılan uygulama her zaman döndürür TRUE. Özelleştirme iletişim kutusundaki araç çubukları listesinde bir araç çubuğunun görünmesini istemiyorsanız bu yöntemi geçersiz kılın.

CMFCToolBar::AreTextLabels

Resimlerin altındaki metin etiketlerinin şu anda araç çubuğu düğmelerinde görüntülenip görüntülenmeyeceğini belirtir.

BOOL AreTextLabels() const;

İade Değeri

TRUE araç çubuğu düğmeleri resimlerin altında metin etiketleri görüntülüyorsa; aksi takdirde FALSE.

Açıklamalar

Metnin görüntülenip görüntülenmeyeceğini belirtmek için kullanın CMFCToolBar::EnableTextLabels . FALSE varsayılan değerdir. Kullanıcının özelleştirme iletişim kutusunda bu ayarı değiştirip değiştiremeyeceğini belirtmek için çağrısı CMFCToolBar::AllowChangeTextLabels yapın.

CMFCToolBar::AutoGrayInactiveImages

Etkin olmayan düğme görüntülerinin otomatik olarak oluşturulmasını etkinleştirir veya devre dışı bırakır.

static void AutoGrayInactiveImages(
    BOOL bEnable=TRUE,
    int nGrayImagePercentage=0,
    BOOL bRedrawAllToolbars=TRUE);

Parametreler

bEnable
[in] Etkin olmayan görüntülerin soluk olup olmayacağını belirten boole değeri. Bu parametre ise TRUE, etkin olmayan görüntüler soluk görüntülenir. Aksi takdirde, etkin olmayan görüntüler soluk olmaz.

nGrayImagePercentage
[in] Etkin olmayan görüntüler için parlaklık yüzdesini belirtir. ise bEnableFALSE, bu değer yoksayılır.

bRedrawAllToolbars
[in] Uygulamadaki tüm araç çubuklarının yeniden çizilip çizmeyeceğini belirten boole değeri. Bu parametre ise TRUE, bu yöntem tüm araç çubuklarını yeniden çizer.

Açıklamalar

ise bEnableTRUE, çerçeve normal görüntülerden etkin olmayan görüntüler oluşturmak için kullanır nGrayImagePercentage . Aksi takdirde, yöntemini kullanarak CMFCToolBar::GetColdImages etkin olmayan görüntüler kümesini sağlamanız gerekir. Varsayılan olarak, bu seçenek devre dışıdır.

parametresi hakkında nGrayImagePercentage daha fazla bilgi için bkz CMFCToolBarImages::GrayImages. .

CMFCToolBar::ButtonToIndex

Bu araç çubuğunda belirtilen CMFCToolBarButton Sınıf nesnesinin dizinini döndürür.

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

Parametreler

pButton
[in] Araç çubuğu düğme nesnesinin işaretçisi.

İade Değeri

pButton İç araç çubuğu düğmeleri listesinde dizini; belirtilen düğme bu araç çubuğunda değilse -1.

CMFCToolBar::CalcFixedLayout

Araç çubuğunun yatay boyutunu hesaplar.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametreler

bStretch
[in] TRUE araç çubuğunu üst çerçevenin boyutuna kadar uzatmak için.

bHorz
[in] TRUE araç çubuğunu yatay olarak yönlendirmek için; FALSE araç çubuğunu dikey olarak yönlendirmek için.

İade Değeri

CSize Araç çubuğunun boyutunu belirten nesne.

Açıklamalar

Bu yöntem, yöntemini kullanarak araç çubuğunun CMFCToolBar::CalcLayout boyutunu hesaplar. ise TRUEbStretch parametresinin bayrağını dwMode geçirirLM_STRETCH. ise bHorzTRUEbayrağını LM_HORZ geçirir.

Bu yöntemi kullanan bir örnek için VisualStudioDemo örneğine bakın.

CMFCToolBar::CalcMaxButtonHeight

Araç çubuğundaki düğmelerin en yüksek yüksekliğini hesaplar.

virtual int CalcMaxButtonHeight();

İade Değeri

Düğmelerin en yüksek yüksekliği.

Açıklamalar

Bu yöntem, araç çubuğundaki tüm araç çubuğu düğmeleri arasında en yüksek yüksekliği hesaplar. Yükseklik, geçerli araç çubuğu yerleştirme durumu gibi faktörlere bağlı olarak değişebilir.

Kendi yükseklik hesaplamanızı sağlamak için öğesinden CMFCToolBar türetilen bir sınıfta bu yöntemi geçersiz kılın.

CMFCToolBar::CalcSize

Düzen hesaplama işleminin bir parçası olarak çerçeve tarafından çağrılır.

virtual CSize CalcSize(BOOL bVertDock);

Parametreler

bVertDock
[in] TRUE araç çubuğunun dikey olarak yerleştirildiğini belirtmek için; FALSE araç çubuğunun yatay olarak sabitlendiğini belirtmek için.

İade Değeri

CSize Araç çubuğundaki düğmelerin genel boyutunu belirten nesne.

Açıklamalar

Bu yöntem, metin etiketinin alanı ve kenarlık boyutu gibi her düğmenin boyutunu etkileyen öznitelikleri dikkate alır.

Araç çubuğunda düğme yoksa, bu yöntem yöntemini kullanarak CMFCToolBar::GetButtonSize tek bir düğmenin ayrılmış boyutunu döndürür.

CMFCToolBar::CanBeClosed

Bir kullanıcının araç çubuğunu kapatıp kapatamayacağını belirtir.

virtual BOOL CanBeClosed() const;

İade Değeri

TRUE araç çubuğu kullanıcı tarafından kapatılabiliyorsa; aksi takdirde FALSE.

Açıklamalar

Çerçeve, kullanıcının araç çubuğunu kapatıp kapatamayacağını belirlemek için bu yöntemi çağırır. yöntemi döndürürse TRUE, çerçeve araç çubuğunun sistem menüsünde komutu etkinleştirir SC_CLOSE ve kullanıcı özelleştirme iletişim kutusundaki araç çubukları listesindeki bir onay kutusunu kullanarak araç çubuğunu kapatabilir.

Varsayılan uygulama döndürür TRUE. Kullanıcı tarafından kapatılamayan araç çubuğu nesneleri yapmak için öğesinden CMFCToolBar türetilen bir sınıfta bu yöntemi geçersiz kılın.

CMFCToolBar::CanBeRestored

Özelleştirmeden sonra sistemin bir araç çubuğunu özgün durumuna geri yükleyip yükleyemeyeceğini belirler.

virtual BOOL CanBeRestored() const;

İade Değeri

TRUE araç çubuğu uygulama kaynaklarından geri yüklenebiliyorsa; aksi takdirde FALSE.

Açıklamalar

Çerçeve, özelleştirmeden sonra bir araç çubuğunun özgün durumuna döndürülip döndürülemeyeceğini belirlemek için bu yöntemi çağırır. Özgün durum uygulama kaynaklarından yüklenir.

döndürürse CanBeRestoredTRUE, özelleştirme iletişim kutusunun Araç Çubukları sayfası seçili araç çubuğu için Sıfırla düğmesini etkinleştirir.

Araç çubuğunun yüklendiğinde özgün kaynak kimliği sıfır değilse varsayılan uygulama döndürür TRUE . Genellikle, yalnızca kullanıcı tanımlı araç çubukları geri yüklenemez.

Türetilmiş sınıflarda bu davranışı özelleştirmek için yöntemini geçersiz kılabilirsiniz CanBeRestored .

CMFCToolBar::CanFocus

Bölmenin odağı alıp alamayacağını belirtir.

virtual BOOL CanFocus() const;

İade Değeri

Bu yöntem döndürür FALSE.

Açıklamalar

Araç çubuğu nesneleri odağı alamadığından, CBasePane::CanFocusbu yöntem temel sınıf uygulamasını geçersiz kılar.

CMFCToolBar::CanHandleSiblings

Araç çubuğunun ve eşdüzey öğesinin aynı bölmede konumlandırılıp konumlandırılmayacağını belirler.

BOOL CanHandleSiblings();

İade Değeri

TRUE araç çubuğunda eşdüzey varsa ve araç çubuğu ile eşdüzey öğe aynı bölmede konumlandırıldıysa; aksi takdirde FALSE.

Açıklamalar

İç CMFCCustomizeButton::CreatePopupMenu yöntem, Özelleştir açılır menüsünün nasıl gösterileceğini belirlemek için bu yöntemi çağırır. Bu yöntem döndürürseTRUE, çerçevede Düğmeleri Bir Satırda Göster veya İki Satırda Düğmeleri Göster düğmeleri görüntülenir.

Genellikle bu yöntemi kullanmanız gerekmez. Araç çubuğunda görüntülenen Özelleştir düğmesini etkinleştirmek için yöntemini çağırınCMFCToolBar::EnableCustomizeButton. Düğmeleri Bir Satırda Göster veya İki Satırda Düğmeleri Göster düğmelerini etkinleştirmek için öğesini çağırınCMFCToolBar::SetSiblingToolBar.

CMFCToolBar::CleanUpImages

Araç çubuğu görüntüleri için ayrılan sistem kaynaklarını serbestleştirir.

static void CMFCToolBar::CleanUpImages();

Açıklamalar

Bir uygulama kapatıldığında çerçeve bu yöntemi çağırır.

CMFCToolBar::CleanUpLockedImages

Kilitli araç çubuğu görüntüleri için ayrılan sistem kaynaklarını serbestleştirir.

void CleanUpLockedImages();

Açıklamalar

Uygulamanızın görsel stili değiştiğinde bu yöntemi çağırın. Bu yöntemi kullanan bir örnek için VisualStudioDemo örneğine bakın.

CMFCToolBar::CommandToIndex

Belirtilen komut kimliğine sahip araç çubuğundaki düğmenin dizinini döndürür.

int CommandToIndex(
    UINT nIDFind,
    int iIndexFirst=0) const;

Parametreler

nIDFind
[in] Komut kimliğini belirtir.

iIndexFirst
[in] Başlangıç dizinini belirtir.

İade Değeri

Yöntem başarılı olursa araç çubuğu düğmesinin sıfır tabanlı dizini; Belirtilen kimlikte bir düğme yoksa -1.

Açıklamalar

Nesne CMFCToolBar , araç çubuğundaki düğmelerin iç listesini tutar. Düğmenin komut kimliği verilen listedeki bir düğmenin dizinini almak için bu işlevi çağırın.

0'dan büyükse iIndex , bu yöntem araç çubuğunda dizinin değerinden iIndexküçük olan tüm düğmeleri yoksayar.

CMFCToolBar::Create

Bir CMFCToolBar nesnesi oluşturur.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT nID=AFX_IDW_TOOLBAR);

Parametreler

pParentWnd
[in] Araç çubuğunun üst penceresinin işaretçisi.

dwStyle
[in] Araç çubuğu stili. Stil listesi için bkz . Windows SDK'sında Araç Çubuğu Denetimi ve Düğme Stilleri .

nID
[in] Araç çubuğunun alt penceresinin kimliği.

İade Değeri

TRUE bu yöntem başarılı olursa; aksi takdirde FALSE.

Açıklamalar

Bu yöntem bir denetim çubuğu oluşturur ve bunu araç çubuğuna ekler. denetim çubuğunu TBSTYLE_FLAT stiliyle oluşturur. Farklı bir denetim çubuğu stili istiyorsanız çağrısı CMFCToolBar::CreateEx yapın.

CMFCToolBar::CreateEx

Büyük simgeler gibi ek stil seçeneklerini kullanan bir CMFCToolBar nesne oluşturur.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=TBSTYLE_FLAT,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    CRect rcBorders=CRect(1,
    1,
    1,
    1),
    UINT nID=AFX_IDW_TOOLBAR);

Parametreler

pParentWnd
[in] Araç çubuğunun üst penceresinin işaretçisi.

dwCtrlStyle
[in] Ekli denetim çubuğu nesnesi oluşturmak için ek stiller.

dwStyle
[in] Araç çubuğu stili. Uygun stillerin listesi için bkz . Araç Çubuğu Denetimi ve Düğme Stilleri .

rcBorders
[in] CRect Araç çubuğu pencere kenarlıklarının genişliklerini belirten nesne.

nID
[in] Araç çubuğunun alt penceresinin kimliği.

İade Değeri

Bu yöntem başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bu yöntem bir denetim çubuğu oluşturur ve bunu araç çubuğuna ekler.

Belirli stilleri sağlamak yerine bu yöntemi CMFCToolBar::Create çağırın. Örneğin, Internet Explorer 4 tarafından kullanılan araç çubuklarına benzeyen bir araç çubuğu oluşturmak için olarak ayarlayındwCtrlStyle | TBSTYLE_FLATTBSTYLE_TRANSPARENT.

Örnek

Aşağıdaki örnekte sınıfının yönteminin CreateEx nasıl kullanılacağı gösterilmektedir CMFCToolBar . Bu kod parçacığı, IE Tanıtım örneğinin bir parçasıdır.

CMFCToolBar m_wndToolBar;
// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

CMFCToolBar::Deactivate

Araç çubuğunu devre dışı bırakır.

virtual void Deactivate();

Açıklamalar

Bu yöntem, vurgulanan araç çubuğu düğmesinden odağı kaldırarak araç çubuğunu devre dışı bırakır. Araç çubuğu odağı kaybettiğinde veya yok edildiğinde çerçeve bu yöntemi çağırır.

CMFCToolBar::DoPaint

Araç çubuğunu yeniden boyar.

virtual void DoPaint(CDC* pDC);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Açıklamalar

Bu yöntem, araç çubuğunun bir bölümünün yeniden boyanması gerektiğinde çerçeve tarafından çağrılır.

öğesinden CMFCToolBartüretilen bir nesnenin görünümünü özelleştirmek için bu yöntemi geçersiz kılın.

CMFCToolBar::DrawButton

Araç çubuğu düğmesini yeniden boyar.

virtual BOOL DrawButton(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CMFCToolBarImages* pImages,
    BOOL bHighlighted,
    BOOL bDrawDisabledImages);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

pButton
[in] Çizecek düğme işaretçisi.

pImages
[in] Araç çubuğu görüntülerinin işaretçisi.

bHighlighted
[in] TRUE düğme vurgulanmışsa; aksi takdirde FALSE.

bDrawDisabledImages
[in] TRUE devre dışı bırakılan düğmeler soluk görünüyorsa; aksi takdirde FALSE.

İade Değeri

TRUE düğme yeniden boyandıysa; FALSE düğmesini seçin.

Açıklamalar

Bir araç çubuğu düğmesinin CMFCToolBar::DrawButton yeniden boyanması gerektiğinde yöntemi bu yöntemi çağırır.

Araç çubuğunuzdaki düğmelerin görünümünü özelleştirmek istiyorsanız bu yöntemi geçersiz kılın.

CMFCToolBar::DrawSeparator

Araç çubuğundaki ayırıcıyı yeniden boyar.

virtual void DrawSeparator(
    CDC* pDC,
    const CRect& rect,
    BOOL bHorz);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

rect
[in] Ayırıcının çizildiği konumun piksel cinsinden sınırlayıcı dikdörtgeni.

bHorz
[in] TRUE ayırıcı yataysa, FALSE ayırıcı dikeyse.

Açıklamalar

CMFCToolBar::DoPaintbu düğmeleri çağırmak CMFCToolBar::DrawButton yerine stili olan TBBS_SEPARATOR her CMFCToolBar::DrawSeparator nesne için bu yöntemi çağırır.

Araç çubuğundaki ayırıcıların görünümünü özelleştirmek için öğesinden CMFCToolBar türetilen bir sınıfta bu yöntemi geçersiz kılın. Varsayılan uygulama, görünümü geçerli görsel yöneticisi tarafından belirlenen bir ayırıcı çizmek için çağırır CMFCVisualManager::OnDrawSeparator .

CMFCToolBar::EnableCustomizeButton

Araç çubuğunda görüntülenen Özelleştir düğmesini etkinleştirir veya devre dışı bırakır.

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    const CString& strCustomizeText,
    BOOL bQuickCustomize=TRUE);

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    UINT uiCustomizeTextResId,
    BOOL bQuickCustomize=TRUE);

Parametreler

bEnable
[in] Özelleştir düğmesini etkinleştirir veya devre dışı bırakır.

iCustomizeCmd
[in] Özelleştir düğmesinin komut kimliği.

strCustomizeText
[in] Özelleştir düğmesinin metin etiketi.

uiCustomizeTextResId
[in] Özelleştir düğmesi etiketinin kaynak dizesi kimliği.

bQuickCustomize
[in] Düğmeden açılan menüde Düğme Ekle veya Kaldır seçeneğini etkinleştirir veya devre dışı bırakır.

Açıklamalar

-1 ise iCustomizeCmd , birden çok araç çubuğu düğmesi araç çubuğu alanına sığmadığında çerçeve Özelleştir düğmesini görüntüler. Düğme, daha fazla düğme olduğunu gösteren çift sola işaret eden bir ok veya köşeli çift köşeli çift ayraç görüntüler.

Geçerli bir komut kimliği belirtir ve iCustomizeCmdbEnable ise TRUE, Özelleştir düğmesi her zaman görüntülenir. Düğme küçük bir aşağı oka sahiptir ve komut içeren bir menü açar. Bu komut tarafından strCustomizeTextbelirtilen metin etiketini kullanır. aynı zamanda isebQuickCustomize, menüde Düğme Ekle veya Kaldır seçeneği görüntülenir.TRUE

Çerçeve, tarafından iCustomizeCmdbelirtilen öğeden önce araç çubuğu alanına sığmayan düğmeleri menüye dinamik olarak ekler. Köşeli çift ayraç aşağı okun yanında görüntülenir.

CMFCToolBar::EnableDocking

Bölmenin ana çerçeveye yerleştirilmesine olanak tanır.

virtual void EnableDocking(DWORD dwAlignment);

Parametreler

dwAlignment
[in] Etkinleştirileceği yerleştirme hizalamasını belirtir.

Açıklamalar

Bu yöntem, CBasePane::EnableDockingveri üyesini AFX_CBRS_FLOATolarak ayarlayarak CBasePane::m_dwControlBarStyle temel sınıf uygulamasını genişletir. Bu yöntem daha sonra temel sınıf uygulamasına geçer dwAlignment .

CMFCToolBar::EnableLargeIcons

Araç çubuğu düğmelerinde büyük simgeleri etkinleştirir veya devre dışı bırakır.

void EnableLargeIcons(BOOL bEnable);

Parametreler

bEnable
[in] TRUE büyük simgeleri etkinleştirmek, FALSE büyük simgeleri devre dışı bırakmak için.

Açıklamalar

Varsayılan olarak, büyük simgeler etkinleştirilir.

CMFCToolBar::EnableQuickCustomization

Kullanıcının Alt tuşuna basıp düğmeyi yeni bir konuma sürükleyebilmesi için araç çubuklarının hızlı özelleştirmesini etkinleştirir veya devre dışı bırakır.

static void EnableQuickCustomization(BOOL bEnable=TRUE);

Parametreler

bEnable
[in] TRUE hızlı özelleştirmeyi etkinleştirmek, FALSE hızlı özelleştirmeyi devre dışı bırakmak için.

CMFCToolBar::EnableReflections

Komut yansımasını etkinleştirir veya devre dışı bırakır.

void EnableReflections(BOOL bEnable = TRUE);

Parametreler

bEnable
[in] TRUE komut yansımasını etkinleştirmek için; FALSE komut yansımasını devre dışı bırakmak için.

Açıklamalar

Birleşik giriş kutuları gibi eklenmiş denetimler içeren araç çubuğu düğmeleri için komut yansımasını etkinleştirmek için bu yöntemi çağır.

Komut yansıması hakkında daha fazla bilgi için bkz. TN062: Windows Denetimleri için ileti Düşünceler.

CMFCToolBar::EnableTextLabels

Araç çubuğu düğmesi resimleri altındaki metin etiketlerini etkinleştirir veya devre dışı bırakır.

void EnableTextLabels(BOOL bEnable=TRUE);

Parametreler

bEnable
TRUE araç çubuğu düğmesi resimleri altında metin etiketleri görünüyorsa; aksi takdirde FALSE.

Açıklamalar

Metin etiketleri etkinleştirilirse, araç çubuğundaki tüm düğmeler resimlerin altında görüntülenecek etiketler için alan sağlayacak şekilde büyütülür. Özelleştirme iletişim kutusunun Araç Çubukları sayfasında Metin etiketini göster onay kutusu vardır . Kullanıcı bir araç çubuğu seçip bu seçeneği denetlediğinde, çerçeve seçili araç çubuğunu çağırır EnableTextLabels . öğesinden CMFCToolBar::AllowChangeTextLabels döndürerekFALSE, öğesinden CMFCToolBar türetilen bir nesnenin onay kutusunu devre dışı bırakabilirsiniz.

CMFCToolBar::FromHandlePermanent

Verilen pencere tutamacını CMFCToolBar içeren nesnenin işaretçisini alır.

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

Parametreler

hwnd
[in] Aranacak pencere tutamacı.

İade Değeri

Verilen pencere tutamacını CMFCToolBar içeren nesnenin işaretçisi veya NULL karşılık gelen CMFCToolBar nesne yoksa.

Açıklamalar

Bu paylaşılan yöntem, verilen pencere tutamacını içeren nesne için CMFCToolBar uygulamadaki her araç çubuğunu inceler.

CMFCToolBar::GetAllButtons

Araç çubuğundaki düğmelerin salt okunur listesini döndürür.

const CObList& GetAllButtons() const;

İade Değeri

Sınıf nesnelerinin koleksiyonunu içeren bir CObList Sınıf nesnesine CMFCToolBarButton sabit başvuru.

CMFCToolBar::GetAllToolbars

Uygulamadaki tüm araç çubuklarının salt okunur listesini döndürür.

static const CObList& GetAllToolbars();

İade Değeri

Bir nesne koleksiyonu içeren bir CObList Sınıf nesnesine const CMFCToolBar başvurusu.

CMFCToolBar::GetBasicCommands

Uygulamada tanımlanan temel komutların salt okunur bir listesini döndürür.

static const CList<UINT,UINT>& GetBasicCommands();

İade Değeri

Temel komutların koleksiyonunu içeren bir CList Sınıf nesnesine const başvurusu.

Açıklamalar

veya CMFCToolBar::SetBasicCommandsöğesini çağırarak CMFCToolBar::AddBasicCommand temel komutları ekleyin.

CMFCToolBar::GetButton

Belirtilen dizinde CMFCToolBarButton Sınıf nesnesine bir işaretçi döndürür.

CMFCToolBarButton* GetButton(int iIndex) const;

Parametreler

iIndex
[in] Döndürülecek düğmenin dizinini belirtir.

İade Değeri

Varsa araç çubuğu düğmesinin işaretçisi; veya NULL böyle bir düğme yoksa.

CMFCToolBar::GetButtonInfo

Belirtilen dizindeki düğmenin komut kimliğini, stilini ve görüntü dizinini döndürür.

void GetButtonInfo(
    int nIndex,
    UINT& nID,
    UINT& nStyle,
    int& iImage) const;

Parametreler

nIndex
[in] Araç çubuğundaki düğme listesinde düğmenin dizinini belirtir.

nID
[out] Düğmenin komut kimliği.

nStyle
[out] Düğmenin stili.

iImage
[out] Düğmenin görüntüsünün dizini.

Açıklamalar

yöntemi, GetButtonInfo belirtilen dizinde bir araç çubuğu düğmesi bulur ve düğmenin komut kimliğini, stilini ve görüntü dizinini alır.

Belirtilen dizindeki düğme yoksa, yöntem döndürdüğünde çerçeve 0 ve iImage -1 olarak ayarlar.nIDnStyle

CMFCToolBar::GetButtonSize

Araç çubuğundaki her düğmenin boyutlarını döndürür.

CSize GetButtonSize() const;

İade Değeri

CSize Araç çubuğundaki her düğmenin boyutlarını belirten bir Sınıf nesnesi.

Açıklamalar

Araç çubuğundaki her düğmenin boyutlarını ayarlamak için veya CMFCToolBar::SetLockedSizes öğesini çağırınCMFCToolBar::SetSizes.

CMFCToolBar::GetButtonStyle

Belirtilen dizinde bulunan araç çubuğu düğmesinin geçerli stilini döndürür.

UINT GetButtonStyle(int nIndex) const;

Parametreler

nIndex
[in] Araç çubuğu düğmesinin dizinini belirtir.

İade Değeri

Araç çubuğu düğmesinin stilini belirten değer. . Olası stillerin listesi için bkz . ToolBar Denetim Stilleri .

Açıklamalar

Araç çubuğu düğmesinin stilini ayarlamak için arama CMFCToolBar::SetButtonStyle

CMFCToolBar::GetButtonText

Belirtilen dizine sahip bir düğmenin metin etiketini döndürür.

CString GetButtonText(int nIndex) const;

void GetButtonText(
    int nIndex,
    CString& rString) const;

Parametreler

nIndex
[in] Araç çubuğu düğmesinin dizini.

rString
[out] Araç çubuğu düğmesinin etiket metni.

İade Değeri

Araç çubuğu düğmesinin etiket metni.

Açıklamalar

Metin etiketini ayarlamak için veya CMFCToolBar::SetToolBarBtnText öğesini arayınCMFCToolBar::SetButtonText.

CMFCToolBar::GetColdImages

Uygulamadaki soğuk araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi döndürür.

static CMFCToolBarImages* GetColdImages();

İade Değeri

Soğuk araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi.

Açıklamalar

Soğuk görüntüler, kullanıcı araç çubuğu düğmeleriyle etkileşim kurmadığında kullanılan görüntülerdir. Soğuk görüntüleri yüklemek için veya CMFCToolBar::LoadBitmap öğesini arayınCMFCToolBar::LoadBitmapEx.

CMFCToolBar::GetColumnWidth

Araç çubuğu düğmelerinin genişliğini döndürür.

virtual int GetColumnWidth() const;

İade Değeri

Araç çubuğu düğmelerinin genişliğini belirten bir değer.

Açıklamalar

Çerçeve, araç çubuğu düzenini hesaplamak için bu yöntemi çağırır. Araç çubuğunuz için farklı bir sütun genişliği belirtmek üzere türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCToolBar::GetCommandButtons

Uygulamadaki tüm araç çubuklarından belirtilen komut kimliğine sahip düğmelerin listesini döndürür.

static int GetCommandButtons(
    UINT uiCmd,
    CObList& listButtons);

Parametreler

uiCmd
[in] Düğmelerin komut kimliği.

listButtons
[out] Araç çubuğu düğmelerinin listesini alan bir CObList Sınıf nesnesi başvurusu.

İade Değeri

Belirtilen komut kimliğine sahip düğme sayısı.

CMFCToolBar::GetCount

Araç çubuğundaki düğmelerin ve ayırıcıların sayısını döndürür.

int GetCount() const;

İade Değeri

Araç çubuğundaki düğmelerin ve ayırıcıların sayısı.

CMFCToolBar::GetCustomizeButton

Araç çubuğuyla ilişkili nesnenin CMFCCustomizeButton işaretçisini alır.

CMFCCustomizeButton* GetCustomizeButton();

İade Değeri

Araç çubuğuyla ilişkili nesnenin işaretçisi CMFCCustomizeButton .

Açıklamalar

Bu yöntem, araç çubuğunun sonunda görüntülenen Özelleştir düğmesini alır. CMFCToolBar::EnableCustomizeButton Araç çubuğunuza Özelleştir düğmesini eklemek için yöntemini kullanın.

Araç çubuğunun CMFCToolBar::IsExistCustomizeButton geçerli CMFCCustomizeButton bir nesne içerip içermediğini belirlemek için yöntemini çağırabilirsiniz.

CMFCToolBar::GetDefaultImage

Belirtilen komut kimliğine sahip bir araç çubuğu düğmesi için varsayılan görüntünün dizinini döndürür.

static int GetDefaultImage(UINT uiID);

Parametreler

uiID
[in] Düğmenin komut kimliğini belirtir.

İade Değeri

Paylaşılan resim listesinde araç çubuğu görüntüsünün dizini.

Açıklamalar

Belirtilen komut kimliğine sahip bir araç çubuğu düğmesinin varsayılan görüntüsünün dizinini almak için bu paylaşılan yöntemi kullanın. Dönüş değeri, uygulamadaki tüm araç çubukları için araç çubuğu düğme görüntülerinin paylaşılan koleksiyonundaki bir dizindir. Bu koleksiyona CMFCToolBar::GetImages bir işaretçi almak için yöntemini çağırın.

CMFCToolBar::GetDisabledImages

Uygulamadaki devre dışı bırakılmış araç çubuğu düğmeleri için kullanılan görüntü koleksiyonuna yönelik bir işaretçi döndürür.

static CMFCToolBarImages* __stdcall GetDisabledImages();

İade Değeri

Devre dışı bırakılmış araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi.

Açıklamalar

Sınıf ve CMFCToolBar::LoadBitmap yöntemleri kullanarak CMFCToolBarEditBoxButton devre dışı bırakılan araç çubuğu düğme görüntülerini yükleyin.

CMFCToolBar::GetDisabledMenuImages

Uygulamadaki devre dışı menü düğmeleri için kullanılan görüntü koleksiyonuna yönelik bir işaretçi döndürür.

static CMFCToolBarImages* __stdcall GetDisabledMenuImages();

İade Değeri

Devre dışı bırakılmış menü görüntüleri koleksiyonunun işaretçisi.

Açıklamalar

Class yöntemini kullanarak CMFCToolBarEditBoxButton devre dışı bırakılan görüntüleri yükleyin.

CMFCToolBar::GetDroppedDownMenu

Şu anda alt menüsünü görüntüleyen menü düğmesi nesnesinin işaretçisini alır.

CMFCToolBarMenuButton* GetDroppedDownMenu(int* pIndex = NULL) const;

Parametreler

pIndex
[out] Araç çubuğu düğmeleri koleksiyonundaki düğmenin dizinini alır.

İade Değeri

Alt menüsünü görüntüleyen menü düğmesi nesnesinin işaretçisi veya NULL alt menüsünü görüntüleyen bir menü yoksa.

Açıklamalar

Bu yöntem null olmayan bir değer döndürür ve pIndex değilse NULL, tarafından pIndex işaret edilen değer araç çubuğu düğmeleri koleksiyonundaki menü düğmesinin dizinine ayarlanır.

CMFCToolBar::GetGrayDisabledButtons

Devre dışı bırakılan düğmelerin görüntülerinin normal düğme görüntülerinin soluk sürümleri mi yoksa devre dışı bırakılan düğme görüntüleri koleksiyonundan mı alındığını belirtir.

BOOL GetGrayDisabledButtons() const;

İade Değeri

TRUE devre dışı bırakılan düğmelerin görüntülerini karartmak için; FALSE devre dışı bırakılan görüntülerin koleksiyonundan görüntü almak için.

Açıklamalar

Soluk görüntüler ile devre dışı bırakılan görüntüler koleksiyonundaki görüntüler arasında geçiş yapmak için kullanın CMFCToolBar::SetGrayDisabledButtons .

CMFCToolBar::GetHighlightedButton

Şu anda vurgulanmış araç çubuğu düğmesinin işaretçisini döndürür.

CMFCToolBarButton* GetHighlightedButton() const;

İade Değeri

Araç çubuğu düğmesi nesnesinin işaretçisi; veya NULL düğme vurgulanmamışsa.

Açıklamalar

Klavye odağı varsa araç çubuğu düğmesi vurgulanır. Araç çubuğu düğmeleri bu uygulamada çalışırken izleniyorsa (daha fazla bilgi için bkz CMFCToolBar::GetHotBorder . ve CMFCToolBar::SetHotBorder) araç çubuğu düğmesi vurgulanır ve hiçbir araç çubuğu düğmesi veya menü öğesinde klavye odağı olmadığında fare buna işaret eder.

CMFCToolBar::GetHotBorder

Araç çubuğu düğmelerinin etkin izlenip izlenmediğini belirler. Bir düğme etkin izleniyorsa, fare üzerinde hareket ettiğinde vurgulanır.

BOOL GetHotBorder() const;

İade Değeri

TRUE araç çubuğu düğmeleri etkin izleniyorsa; aksi takdirde , FALSE.

Açıklamalar

Varsayılan olarak, araç çubuğu düğmeleri etkin izlenir.

CMFCToolBar::GetHotTextColor

Vurgulanan araç çubuğu düğmelerinin metin rengini döndürür.

static COLORREF GetHotTextColor();

İade Değeri

COLORREF Geçerli vurgulanmış metin rengini temsil eden değer.

Açıklamalar

Vurgulanan araç çubuğu düğmeleri için yeni bir metin rengi ayarlamak için arayın CMFCToolBar::SetHotTextColor .

CMFCToolBar::GetHwndLastFocus

Araç çubuğundan hemen önce giriş odağına sahip olan pencere tutamacını döndürür.

HWND GetHwndLastFocus() const;

İade Değeri

Daha önce giriş odağına sahip olan Sınıftan CMFCBaseToolBartüretilmemiş bir pencere tutamacı veya NULL böyle bir pencere yoksa.

Açıklamalar

Denetim CMFCToolBar giriş odağını aldığında, daha sonra geri yükleyebilmesi için odağı kaybeden pencereye bir tanıtıcı depolar.

CMFCToolBar::GetIgnoreSetText

Düğme etiketlerini ayarlama çağrılarının yoksayılıp yoksayılmayacağını belirtir.

BOOL GetIgnoreSetText() const;

İade Değeri

TRUE düğme etiketlerini ayarlama çağrıları yoksayılırsa; aksi takdirde , FALSE.

Açıklamalar

CMFCToolBar::GetImages

Uygulamadaki varsayılan düğme görüntüleri koleksiyonuna bir işaretçi döndürür.

static CMFCToolBarImages* GetImages();

İade Değeri

Uygulamadaki CMFCToolBarImages tüm araç çubukları için varsayılan görüntü koleksiyonunu içeren Sınıf nesnesi işaretçisi.

Açıklamalar

Bu paylaşılan yöntem, uygulama için tüm varsayılan araç çubuğu görüntülerinin koleksiyonuna erişim sağlar. Koleksiyona CMFCToolBar::LoadBitmap görüntü eklemek için yöntemini çağırın.

CMFCToolBar::GetImageSize

Araç çubuğu düğme görüntülerinin geçerli boyutunu döndürür.

CSize GetImageSize() const;

İade Değeri

CSize Araç çubuğu düğme görüntülerinin geçerli boyutunu temsil eden bir Sınıf nesnesi.

CMFCToolBar::GetImagesOffset

Bu araç çubuğunun araç çubuğu düğme görüntülerinin genel listesinde araç çubuğu düğme görüntülerini bulmak için kullanılan dizin uzaklığını döndürür.

int GetImagesOffset() const;

İade Değeri

Araç çubuğu görüntülerinin dizin uzaklığı.

Açıklamalar

Tüm araç çubuğu varsayılan görüntüleri genel CMFCToolBarImages Sınıf listesinde depolanır. Araç çubuğundaki her düğmenin görüntüleri bu listede art arda depolanır. Görüntünün dizinini hesaplamak için, araç çubuğundaki düğmenin dizinini bu araç çubuğu düğmesinin görüntü listesinin başlangıcının uzaklığına ekleyin.

Düğme işaretçisi verilen araç çubuğu düğmesinin dizinini almak için çağrısı CMFCToolBar::ButtonToIndex .

Araç çubuğu görüntüleri koleksiyonuna bir işaretçi almak için çağrısı CMFCToolBar::GetImages .

CMFCToolBar::GetInvalidateItemRect

verilen dizindeki düğme için yeniden çizilmesi gereken istemci alanının bölgesini alır.

virtual void GetInvalidateItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parametreler

nIndex
[in] İstemci alanının alındığı düğmenin dizini.

lpRect
[out] İstemci alanının bölgesini alan bir RECT nesnenin işaretçisi.

Açıklamalar

lpRect parametresi olmamalıdırNULL. Sağlanan dizinde düğme yoksa sıfıra lpRect başlatılan bir RECT nesne alır.

CMFCToolBar::GetItemID

Belirtilen dizinde araç çubuğu düğmesinin komut kimliğini döndürür.

UINT GetItemID(int nIndex) const;

Parametreler

nIndex
[in] Araç çubuğu düğmesinin dizinini belirtir.

İade Değeri

Araç çubuğu düğmesinin komut kimliği; veya belirtilen dizine sahip düğme yoksa sıfır.

CMFCToolBar::GetItemRect

Belirtilen dizindeki düğmenin sınırlayıcı dikdörtgenini döndürür.

virtual void GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parametreler

nIndex
[in] Araç çubuğu düğmesinin dizinini belirtir.

lpRect
[out] CRect Görüntü sınırlayıcı dikdörtgenin koordinatlarını alan nesne işaretçisi.

Açıklamalar

Belirtilen dizinde CRect bir düğme yoksa noktaların 0 olarak ayarlandığı nesne lpRect .

Örnek

Aşağıdaki örnekte sınıfının yönteminin GetItemRect nasıl kullanılacağı gösterilmektedir CMFCToolBar . Bu kod parçacığı, IE Tanıtım örneğinin bir parçasıdır.

CMFCToolBar m_wndToolBar;
CRect rectToolBar;
m_wndToolBar.GetItemRect(0, &rectToolBar);

CMFCToolBar::GetLargeColdImages

Uygulamadaki büyük soğuk araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi döndürür.

static CMFCToolBarImages* GetLargeColdImages();

İade Değeri

Büyük soğuk görüntüler koleksiyonunun işaretçisi.

Açıklamalar

Soğuk görüntüler, kullanıcı araç çubuğu düğmeleriyle etkileşim kurmadığında kullanılan görüntülerdir. Büyük soğuk görüntüleri yüklemek için çağırın CMFCToolBar::LoadBitmapEx .

CMFCToolBar::GetLargeDisabledImages

Uygulamadaki devre dışı bırakılmış büyük araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi döndürür.

static CMFCToolBarImages* GetLargeDisabledImages();

İade Değeri

Büyük devre dışı bırakılmış araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi.

Açıklamalar

Büyük görüntüler, normal araç çubuğu düğme görüntülerinin büyük sürümleridir. Büyük görüntüleri yüklemek için veya CMFCToolBar::LoadBitmap öğesini çağırınCMFCToolBar::LoadBitmapEx.

CMFCToolBar::GetLargeImages

Uygulamadaki büyük araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi döndürür.

static CMFCToolBarImages* GetLargeImages();

İade Değeri

Büyük araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi.

Açıklamalar

Büyük görüntüler, normal araç çubuğu düğme görüntülerinin büyük sürümleridir. Büyük görüntüleri yüklemek için çağırın CMFCToolBar::LoadBitmapEx .

CMFCToolBar::GetLockedColdImages

Araç çubuğundaki kilitli soğuk görüntülerin koleksiyonuna bir işaretçi döndürür.

CMFCToolBarImages* GetLockedColdImages();

İade Değeri

Kilitli soğuk görüntüler koleksiyonuna veya NULL araç çubuğu kilitli değilse bir işaretçi.

Açıklamalar

Kilitli görüntüler, kullanıcı araç çubuğunu özelleştiremediğinde çerçevenin kullandığı normal araç çubuğu düğme görüntülerinin sürümleridir. Soğuk görüntüler, kullanıcı araç çubuğu düğmeleriyle etkileşim kurmadığında kullanılan görüntülerdir.

Araç çubuğu kilitli değilse bu yöntem döndürür NULL . Bu yöntem, araç çubuğu kilitli değilse Hata ayıklama derlemelerinde bir onay hatası da oluşturur. Kilitli araç çubukları hakkında daha fazla bilgi için bkz CMFCToolBar::IsLocked. .

CMFCToolBar::LoadBitmapEx Kilitli soğuk görüntüleri yüklemek için yöntemini çağırın.

CMFCToolBar::GetLockedDisabledImages

Araç çubuğundaki kilitli devre dışı görüntülerin koleksiyonuna bir işaretçi döndürür.

CMFCToolBarImages* GetLockedDisabledImages();

İade Değeri

Kilitli devre dışı bırakılan görüntülerin koleksiyonuna veya NULL araç çubuğunun kilitli olmamasına işaret eden bir işaretçi.

Açıklamalar

Kilitli görüntüler, kullanıcı araç çubuğunu özelleştiremediğinde çerçevenin kullandığı normal araç çubuğu düğme görüntülerinin sürümleridir. Devre dışı bırakılan görüntüler, bir düğme stiline sahip olduğunda çerçevenin TBBS_DISABLED kullandığı görüntülerdir.

Araç çubuğu kilitli değilse bu yöntem döndürür NULL . Bu yöntem, araç çubuğu kilitli değilse Hata ayıklama derlemelerinde bir onay hatası da oluşturur. Kilitli araç çubukları hakkında daha fazla bilgi için bkz CMFCToolBar::IsLocked. .

CMFCToolBar::LoadBitmapEx Kilitli devre dışı bırakılan görüntüleri yüklemek için yöntemini çağırın.

CMFCToolBar::GetLockedImages

Araç çubuğundaki kilitli düğme görüntüleri koleksiyonuna bir işaretçi döndürür.

CMFCToolBarImages* GetLockedImages();

İade Değeri

Kilitli araç çubuğu düğme görüntülerinin koleksiyonuna veya NULL araç çubuğu kilitli değilse bir işaretçi.

Açıklamalar

Kilitli görüntüler, kullanıcı araç çubuğunu özelleştiremediğinde çerçevenin kullandığı normal araç çubuğu düğme görüntülerinin sürümleridir.

Araç çubuğu kilitli değilse bu yöntem döndürür NULL . Bu yöntem, araç çubuğu kilitli değilse Hata ayıklama derlemelerinde bir onay hatası da oluşturur. Kilitli araç çubukları hakkında daha fazla bilgi için bkz CMFCToolBar::IsLocked. .

CMFCToolBar::GetLockedImageSize

Kilitli araç çubuğu görüntülerinin varsayılan boyutunu döndürür.

CSize GetLockedImageSize() const;

İade Değeri

CSize Kilitli araç çubuğu görüntülerinin boyutunu belirten bir yapı veya araç çubuğu kilitli değilse boş CSize bir yapı.

Açıklamalar

Kilitli görüntüler, kullanıcı araç çubuğunu özelleştiremediğinde çerçevenin kullandığı normal araç çubuğu düğme görüntülerinin sürümleridir.

Araç çubuğu kilitli değilse, bu yöntem sıfır genişlikli ve yüksekliği sıfır olan bir CSize yapı döndürür. Bu yöntem, araç çubuğu kilitli değilse Hata ayıklama derlemelerinde bir onay hatası da oluşturur. Kilitli araç çubukları hakkında daha fazla bilgi için bkz CMFCToolBar::IsLocked. .

CMFCToolBar::SetLockedSizes Kilitli görüntü boyutunu belirtmek için yöntemini çağırın.

CMFCToolBar::GetLockedMenuImages

Araç çubuğundaki kilitli araç çubuğu menü görüntüleri koleksiyonuna bir işaretçi döndürür.

CMFCToolBarImages* GetLockedMenuImages();

İade Değeri

Kilitli araç çubuğu menü görüntülerinin koleksiyonuna veya NULL araç çubuğu kilitli değilse bir işaretçi.

Açıklamalar

Kilitli görüntüler, kullanıcı araç çubuğunu özelleştiremediğinde çerçevenin kullandığı normal araç çubuğu menü görüntülerinin sürümleridir.

Araç çubuğu kilitli değilse bu yöntem döndürür NULL . Bu yöntem, araç çubuğu kilitli değilse Hata ayıklama derlemelerinde bir onay hatası da oluşturur. Kilitli araç çubukları hakkında daha fazla bilgi için bkz CMFCToolBar::IsLocked. .

CMFCToolBar::LoadBitmapEx Kilitli menü görüntülerini yüklemek için yöntemini çağırın.

CMFCToolBar::GetMenuButtonSize

Uygulamadaki menü düğmelerinin boyutunu döndürür.

static CSize GetMenuButtonSize();

İade Değeri

CSize Menü düğmelerinin boyutunu piksel cinsinden temsil eden nesne.

Açıklamalar

Araç çubuklarındaki menü düğmelerinin boyutu genel değişken olarak korunur ve bu statik yöntemle alınabilir.

Bu genel değişkeni ayarlamak için çağrısı CMFCToolBar::SetMenuSizes .

CMFCToolBar::GetMenuImages

Uygulamadaki menü düğmesi görüntüleri koleksiyonuna bir işaretçi döndürür.

static CMFCToolBarImages* GetMenuImages();

İade Değeri

Menü görüntüleri koleksiyonunun işaretçisi.

Açıklamalar

CMFCToolBar::LoadBitmapEx Menü görüntülerini yüklemek için yöntemini çağırın.

Düğmelerin CMFCToolBar::SetMenuSizes ve görüntülerinin boyutunu ayarlamak için yöntemini çağırın.

CMFCToolBar::GetMenuImageSize

Uygulamadaki menü düğmesi görüntülerinin boyutunu döndürür.

static CSize GetMenuImageSize();

İade Değeri

CSize Menü görüntülerinin boyutunu temsil eden nesne.

Açıklamalar

Bu yöntem, genel değişken olarak tutulan araç çubuğu menü düğmelerindeki görüntülerin boyutunu döndürür. Bu genel değişkeni ayarlamak için çağrısı CMFCToolBar::SetMenuSizes .

CMFCToolBar::GetOrigButtons

Araç çubuğunun özelleştirilmemiş düğmeleri koleksiyonunu alır.

const CObList& GetOrigButtons() const;

İade Değeri

Araç çubuğunun özelleştirilmemiş düğmelerinin listesine başvuru.

Açıklamalar

Çerçeve, kullanıcı tarafından özelleştirilmeden önce araç çubuğu düğmelerinin bir kopyasını oluşturur. yöntemi, CMFCToolBar::SetButtons sağlanan dizideki her düğmenin bir kopyasını özgün düğmeler listesine ekler. yöntemi, CMFCToolBar::RestoreOriginalState kaynak dosyasından yükleyerek araç çubuğunun özgün durumunu geri yükler.

Araç çubuğunuz için özgün düğmelerin listesini ayarlamak için yöntemini çağırın CMFCToolBar::SetOrigButtons .

CMFCToolBar::GetOrigResetButtons

Araç çubuğunun özelleştirilmemiş sıfırlama düğmeleri koleksiyonunu alır.

const CObList& GetOrigResetButtons() const;

İade Değeri

Araç çubuğunun özelleştirilmemiş sıfırlama düğmeleri listesine başvuru.

Açıklamalar

Kullanıcı özelleştirme modu sırasında Sıfırla düğmesini seçtiğinde, çerçeve araç çubuğundan kaldırılan düğmeleri geri yüklemek için bu yöntemi kullanır.

yöntemi, CMFCToolBar::SetButtons yöntemini çağırdıktan sonra özgün sıfırlama düğmeleri listesine her araç çubuğu düğmesinin CMFCToolBar::OnReset bir kopyasını ekler. Kullanıcı Sıfırla düğmesine bastıktan sonra düğmelerin görünümünü özelleştirmek için yöntemini geçersiz kılabilirsinizCMFCToolBar::OnReset.

CMFCToolBar::GetResourceID

Araç çubuğunun kaynak kimliğini alır.

UINT GetResourceID() const;

İade Değeri

Araç çubuğunun kaynak kimliği.

Açıklamalar

Araç çubuğunun CMFCToolBar::LoadToolBarEx kaynak kimliğini ayarlamak için yöntemini çağırın.

CMFCToolBar::GetRouteCommandsViaFrame

Üst çerçeve veya sahip olan hangi nesnenin araç çubuğuna komut gönderdiğini belirler.

BOOL GetRouteCommandsViaFrame();

İade Değeri

Üst çerçeve araç çubuğuna komut gönderiyorsa sıfır olmayan; 0, sahip araç çubuğuna komut gönderirse.

Açıklamalar

Varsayılan olarak, üst çerçeve komutları araç çubuğuna gönderir. Bu davranışı değiştirmek için çağrısı CMFCToolBar::SetRouteCommandsViaFrame .

Bu yöntem sıfır olmayan bir değer döndürürse, yöntemini kullanarak üst çerçeve nesnesine CMFCToolBar::GetCommandTarget bir işaretçi alabilirsiniz. Bu yöntemi kullanan bir örnek için VisualStudioDemo örneğine bakın.

CMFCToolBar::GetRowHeight

Araç çubuğu düğmelerinin yüksekliğini döndürür.

virtual int GetRowHeight() const;

İade Değeri

Araç çubuğu düğmelerinin piksel cinsinden yüksekliği.

Açıklamalar

Çerçeve, araç çubuğu düzenini hesaplamak için bu yöntemi çağırır. Araç çubuğunuz için farklı bir yükseklik belirtmek üzere türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCToolBar::GetShowTooltips

Araç çubuğu düğmeleri için araç ipuçlarının görüntülenip görüntülenmeyeceğini belirtir.

static BOOL GetShowTooltips();

İade Değeri

TRUE araç çubuğu düğmeleri için araç ipuçları gösteriliyorsa; aksi takdirde FALSE.

Açıklamalar

Varsayılan olarak araç ipuçları gösterilir. çağırarak CMFCToolBar::SetShowTooltipsbu statik bayrağı değiştirebilirsiniz.

CMFCToolBar::GetSiblingToolBar

Araç çubuğunun eşdüzeyini alır.

CMFCToolBar* GetSiblingToolBar();

İade Değeri

Eşdüzey araç çubuğunun işaretçisi.

Açıklamalar

Düğmeleri Bir Satırda Göster ve İki Satırda Düğmeleri Göster düğmelerini etkinleştirme hakkında daha fazla bilgi için bkzCMFCToolBar::SetSiblingToolBar. .

CMFCToolBar::GetUserImages

Uygulamadaki kullanıcı tanımlı araç çubuğu düğme görüntülerinin koleksiyonuna bir işaretçi döndürür.

static CMFCToolBarImages* GetUserImages();

İade Değeri

Uygulamadaki tüm araç çubukları için kullanıcı tanımlı araç çubuğu düğme görüntülerinin koleksiyonuna yönelik bir işaretçi.

Açıklamalar

Uygulamadaki CMFCToolBar::SetUserImages kullanıcı tanımlı görüntülerin koleksiyonunu ayarlamak için yöntemini çağırın.

CMFCToolBar::HitTest

Belirtilen konumda bulunan araç çubuğu düğmesinin dizinini döndürür.

virtual int HitTest(CPoint point);

Parametreler

point
[in] İstemci koordinatlarında test edilecek nokta.

İade Değeri

Belirtilen konumda bulunan düğmenin dizini veya böyle bir düğme yoksa veya düğme bir ayırıcıysa -1.

CMFCToolBar::InsertButton

Araç çubuğuna bir düğme ekler.

virtual int InsertButton(
    const CMFCToolBarButton& button,
    INT_PTR iInsertAt=-1);

virtual int InsertButton(
    CMFCToolBarButton* pButton,
    int iInsertAt=-1);

Parametreler

button
[in] Eklenecek düğmeyi belirtir.

iInsertAt
[in] Düğmenin ekleyebileceğiniz sıfır tabanlı konumu belirtir.

İade Değeri

Düğmenin eklendiği konum veya hata oluşursa -1.

Açıklamalar

-1 ise iInsertAt , bu yöntem düğmeyi araç çubuğu düğmeleri listesinin sonuna ekler.

Araç çubuğuna CMFCToolBar::InsertSeparator ayırıcı eklemek için yöntemini çağırın.

CMFCToolBar::InsertSeparator

Araç çubuğuna bir ayırıcı ekler.

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

Parametreler

iInsertAt
[in] Ayırıcının ekleyebileceğiniz sıfır tabanlı konumu belirtir. Bu parametre 0'dan büyük olmalıdır.

İade Değeri

Ayırıcının eklendiği konum veya hata oluşursa -1.

Açıklamalar

Mevcut iki düğme arasına ayırıcı eklemek için bu yöntemi çağır. -1 ise iInsertAt , bu yöntem araç çubuğu düğmeleri listesinin sonuna ayırıcı ekler.

Boş bir araç çubuğuna ayırıcı eklemek için bu yöntemi kullanamazsınız.

Araç çubuğuna CMFCToolBar::InsertButton düğme eklemek için yöntemini çağırın.

CMFCToolBar::InvalidateButton

Sağlanan dizinde bulunan araç çubuğu düğmesinin istemci alanını geçersiz kılma.

CMFCToolBarButton* InvalidateButton(int nIndex);

Parametreler

nIndex
[in] Araç çubuğundaki düğmenin sıfır tabanlı dizini.

İade Değeri

Sağlanan dizinde CMFCToolBarButton var olan nesnenin işaretçisi veya NULL böyle bir nesne yoksa.

Açıklamalar

Çerçeve, araç çubuğu düğmesiyle ilişkili istemci alanını güncelleştirdiğinde bu yöntemi çağırır. Sağlanan dizinde CWnd::InvalidateRect var olan nesnenin CMFCToolBarButton istemci dikdörtgeni ile yöntemini çağırır.

CMFCToolBar::IsAddRemoveQuickCustomize

Özelleştir menü seçeneğini kullanarak bir kullanıcının araç çubuğu düğmeleri ekleyip ekleyemeyeceğini veya kaldırabileceğini belirler.

BOOL IsAddRemoveQuickCustomize();

İade Değeri

TRUEbir kullanıcı araç çubuğunu değiştirmek için Özelleştir menü seçeneğini kullanabiliyorsa; değilse, FALSE.

Açıklamalar

CMFCToolBar::IsAltCustomizeMode

Bir düğmeyi sürüklemek için hızlı özelleştirmenin kullanılıp kullanılmadığını belirtir. Hızlı özelleştirme etkinleştirildiğinde, kullanıcı Alt tuşunu basılı tutup düğmeyi yeni bir konuma sürükleyebilir.

static BOOL __stdcall IsAltCustomizeMode();

İade Değeri

TRUE bir düğmeyi sürüklemek için hızlı özelleştirme kullanılıyorsa; aksi takdirde , FALSE.

Açıklamalar

CMFCToolBar::IsAutoGrayInactiveImages

Etkin olmayan (vurgulanmamış) düğme görüntülerinin otomatik olarak oluşturulup etkinleştirilmediğini belirtir.

static BOOL IsAutoGrayInactiveImages();

İade Değeri

TRUE etkin olmayan görüntüleri otomatik olarak soluk alma seçeneği etkinse; aksi takdirde FALSE.

Açıklamalar

çağrısı CMFCToolBar::AutoGrayInactiveImagesyaparak etkin olmayan görüntülerin otomatik kararmasını etkinleştirebilir veya devre dışı bırakabilirsiniz.

CMFCToolBar::IsBasicCommand

Bir komutun temel komutlar listesinde olup olmadığını belirler.

static BOOL IsBasicCommand(UINT uiCmd);

Parametreler

uiCmd
[in] Denetlenecek komutu belirtir.

İade Değeri

TRUE belirtilen komut temel komutlar listesine aitse; aksi takdirde FALSE.

Açıklamalar

Bu statik yöntem, tarafından uiCmd belirtilen komutun temel komutların genel listesine ait olup olmadığını belirler. veya CMFCToolBar::SetBasicCommandsöğesini çağırarak CMFCToolBar::AddBasicCommand temel komutların listesini değiştirebilirsiniz.

CMFCToolBar::IsButtonExtraSizeAvailable

Araç çubuğunun genişletilmiş kenarlıklara sahip düğmeleri görüntüleyip görüntüleyemeyeceğini belirler.

virtual BOOL IsButtonExtraSizeAvailable() const;

İade Değeri

TRUE çubuğun fazladan kenarlık boyutuna sahip düğmeleri görüntüleyebiliyorsa; aksi takdirde FALSE.

Açıklamalar

Araç çubuğu nesnesi, genişletilmiş kenarlıklara sahip düğmeleri görüntüleyebiliyorsa döndürür TRUE . Araç çubuğu düğmesi, bildirimi işlediğinde CMFCToolBarButton::OnChangeParentWnd bu yöntemi çağırır ve iç fazladan kenarlık boyutu bayrağını buna göre ayarlar. Bu iç bayrak daha sonra çağrılarak CMFCToolBarButton::IsExtraSizealınabilir.

Bu yöntemi öğesinden CMFCToolBar türetilen bir sınıfta geçersiz kılın ve çubuğunuz fazladan kenarlık boyutuna sahip araç çubuğu düğmelerini görüntüleyip aksini döndürebiliyorsa döndürebilir TRUEFALSE . Varsayılan uygulama döndürür TRUE.

CMFCToolBar::IsButtonHighlighted

Belirtilen düğmenin vurgulanıp vurgulu olmadığını belirler.

BOOL IsButtonHighlighted(int iButton) const;

Parametreler

iButton
[in] Araç çubuğu düğmesinin dizinini belirtir.

İade Değeri

TRUE belirtilen düğme vurgulanmışsa; aksi takdirde , FALSE.

Açıklamalar

CMFCToolBar::IsCommandPermitted

Bir komuta izin verilip verilmeyeceğini belirler.

static BOOL IsCommandPermitted(UINT uiCmd);

Parametreler

uiCmd
[in] Denetlenecek komutu belirtir.

İade Değeri

TRUE belirtilen komuta izin verilirse; aksi takdirde FALSE.

Açıklamalar

Bu statik yöntem, tarafından uiCmd belirtilen komutun izin verilmeyen komutların genel listesine ait olup olmadığını belirler.

komutunu çağırarak CMFCToolBar::SetNonPermittedCommandsizin verilemeyen komutların listesini değiştirebilirsiniz.

CMFCToolBar::IsCommandRarelyUsed

Bir komutun nadiren kullanılıp kullanılmadığını belirler.

static BOOL IsCommandRarelyUsed(UINT uiCmd);

Parametreler

uiCmd
[in] Denetlenecek komutu belirtir.

İade Değeri

TRUE belirtilen komut nadiren kullanılıyorsa; aksi takdirde FALSE.

Açıklamalar

Yöntemi, IsCommandRarelyUsed aşağıdaki koşullardan biri veya daha fazlası oluştuğunda döndürür FALSE :

  • Belirtilen komut temel komutlar listesine ait

  • Belirtilen komut standart komutlardan biridir

  • Çerçeve özelleştirme modunda

  • Temel komutların listesi boş

  • Komut çağrılarının %20'sinden fazlası belirtilen komuta yapılan çağrılardır.

CMFCToolBar::IsCustomizeMode

Araç çubuğu çerçevesinin özelleştirme modunda olup olmadığını belirtir.

static BOOL IsCustomizeMode();

İade Değeri

TRUE çerçeve özelleştirme modundaysa; aksi takdirde FALSE.

Açıklamalar

komutunu çağırarak CMFCToolBar::SetCustomizeModeözelleştirme modunu değiştirebilirsiniz.

Kullanıcı özelleştirme iletişim kutusunu ( CMFCToolBarsCustomizeDialog Sınıf) çağırdığında çerçeve modu değiştirir.

CMFCToolBar::IsDragButton

Bir araç çubuğu düğmesinin sürüklenip sürüklenmediğini belirler.

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

Parametreler

pButton
[in] Araç çubuğu düğmesinin işaretçisi.

İade Değeri

TRUE belirtilen düğme sürükleniyorsa; aksi takdirde , FALSE.

Açıklamalar

CMFCToolBar::IsExistCustomizeButton

Araç çubuğunun Özelleştir düğmesini içerip içermediğini belirler.

BOOL IsExistCustomizeButton();

İade Değeri

TRUE araç çubuğunda Özelleştir düğmesi varsa, değilse FALSE.

Açıklamalar

Bu yöntem döndürürseTRUECMFCToolBar::GetCustomizeButton, yöntem araç çubuğunun sonunda görünen Özelleştir düğmesine bir işaretçi döndürür.

CMFCToolBar::EnableCustomizeButton Araç çubuğunuza Özelleştir düğmesini eklemek için yöntemini kullanın.

CMFCToolBar::IsFloating

Araç çubuğunun kayan olup olmadığını belirler.

virtual BOOL IsFloating() const;

İade Değeri

TRUE araç çubuğu kayan ise; aksi takdirde , FALSE.

CMFCToolBar::IsLargeIcons

Uygulamadaki araç çubuklarının şu anda büyük simgeler görüntüleyip görüntülemeyeceğini belirtir.

static BOOL IsLargeIcons();

İade Değeri

TRUE uygulama büyük simgeler kullanıyorsa; aksi takdirde FALSE.

Açıklamalar

Büyük simgelerle normal simgeler arasında geçiş yapmak için çağrısı CMFCToolBar::SetLargeIcons .

Kullanıcı Özelleştirme iletişim kutusunun Seçenekler sayfasında Büyük simgeler onay kutusunu değiştirdiğinde çerçeve modu otomatik olarak değiştirir.

CMFCToolBar::IsLastCommandFromButton

En son yürütülen komutun belirtilen araç çubuğu düğmesinden gönderilip gönderilmediğini belirler.

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

Parametreler

pButton
[in] İşaretçi düğmesi.

İade Değeri

TRUE öğesini belirten düğmeden pButton son komut gönderildiyse; değilse FALSE.

Açıklamalar

Bu yöntem çağırarak CWnd::GetCurrentMessagebir MSG Yapı işaretçisi alır. Ardından düğmenin ve üyeleriyle MSG::lParamMSG::hwnd karşılaştırarak HWND düğmenin komutun kaynağı olup olmadığını belirler.

CMFCToolBar::IsLocked

Araç çubuğunun kilitli olup olmadığını belirler.

BOOL IsLocked() const;

İade Değeri

TRUE araç çubuğu kilitliyse; aksi takdirde , FALSE.

Açıklamalar

Bu yöntem, kullanıcı araç çubuğu düğmelerini yeniden konumlandırma gibi özelleştirme görevlerini gerçekleştiremediğinde döndürür TRUE .

Kilitli araç çubukları ayrı resim listeleri kullanır. Bu resim listeleri hakkında daha fazla bilgi için bkz CMFCToolBar::LoadBitmapEx. .

CMFCToolBar::IsOneRowWithSibling

Araç çubuğunun ve eşdüzey araç çubuğunun aynı satırda konumlandırılıp konumlandırılmayacağını belirler.

BOOL IsOneRowWithSibling();

İade Değeri

TRUE araç çubuğu ve eşdüzey öğe aynı satıra konumlandırıldıysa; aksi takdirde FALSE.

Açıklamalar

yöntemi, CMFCCustomizeButton::CreatePopupMenu Özelleştir açılır menüsünün nasıl gösterileceğini belirlemek için bu yöntemi çağırır. Bu yöntem döndürürseTRUE, çerçevede Düğmeleri Bir Satırda Göster düğmesi görüntülenir. Aksi takdirde, çerçeve İki Satırda Düğmeleri Göster düğmesini görüntüler.

Genellikle bu yöntemi kullanmanız gerekmez. Düğmeleri Bir Satırda Göster veya İki Satırda Düğmeleri Göster düğmelerini etkinleştirmek için öğesini çağırınCMFCToolBar::SetSiblingToolBar.

CMFCToolBar::IsResourceChanged

virtual BOOL IsResourceChanged() const;

İade Değeri

Açıklamalar

CMFCToolBar::IsSibling

BOOL IsSibling();

İade Değeri

Açıklamalar

CMFCToolBar::IsUserDefined

Araç çubuğunun kullanıcı tanımlı olup olmadığını belirtir.

BOOL IsUserDefined() const;

İade Değeri

TRUE araç çubuğu kullanıcı tarafından oluşturulduysa; aksi takdirde FALSE.

CMFCToolBar::LoadBitmap

Uygulama kaynaklarından araç çubuğu görüntülerini yükler.

virtual BOOL LoadBitmap(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parametreler

uiResID
[in] Sık erişimli araç çubuğu görüntülerine başvuran bit eşlemin kaynak kimliği.

uiColdResID
[in] Soğuk araç çubuğu görüntülerine başvuran bit eşlem kaynak kimliği.

uiMenuResID
[in] Normal menü görüntülerine başvuran bit eşlem kaynak kimliği.

bLocked
[in] TRUE araç çubuğunu kilitlemek için; aksi takdirde FALSE.

uiDisabledResID
[in] Devre dışı bırakılmış araç çubuğu görüntülerine başvuran bit eşlem kaynak kimliği.

uiMenuDisabledResID
[in] Devre dışı bırakılan menü görüntülerine başvuran bit eşlem kaynak kimliği.

İade Değeri

Yöntem başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

yöntemi, CMFCToolBar::LoadToolBarEx araç çubuğuyla ilişkili görüntüleri yüklemek için bu yöntemi çağırır. Görüntü kaynaklarının özel yüklemesini gerçekleştirmek için bu yöntemi geçersiz kılın.

LoadBitmapEx Araç çubuğunu oluşturduktan sonra ek görüntüleri yüklemek için yöntemini çağırın.

CMFCToolBar::LoadBitmapEx

virtual BOOL LoadBitmapEx(
    CMFCToolBarInfo& params,
    BOOL bLocked = FALSE);

Parametreler

[in] params
[in] bLocked\

İade Değeri

Açıklamalar

CMFCToolBar::LoadLargeIconsState

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

Parametreler

[in] lpszProfileName\

İade Değeri

Açıklamalar

CMFCToolBar::LoadParameters

Windows kayıt defterinden genel araç çubuğu seçeneklerini yükler.

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

Parametreler

lpszProfileName
[in] Windows kayıt defteri anahtarının göreli yolunu belirtir.

İade Değeri

Yöntem başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bu yöntem menü animasyon türü, menü gölge stili ve Windows kayıt defterinden büyük simgelerin görüntülenip görüntülenmeyeceği gibi genel parametreleri yükler.

yöntemi, CWinAppEx::LoadState uygulamanın başlatma işleminin bir parçası olarak bu yöntemi çağırır.

CMFCToolBar::LoadState

Windows kayıt defterinden araç çubuğu durum bilgilerini yükler.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parametreler

lpszProfileName
[in] Windows kayıt defteri anahtarının göreli yolunu belirtir.

nIndex
[in] Araç çubuğunun denetim kimliğini belirtir.

uiID
[in] Araç çubuğunun kaynak kimliğini belirtir.

İade Değeri

Yöntem başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Çerçeve, uygulamanın başlatma işleminin bir parçası olarak bu yöntemi çağırır. Daha fazla bilgi için bkz. CWinAppEx::LoadState.

CMFCToolBar::LoadToolBar

Araç çubuğunu uygulama kaynaklarından yükler.

virtual BOOL LoadToolBar(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0,
    UINT uiHotResID=0);

Parametreler

uiResID
[in] Araç çubuğunun kaynak kimliği.

uiColdResID
[in] Soğuk araç çubuğu görüntülerine başvuran bit eşlem kaynak kimliği.

uiMenuResID
[in] Normal menü görüntülerine başvuran bit eşlem kaynak kimliği.

bLocked
[in] Araç çubuğunun kilitli olup olmadığını belirten boole değeri. Bu parametre ise TRUE, araç çubuğu kilitlidir. Aksi takdirde araç çubuğu kilitli değildir.

uiDisabledResID
[in] Devre dışı bırakılmış araç çubuğu görüntülerine başvuran bit eşlem kaynak kimliği.

uiMenuDisabledResID
[in] Devre dışı bırakılan menü görüntülerine başvuran bit eşlem kaynak kimliği.

uiHotResID
[in] Sık erişimli araç çubuğu görüntülerine başvuran bit eşlemin kaynak kimliği.

İade Değeri

Yöntem başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Çerçeve, araç çubuğuyla ilişkili görüntüleri yüklemek için başlatma sırasında bu yöntemi çağırır.

Örnek

Aşağıdaki örnekte sınıfında yönteminin LoadToolBar nasıl kullanılacağı gösterilmektedir CMFCToolBar . Bu kod parçacığı, IE Tanıtım örneğinin bir parçasıdır.

CMFCToolBar m_wndToolBar;
// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

CMFCToolBar::LoadToolBarEx

Uygulamanın büyük görüntüler kullanmasını sağlamak için yardımcı sınıfını CMFCToolBarInfo kullanarak uygulama kaynaklarından araç çubuğunu yükler.

virtual BOOL LoadToolBarEx(
    UINT uiToolbarResID,
    CMFCToolBarInfo& params,
    BOOL bLocked=FALSE);

Parametreler

uiToolbarResID
[in] Araç çubuğunun kaynak kimliği.

params
[in] Araç çubuğu görüntülerinin kaynak kimliklerini içeren bir CMFCToolBarInfo nesneye başvuru.

bLocked
[in] Araç çubuğunun kilitli olup olmadığını belirten boole değeri. Bu parametre ise TRUE, araç çubuğu kilitlidir. Aksi takdirde araç çubuğu kilitli değildir.

İade Değeri

Yöntem başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Uygulama kaynaklarından araç çubuğu görüntülerini yüklemek için bu yöntemi çağırın.

CMFCToolBar::m_dblLargeImageRatio

Büyük resimlerin boyutu (yükseklik veya genişlik) ile normal görüntülerin boyutu arasındaki oranı belirtir.

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

Açıklamalar

Varsayılan oran 2'dir. Büyük araç çubuğu görüntülerini büyütmek veya küçültmek için bu değeri değiştirebilirsiniz.

Çerçeve, büyük görüntüler kümesi belirtmediğinizde bu veri üyesini kullanır. Örneğin, yalnızca boyutu 16x16 olan küçük görüntüler kümesi sağlar ve büyük görüntülerin boyutu 24x24 olmasını istiyorsanız, bu veri üyesini 1,5 olarak ayarlayın.

CMFCToolBar::NextMenu

virtual BOOL NextMenu();

İade Değeri

Açıklamalar

CMFCToolBar::OnBeforeRemoveButton

virtual BOOL OnBeforeRemoveButton(
    CMFCToolBarButton* pButton,
    DROPEFFECT dropEffect);

Parametreler

pButton
[in] Kullanılma -yan.

dropEffect
[in] Kullanılma -yan.

İade Değeri

Açıklamalar

CMFCToolBar::OnChangeHot

Kullanıcı araç çubuğunda bir düğme seçtiğinde çerçeve tarafından çağrılır.

virtual void OnChangeHot(int iHot);

Parametreler

iHot
[in] Seçili araç çubuğu düğmesinin dizinini belirtir; veya araç çubuğu düğmesi seçili değilse -1.

Açıklamalar

Kullanıcının araç çubuğunda bir düğme seçtiği bildirimleri işlemek için bu yöntemi geçersiz kılın.

CMFCToolBar::OnChangeVisualManager

virtual void OnChangeVisualManager();

Açıklamalar

CMFCToolBar::OnFillBackground

Araç çubuğunun arka planını doldurmak için framework CBasePane::DoPaint tarafından çağrılır.

virtual void OnFillBackground(CDC* pDC);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

Açıklamalar

CMFCToolBar::DoPaint araç çubuğunun arka planı doldurulduğunda bu yöntemi çağırır. Varsayılan uygulama hiçbir şey yapmaz.

Türetilmiş sınıflarda özel arka plan çizmek için bu yöntemi geçersiz kılın.

CMFCToolBar::OnGlobalFontsChanged

virtual void OnGlobalFontsChanged();

Açıklamalar

CMFCToolBar::OnReset

Araç çubuğunu özgün durumuna geri yükler.

virtual void OnReset();

Açıklamalar

Araç çubuğu sıfırlama bildirimini işlemek için bu yöntemi geçersiz kılın.

Varsayılan uygulama hiçbir şey yapmaz. Araç çubuğunun CMFCToolBar özgün durumuna döndüğünde değiştirilmesi gereken, araç çubuğundan türetilen bir sınıfta geçersiz kılmaOnReset.

CMFCToolBar::OnSetAccData

virtual BOOL OnSetAccData(long lVal);

Parametreler

[in] lVal\

İade Değeri

Açıklamalar

CMFCToolBar::OnSetDefaultButtonText

Araç çubuğu düğmesinin metnini varsayılan durumuna geri yükler.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parametreler

pButton
[in] Metni ayarlanan bir düğmeyi gösterir.

İade Değeri

TRUE metin başarıyla geri yüklendiyse; aksi takdirde FALSE.

Açıklamalar

Araç çubuğu düğmesinin metninin varsayılan olarak değiştirildiğine ilişkin bildirimleri işlemek için bu yöntemi geçersiz kılın.

Varsayılan uygulama, uygulama kaynaklarından bir düğmenin metnini yükler.

CMFCToolBar::OnUserToolTip

Bir düğmenin araç ipucu görüntülenmek üzereyken çerçeve tarafından çağrılır.

virtual BOOL OnUserToolTip(
    CMFCToolBarButton* pButton,
    CString& strTTText) const;

Parametreler

pButton
[in] Araç ipucu görüntülenecek araç çubuğu düğmesini gösterir.

strTTText
[out] CString Araç ipucu metnini alan nesne başvurusu.

İade Değeri

TRUE araç ipucu metniyle doldurulmuşsa strTTText ; değilse FALSE.

Açıklamalar

Bir araç çubuğu düğmesinin araç ipucu görüntülenmek üzereyken çerçeve bu yöntemi çağırır. döndürürseTRUEOnUserToolTip, çerçeve içinde tarafından OnUserToolTipstrTTTextdöndürülen metni içeren bir araç ipucu görüntüler. Aksi takdirde, araç ipucu düğme metnini içerir.

Araç çubuğu düğmelerinin araç ipuçlarını özelleştirmek için geçersiz kılın OnUserToolTip . Varsayılan uygulama, araç ipucu metnini almak için çağırır CMFCToolBar::OnUserToolTip .

CMFCToolBar::PrevMenu

virtual BOOL PrevMenu();

İade Değeri

Açıklamalar

CMFCToolBar::ProcessCommand

Araç çubuğunun sahibi olan pencereye bir WM_COMMAND ileti postalar.

BOOL ProcessCommand(CMFCToolBarButton* pButton);

Parametreler

pButton
[in] Araç çubuğundaki bir düğmenin işaretçisi.

İade Değeri

Bu yöntem her zaman döndürmelidir TRUE. MFC değerleri dahili olarak kullanır FALSE .

Açıklamalar

Bu yöntem, belirtilen düğmenin komut kimliğini çağırarak CWnd::PostMessage ve parametre olarak geçirerek araç çubuğunun sahibi olan pencereye wParam bir WM_COMMAND ileti gönderir.

İletiyi ON_COMMAND bir üye işlevine WM_COMMAND eşlemek için makroyu kullanın.

CMFCToolBar::RemoveAllButtons

Araç çubuğundaki tüm düğmeleri ve ayırıcıları kaldırır.

virtual void RemoveAllButtons();

Açıklamalar

Çerçeve, bir araç çubuğunu yeniden oluşturur veya yok ettiğinde bu yöntemi çağırır.

CMFCToolBar::RemoveButton

Araç çubuğundan belirtilen dizine sahip düğmeyi kaldırır.

virtual BOOL RemoveButton(int iIndex);

Parametreler

iIndex
[in] Kaldırılacak düğmenin sıfır tabanlı dizinini belirtir.

İade Değeri

TRUEyöntemi başarılı olursa veya FALSE belirtilen dizin geçersizse veya dizin Özelleştir düğmesine başvuruyorsa.

Açıklamalar

Bu yöntem, düğmenin kaldırılmasından etkilenen ek araç çubuğu özniteliklerini güncelleştirir. Örneğin, bu yöntem araç çubuğundan gereksiz ayırıcıları kaldırır ve kısayol tuşları tablosunu yeniden oluşturur.

Özelleştir düğmesi hakkında daha fazla bilgi için bkzCMFCToolBar::EnableCustomizeButton. .

CMFCToolBar::RemoveStateFromRegistry

Araç çubuğunun durum bilgilerini Windows kayıt defterinden siler.

virtual BOOL RemoveStateFromRegistry(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parametreler

lpszProfileName
[in] Durum bilgilerinin bulunduğu kayıt defteri anahtarını belirtir.

nIndex
[in] Araç çubuğunun denetim kimliği.

uiID
[in] Araç çubuğunun kaynak kimliği. Bu parametre -1 ise, bu yöntem kaynak kimliğini almak için yöntemini kullanır CWnd::GetDlgCtrlID .

İade Değeri

Yöntem başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Çerçeve, kullanıcı tanımlı bir araç çubuğunu sildiğinde bu yöntemi çağırır.

Windows kayıt defterinde ek durum bilgileri depolarsanız bu yöntemi geçersiz kılın.

CMFCToolBar::ReplaceButton

Araç çubuğu düğmesini başka bir araç çubuğu düğmesiyle değiştirir.

int ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button,
    BOOL bAll=FALSE);

Parametreler

uiCmd
[in] Değiştirilmeye değer düğmenin komut kimliği.

button
[in] Eklenecek öğesine CMFCToolBarButton başvuru.

bAll
[in] tarafından uiCmdbelirtilen komut kimliğine sahip tüm düğmelerin değiştirilip değiştirilmeyeceğini belirten boole değeri. Bu parametre ise TRUE, belirtilen komut kimliğine sahip tüm düğmeler değiştirilir. Aksi takdirde, ilk düğme değiştirilir.

İade Değeri

Değiştirilen düğme sayısı. Araç çubuğunda belirtilen komut kimliğine sahip bir düğme yoksa bu yöntem 0 döndürür.

Açıklamalar

Kaynaklardan yüklenemeyen araç çubuğu düğmeleri eklemek istediğinizde bu yöntemi çağırabilirsiniz. Tasarım zamanında bir yer tutucu düğmesi oluşturabilir ve araç çubuğunu başlattığınızda bu düğmeyi özel bir düğmeyle değiştirebilirsiniz. Bu yöntemi kullanan bir örnek için VisualStudioDemo örneğine bakın.

Örnek

Aşağıdaki örnekte sınıfında yönteminin ReplaceButton nasıl kullanılacağı gösterilmektedir CMFCToolBar . Bu kod parçacığı, IE Tanıtım örneğinin bir parçasıdır.

CMFCToolBar m_wndToolBar;
// CMenu menuHistory
// CString str
m_wndToolBar.ReplaceButton(ID_GO_BACK,
                           CMFCToolBarMenuButton(ID_GO_BACK, menuHistory,
                                                 GetCmdMgr()->GetCmdImage(ID_GO_BACK), str));

CMFCToolBar::ResetAll

Tüm araç çubuklarını özgün durumlarına geri yükler.

static void __stdcall ResetAll();

Açıklamalar

Bu yöntem, uygulamadaki geri yüklenebilen her araç çubuğunda yöntemini çağırır CMFCToolBar::RestoreOriginalState . Bir araç çubuğunun CMFCToolBar::CanBeRestored geri yüklenip yüklenemeyeceğini belirlemek için yöntemini kullanır.

CMFCToolBar::ResetAllImages

Uygulamadaki tüm araç çubuğu görüntü koleksiyonlarını temizler.

static void __stdcall ResetAllImages();

Açıklamalar

Bu yöntem, ve CMFCToolBar::LoadBitmap yöntemleri tarafından CMFCToolBar::LoadToolBar başlatılan görüntü koleksiyonlarını temizler.

CMFCToolBar::ResetImages

virtual void ResetImages();

Açıklamalar

CMFCToolBar::RestoreFocus

virtual void RestoreFocus();

Açıklamalar

CMFCToolBar::RestoreOriginalState

Bir araç çubuğunun özgün durumunu geri yükler.

virtual BOOL RestoreOriginalState();

İade Değeri

TRUE yöntemi başarılı olursa veya FALSE yöntem başarısız olursa veya araç çubuğu kullanıcı tanımlıysa.

Açıklamalar

Bu yöntem, yöntemini kullanarak CMFCToolBar::LoadToolBar kaynak dosyasından araç çubuğunu yükler.

Kullanıcı özelleştirme iletişim kutusunun Araç Çubukları sayfasında Tümünü Sıfırla düğmesini seçtiğinde çerçeve bu yöntemi çağırır.

CMFCToolBar::SaveParameters

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

Parametreler

[in] lpszProfileName\

İade Değeri

Açıklamalar

CMFCToolBar::SaveState

Araç çubuğunun durum bilgilerini Windows kayıt defterine kaydeder.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parametreler

lpszProfileName
[in] Windows kayıt defteri anahtarının göreli yolunu belirtir.

nIndex
[in] Araç çubuğunun denetim kimliği.

uiID
[in] Araç çubuğunun kaynak kimliği.

İade Değeri

Yöntem başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Çerçeve, uygulama durumunu kayıt defterine kaydettiğinde bu yöntemi çağırır. Daha fazla bilgi için bkz. CWinAppEx::SaveState.

CMFCToolBar::SetBasicCommands

Kullanıcı bir menüyü açtığında her zaman görüntülenen komutların listesini ayarlar.

static void __stdcall SetBasicCommands(CList<UINT,UINT>& lstCommands);

Parametreler

lstCommands
[in] Komut koleksiyonu içeren bir CList nesneye başvuru.

Açıklamalar

Menü açıldığında her zaman temel bir komut görüntülenir. Kullanıcı son kullanılan komutları görüntülemeyi seçtiğinde bu yöntem anlamlıdır.

CMFCToolBar::AddBasicCommand Temel komutlar listesine bir komut eklemek için yöntemini kullanın. CMFCToolBar::GetBasicCommands Uygulamanız tarafından kullanılan temel komutların listesini almak için yöntemini kullanın.

Bu yöntemi kullanan bir örnek için Gezgin örneğine bakın.

CMFCToolBar::SetButtonInfo

Araç çubuğu düğmesinin komut kimliğini, stilini ve görüntü kimliğini ayarlar.

void SetButtonInfo(
    int nIndex,
    UINT nID,
    UINT nStyle,
    int iImage);

Parametreler

nIndex
[in] Özellikleri ayarlanmış olan düğmenin sıfır tabanlı dizini.

nID
[in] Düğmenin komut kimliği.

nStyle
[in] Düğmenin stili. Kullanılabilir araç çubuğu düğmesi stillerinin listesi için bkz . Araç Çubuğu Denetim Stilleri .

iImage
[in] Düğmenin sıfır tabanlı görüntü dizini (yani araç çubuğu görüntüleri koleksiyonundaki dizin).

Açıklamalar

Araç çubuğu düğmesinin özelliklerini ayarlamak için bu yöntemi çağırın.

Hata ayıklama derlemelerinde, tarafından nIndex belirtilen dizin geçersizse bu yöntem bir onay hatası oluşturur.

CMFCToolBar::SetButtonStyle Yalnızca düğmenin stilini ayarlamak için yöntemini çağırın.

CMFCToolBar::SetButtons

Araç çubuğunun düğmelerini ayarlar.

virtual BOOL SetButtons(
    const UINT* lpIDArray,
    int nIDCount,
    BOOL bRemapImages=TRUE);

Parametreler

lpIDArray
[in] Eklenecek düğmelerin komut kimlikleri dizisinin işaretçisi.

nIDCount
[in] içindeki lpIDArrayöğe sayısı.

bRemapImages
[in] Mevcut düğme görüntülerinin eklenen düğmelerle ilişkilendirilip ilişkilendirmeyeceğini belirten boole değeri. Bu parametre ise TRUE, görüntüler yeniden eşlenir.

İade Değeri

Yöntem başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Araç çubuğundaki mevcut düğmeleri kaldırmak ve yeni düğme koleksiyonu eklemek için bu yöntemi çağırın.

Bu yöntem, Özelleştir düğmesini araç çubuğuna ekler ve iletiyi araç çubuğunun üst penceresine gönderirAFX_WM_RESETTOOLBAR. Özelleştir düğmesi hakkında daha fazla bilgi için bkzCMFCToolBar::EnableCustomizeButton. .

CMFCToolBar::SetButtonStyle

Belirtilen dizindeki araç çubuğu düğmesinin stilini ayarlar.

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Parametreler

nIndex
[in] Stili ayarlanacak araç çubuğu düğmesinin sıfır tabanlı dizini.

nStyle
[in] Düğmenin stili. Kullanılabilir araç çubuğu düğmesi stillerinin listesi için bkz . Araç Çubuğu Denetim Stilleri .

Açıklamalar

Kullanıcı devre dışı bir düğme seçemediği için bu TBBS_DISABLED yöntem stili nStyle kaldırırTBBS_PRESSED.

CMFCToolBar::SetButtonText

Araç çubuğu düğmesinin metin etiketini ayarlar.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Parametreler

nIndex
[in] Araç çubuğu düğmesinin dizini.

lpszText
[in] Araç çubuğu düğmesinin metin etiketi. Null olmayan bir değer olmalıdır.

İade Değeri

TRUE yöntem başarılı olursa; aksi takdirde FALSE.

Açıklamalar

Sağlanan dizin geçerli bir araç çubuğu düğmesine başvurmuyorsa bu yöntem döndürür FALSE .

CMFCToolBar::SetCommandUsageOptions

Nadiren kullanılan komutların uygulama menüsünde görünmediğini belirtir.

static BOOL SetCommandUsageOptions(
    UINT nStartCount,
    UINT nMinUsagePercentage=5);

Parametreler

nStartCount
[in] Çerçevenin yalnızca temel ve son kullanılan komutları göstermesi için komutların kaç kez yürütülmesi gerektiğini belirtir.

nMinUsagePercentage
[in] Bir komutun son kullanılan bir komut olarak kabul edilmesi için yürütülmesi gereken sürelerin yüzdesi.

İade Değeri

FALSE değeri 100'e eşit veya 100'den büyükse nMinUsagePercentage ; değilse TRUE.

Açıklamalar

Çerçevenin temel ve son kullanılan menü öğelerinin nasıl görüneceğini belirlemek için kullandığı algoritmayı özelleştirmek için bu yöntemi çağırın. Temel komutlar hakkında daha fazla bilgi için bkz CMFCToolBar::AddBasicCommand. .

Bu sınıf, komutların CMFCCmdUsageCount kullanım sayısını izlemek için sınıfını kullanır. Bu sınıf hakkında daha fazla bilgi için bkz CMFCCmdUsageCount . Sınıf.

CMFCToolBar::SetCustomizeMode

Uygulamadaki tüm araç çubukları için özelleştirme modunu etkinleştirir veya devre dışı bırakır.

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

Parametreler

bSet
[in] Özelleştirme modunun etkinleştirilip etkinleştirilmeymeyeceğini veya devre dışı bırakılıp bırakılmayacağını belirten boole değeri. Özelleştirme modunu etkinleştirmek veya FALSE devre dışı bırakmak için bu parametreyi TRUE olarak ayarlayın.

İade Değeri

TRUE bu yöntemin çağrılması özelleştirme modunu değiştirirse; aksi takdirde FALSE.

Açıklamalar

Bu yöntem, uygulamadaki her araç çubuğunun düzenini ayarlar ve yeniden çizer. CMFCToolBar::IsCustomizeMode Uygulamanın özelleştirme modunda olup olmadığını belirlemek için yöntemini çağırın,

CMFCToolBar::SetGrayDisabledButtons

Araç çubuğundaki kullanılamayan düğmelerin soluk olup olmadığını veya düğme kullanılamayan görüntülerin kullanılıp kullanılmayacağını belirtir.

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

Parametreler

bGrayDisabledButtons
[in] Kullanılamayan düğmelerin nasıl görüntüleneceğini belirten Boole değeri. Bu parametre ise TRUE, çerçeve düğmeleri karartır. Aksi takdirde, çerçeve düğme kullanılamayan görüntüler koleksiyonunu kullanır.

Açıklamalar

Varsayılan olarak, kullanılamayan düğmeler soluk görünür.

CMFCToolBar::SetHeight

Araç çubuğunun yüksekliğini ayarlar.

void SetHeight(int cyHeight);

Parametreler

cyHeight
[in] Araç çubuğunun piksel cinsinden yüksekliği.

Açıklamalar

Bu yöntem, yüksekliği ayarladıktan sonra araç çubuğunu yeniden çizer.

CMFCToolBar::SetHelpMode

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

Parametreler

[in] bOn\

Açıklamalar

CMFCToolBar::SetHot

BOOL SetHot(CMFCToolBarButton* pMenuButton);

Parametreler

[in] pMenuButton\

İade Değeri

Açıklamalar

CMFCToolBar::SetHotBorder

Araç çubuğu düğmelerinin etkin izlenip izlenmeyeceğini belirtir.

void SetHotBorder(BOOL bShowHotBorder);

Parametreler

bShowHotBorder
[in] Araç çubuğu düğmelerinin çalışırken izlenip izlenmeyeceğini belirten boole değeri. Bu parametre ise TRUE, araç çubuğu düğmelerini etkin olarak izler. Aksi takdirde, araç çubuğu düğmelerini etkin izlemez.

Açıklamalar

Bir düğme çalışırken izleniyorsa, fare üzerinde hareket ettiğinde çerçeve düğmeyi vurgular. Varsayılan olarak, her araç çubuğu düğmelerini etkin olarak izler.

Araç çubuğunun CMFCToolBar::GetHotBorder düğmelerini etkin olarak kullanıp izlemediğini belirlemek için yöntemini çağırın.

CMFCToolBar::SetHotTextColor

Kısayol araç çubuğu düğmeleri için metin rengini ayarlar.

static void SetHotTextColor(COLORREF clrText);

Parametreler

clrText
[in] Sık izlenen araç çubuğu düğmeleri için metin rengini belirtir.

Açıklamalar

Sık izlenen araç çubuğu düğmeleri hakkında daha fazla bilgi için bkz CMFCToolBar::GetHotBorder . ve CMFCToolBar::SetHotBorder.

CMFCToolBar::SetIgnoreSetText

void SetIgnoreSetText(BOOL bValue);

Parametreler

[in] bValue\

Açıklamalar

CMFCToolBar::SetLargeIcons

Araç çubuğu düğmelerinin büyük simgeler görüntüleyip görüntülemeyeceğini belirtir.

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

Parametreler

bLargeIcons
[in] Hangi simgelerin kullanılacağını belirten Boole değeri. Bu parametre ise TRUE, çerçeve büyük simgeler görüntüler. Aksi takdirde, çerçeve normal simgeler görüntüler.

Açıklamalar

Kullanıcı Özelleştir iletişim kutusunun Seçenekler sekmesindeki Büyük Simgeler onay kutusunun durumunu değiştirdiğinde çerçeve bu yöntemi çağırır. Bu yöntem, uygulamadaki tüm araç çubuklarını yeniden boyutlandırıyor.

Varsayılan olarak, çerçeve normal simgeleri görüntüler.

Özelleştir iletişim kutusu hakkında daha fazla bilgi için bkzCMFCToolBarsCustomizeDialog. Sınıf.

CMFCToolBar::SetLockedSizes

Araç çubuğundaki kilitli düğmelerin ve kilitli görüntülerin boyutlarını ayarlar.

void SetLockedSizes(
    SIZE sizeButton,
    SIZE sizeImage,
    BOOL bDontScale = FALSE);

Parametreler

sizeButton
[in] Kilitli araç çubuğu düğmelerinin boyutunu belirtir.

sizeImage
[in] Kilitli araç çubuğu görüntülerinin boyutunu belirtir.

bDontScale
Yüksek DPI modunda kilitli araç çubuğu görüntülerinin ölçeklendirilip ölçeklendirilmeyeceğini belirtir.

Açıklamalar

Kilitli düğmelerin varsayılan boyutu 23x22 pikseldir. Kilitli görüntülerin varsayılan boyutu 16x15 pikseldir.

Kilitli görüntülerin CMFCToolBar::GetLockedImageSize boyutunu almak için yöntemini çağırın. CMFCToolBar::GetButtonSize Kilitli araç çubuğu düğmelerinin boyutunu almak için yöntemini çağırın.

CMFCToolBar::SetMaskMode

void SetMaskMode(BOOL bMasked);

Parametreler

[in] bMasked\

Açıklamalar

CMFCToolBar::SetMenuSizes

Araç çubuğu menü düğmelerinin ve görüntülerinin boyutunu ayarlar.

static void __stdcall SetMenuSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parametreler

sizeButton
[in] Araç çubuğu düğmelerinin boyutunu piksel cinsinden belirtir.

sizeImage
[in] Araç çubuğu görüntülerinin boyutunu piksel cinsinden belirtir.

Açıklamalar

Varsayılan olarak, menü düğmeleri ve resimleri tanımsız bir boyuta sahiptir.

Menü düğmelerinin CMFCToolBar::GetMenuButtonSize boyutunu belirlemek için yöntemini ve CMFCToolBar::GetMenuImageSize menü düğmesi görüntülerinin boyutunu belirlemek için yöntemini çağırın.

Bu yöntemi kullanan örnekler için IEDemo ve MSMoneyDemo örneklerine bakın.

CMFCToolBar::SetNonPermittedCommands

Kullanıcı tarafından yürütülemeyen komutların listesini ayarlar.

static void SetNonPermittedCommands(CList<UINT,UINT>& lstCommands);

Parametreler

lstCommands
[in] Kullanıcı tarafından yürütülemeyen komutları içeren bir CList nesneye başvuru.

Açıklamalar

Kullanıcının belirli komutları seçmesini önlemek için bu yöntemi çağırın. Örneğin, güvenlik nedeniyle kullanıcının belirli komutları seçmesini engellemek isteyebilirsiniz. Bu yöntemi kullanan örnekler için MDITabsDemo ve MenuSubSet örneklerine bakın.

Bu yöntem, izin verilemeyen komutların önceki listesini temizler. Varsayılan olarak, izin verilemeyen komutların listesi boş olur.

CMFCToolBar::SetOneRowWithSibling

Araç çubuğunu ve eşdüzeyini aynı satıra konumlandırın.

void SetOneRowWithSibling();

Açıklamalar

Kullanıcı Bir Satırda Düğmeleri Göster düğmesini seçtiğinde çerçeve bu yöntemi çağırır.

Bir Satırdaki CMFCToolBar::SetSiblingToolBar Düğmeleri Göster veya İki Satırdaki Düğmeleri Göster düğmelerini etkinleştirmek için yöntemini çağırın. Bu araç çubuğunu çağırırsanız CMFCToolBar::SetSiblingToolBar , eşdüzey araç çubuğu bu araç çubuğunun satırına taşınır. Aksi takdirde, bu araç çubuğu eşdüzey satıra taşınır.

Kullanıcı İki Satırda CMFCToolBar::SetTwoRowsWithSibling Düğmeleri Göster düğmesini seçtiğinde çerçeve yöntemini çağırır.

CMFCToolBar::SetOrigButtons

void SetOrigButtons(const CObList& lstOrigButtons);

Parametreler

[in] lstOrigButtons\

Açıklamalar

CMFCToolBar::SetPermament

Bir kullanıcının araç çubuğunu kapatıp kapatamayacağını belirtir.

void SetPermament(BOOL bPermament=TRUE);

Parametreler

bPermament
[in] Kullanıcının araç çubuğunu kapatıp kapatamayacağını belirten Boole değeri. Bu parametre ise TRUE, kullanıcı araç çubuğunu kapatamaz. Aksi takdirde, kullanıcı araç çubuğunu kapatabilir.

Açıklamalar

Varsayılan olarak, bir kullanıcı her araç çubuğunu kapatabilir.

CMFCToolBar::CanBeClosed Bir kullanıcının araç çubuğunu kapatıp kapatamayacağını belirlemek için yöntemini çağırın.

CMFCToolBar::SetRouteCommandsViaFrame

Üst çerçevenin veya sahibin araç çubuğuna komut gönderip göndermediğini belirtir.

void SetRouteCommandsViaFrame(BOOL bValue);

Parametreler

bValue
[in] Bu parametre ise TRUE, üst çerçeve komutları araç çubuğuna gönderir. Aksi takdirde, sahip araç çubuğuna komutlar gönderir.

Açıklamalar

Varsayılan olarak, üst çerçeve komutları araç çubuğuna gönderir. Üst çerçevenin CMFCToolBar::GetRouteCommandsViaFrame veya sahibin araç çubuğuna komut gönderip göndermediğini belirlemek için yöntemini çağırın.

CMFCToolBar::SetShowTooltips

Çerçevenin araç ipuçlarını görüntüleyip görüntülemeyeceğini belirtir.

static void SetShowTooltips(BOOL bValue);

Parametreler

bValue
[in] Bu parametre ise TRUE, çerçeve araç ipuçlarını gösterir. Aksi takdirde, çerçeve araç ipuçlarını gizler.

Açıklamalar

Çerçeve varsayılan olarak araç ipuçlarını gösterir.

Çerçevenin CMFCToolBar::GetShowTooltips araç ipuçlarını gösterip göstermeyeceğini belirlemek için yöntemini çağırın.

CMFCToolBar::SetSiblingToolBar

Araç çubuğunun eşdüzeyini belirtir.

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

Parametreler

pBrotherToolbar
[in] Eşdüzey araç çubuğunun işaretçisi.

Açıklamalar

Bu yöntem, kullanıcı Özelleştir açılır menüsünü görüntülediğinde gösterilen Bir Satırdaki Düğmeleri Göster veya İki Satırdaki Düğmeleri Göster düğmelerini etkinleştirir. Kullanıcının ilgili araç çubuklarının aynı satırda mı yoksa farklı satırlarda mı görüneceğini belirtmesini sağlamak istediğinizde bu yöntemi çağırın.

Araç çubuğunda görüntülenen Özelleştir düğmesini etkinleştirdikten sonra bu yöntemi çağırın. Özelleştir düğmesini etkinleştirmek için yöntemini çağırınCMFCToolBar::EnableCustomizeButton.

Bir araç çubuğunun eşdüzeyini almak için öğesini çağırın CMFCToolBar::GetSiblingToolBar.

CMFCToolBar::SetSizes

Tüm araç çubuklarındaki düğmelerin ve görüntülerin boyutlarını belirtir.

static void __stdcall SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parametreler

sizeButton
[in] Araç çubuğu düğmelerinin piksel cinsinden boyutu.

sizeImage
[in] Araç çubuğu düğme görüntülerinin piksel cinsinden boyutu.

Açıklamalar

Araç çubuğu düğmelerinin varsayılan boyutu 23x22 pikseldir. Araç çubuğu düğme görüntülerinin varsayılan boyutu 16x15 pikseldir.

CMFCToolBar::GetImageSize Araç çubuğu düğme görüntülerinin boyutunu almak için yöntemini çağırın. Araç çubuğu düğmelerinin CMFCToolBar::GetButtonSize boyutunu almak için yöntemini çağırın.

CMFCToolBar::SetToolBarBtnText

Araç çubuğundaki bir düğmenin özelliklerini belirtir.

void SetToolBarBtnText(
    UINT nBtnIndex,
    LPCTSTR szText=NULL,
    BOOL bShowText=TRUE,
    BOOL bShowImage=TRUE);

Parametreler

nBtnIndex
[in] Araç çubuğu düğmeleri listesindeki araç çubuğu düğmesinin sıfır tabanlı dizini.

szText
[in] Araç çubuğu düğmesinin metin etiketini belirtir.

bShowText
[in] Bu parametre ise TRUE, çerçeve metin etiketini gösterir. Aksi takdirde, çerçeve metin etiketini gizler.

bShowImage
[in] Bu parametre ise TRUE, çerçeve araç çubuğu düğme görüntüsünü gösterir. Aksi takdirde, çerçeve araç çubuğu düğme görüntüsünü gizler.

Açıklamalar

Varsayılan olarak, çerçeve araç çubuğu düğmelerinin görüntülerini gösterir ancak araç çubuğu düğmelerinin metin etiketini göstermez.

Hata ayıklama derlemelerinde, geçerli bir araç çubuğu düğmesine başvurmazsa veya araç çubuğu düğmesi bir ayırıcıysa nBtnIndex bu yöntem onay hatası oluşturur.

CMFCToolBar::SetTwoRowsWithSibling

Araç çubuğunu ve eşdüzeyini ayrı satırlara yerleştirir.

void SetTwoRowsWithSibling();

Açıklamalar

Kullanıcı İki Satırda Düğmeleri Göster düğmesini seçtiğinde çerçeve bu yöntemi çağırır.

Bir Satırdaki CMFCToolBar::SetSiblingToolBar Düğmeleri Göster veya İki Satırdaki Düğmeleri Göster düğmelerini etkinleştirmek için yöntemini çağırın. Bu araç çubuğunu çağırırsanız CMFCToolBar::SetSiblingToolBar , eşdüzey araç çubuğu ayrı bir satıra taşınır. Aksi takdirde, bu araç çubuğu ayrı bir satıra taşınır.

Kullanıcı Bir Satırda CMFCToolBar::SetOneRowWithSibling Düğmeleri Göster düğmesini seçtiğinde çerçeve yöntemini çağırır.

CMFCToolBar::SetUserImages

Uygulamadaki kullanıcı tanımlı görüntülerin koleksiyonunu ayarlar.

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

Parametreler

pUserImages
[in] Kullanıcı tanımlı görüntülerin koleksiyonunun işaretçisi.

İade Değeri

Yöntem başarılı olursa sıfır olmayan; aksi takdirde, belirtilen CMFCToolBarImages nesne geçerli değilse veya araç çubuğunun varsayılan görüntü boyutundan farklı bir görüntü boyutuna sahipse 0.

Açıklamalar

Çerçeve, kullanıcı tarafından özelleştirilmiş araç çubuğu düğmeleri çizmek için kullanıcı tanımlı görüntüler kullanır. tarafından pUserImages belirtilen görüntü listesi, uygulamadaki tüm araç çubukları arasında paylaşılır.

Bu yöntem, belirtilen CMFCToolBarImages nesne geçerli değilse veya araç çubuğunun varsayılan görüntü boyutundan farklı bir görüntü boyutuna sahipse Hata ayıklama derlemelerinde onay hatası oluşturur.

OutlookDemo, ToolTipDemo ve VisualStudioDemo örnekleri, kullanıcı tanımlı görüntülerin genel koleksiyonunu ayarlamak için bu yöntemi kullanır. Uygulamanın çalışma dizininde bulunan UserImages.bmp adlı dosyayı yükler.

Uygulamadaki kullanıcı tanımlı görüntülerin koleksiyonunu almak için 'CMFCToolBar::GetUserImages yöntemini çağırın.

CMFCToolBar::StretchPane

Araç çubuğunu dikey veya yatay olarak uzatır ve gerekirse düğmeleri yeniden konumlandırır.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parametreler

nLength
[in] Bölmenin genişletildiği piksel cinsinden tutar.

bVert
[in] ise TRUE, bölmeyi dikey olarak uzatır. ise FALSE, bölmeyi yatay olarak uzatır.

İade Değeri

CSize Araç çubuğu istemci alanının boyutunu belirten nesne.

Açıklamalar

Bu yöntem, esnetilmiş araç çubuğundaki düğmeleri yeniden konumlandırmak için çağırır CMFCToolBar::WrapToolBar .

Dönüş değeri çağrılarak CMFCToolBar::CalcSizebelirlenir.

CMFCToolBar::TranslateChar

Belirtilen tuş kodu geçerli bir klavye kısayoluna karşılık geliyorsa bir düğme komutu yürütür.

virtual BOOL TranslateChar(UINT nChar);

Parametreler

nChar
[in] Bir sanal anahtar kodu belirtir. Standart sanal anahtar kodlarının listesi için bkz. Winuser.h

İade Değeri

FALSE belirtilen tuş kodu yazdırılamazsa veya geçerli bir klavye kısayoluyla eşleşmiyorsa; TRUE belirtilen anahtar kodu bir açılan menü seçeneğine karşılık geliyorsa; değilse, değerinden CMFCToolBar::ProcessCommanddönüş değeri.

Açıklamalar

Alt tuşuyla birlikte bir tuşa basıldığında çerçeve bu yöntemi çağırır.

CMFCToolBar::UpdateButton

Belirtilen düğmenin durumunu Güncelleştirmeler.

void UpdateButton(int nIndex);

Parametreler

nIndex
[in] Güncelleştirilecek düğmenin sıfır tabanlı dizinini belirtir.

Açıklamalar

CMFCToolBar::WrapToolBar

Araç çubuğu düğmelerini verilen boyutlar içinde yeniden konumlandırır.

int WrapToolBar(
    int nWidth,
    int nHeight = 32767,
    CDC* pDC = NULL,
    int nColumnWidth = -1,
    int nRowHeight = -1);

Parametreler

nWidth
[in] Araç çubuğunun en büyük genişliği.

nHeight
[in] Araç çubuğunun en yüksek yüksekliği. Araç çubuğu kayan ise kullanılmaz.

pDC
[in] Cihaz bağlamı işaretçisi. ise NULL, araç çubuğunun cihaz bağlamı kullanılır.

nColumnWidth
[in] Düğme genişliği. -1 ise, geçerli genişlik kullanılır.

[in] mnRowHeight Düğme yüksekliği. -1 ise, geçerli yükseklik kullanılır.

İade Değeri

Araç çubuğundaki düğme satırlarının sayısı.

Açıklamalar

Bu yöntem, gerekirse düğmeleri ek satırlara kaydırarak araç çubuğundaki düğmeleri yeniden konumlandırır.

CMFCToolBar::m_bDontScaleImages

Araç çubuğu görüntülerinin yüksek DPI modunda ölçeklendirilip ölçeklendirilmeyeceğini belirtir. TRUE Görüntü boyutu bir düğme boyutuyla eşleşmediğinde görüntü ölçeklendirmesini önlemek için olarak ayarlayın.

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CMFCMenuBar Sınıfı
CMFCPopupMenuBar Sınıfı
CMFCDropDownToolBar Sınıfı
İzlenecek yol: Araç Çubuklarına Denetimler Yerleştirme