CToolBarCtrl sınıfı

Makale
02/26/2013

Windows araç çubuğu sık kullanılan denetim işlevlerini sunar.

class CToolBarCtrl : public CWnd

Üyeler

Ortak Oluşturucusu

Ad	Description
CToolBarCtrl::CToolBarCtrl	Yapıları bir CToolBarCtrl nesnesi.

Public yöntemler

Ad	Description
CToolBarCtrl::AddBitmap	Bir veya daha fazla bit eşlem düğme resimlerini araç çubuğu denetimi için düğme resimlerini listesine ekler.
CToolBarCtrl::AddButtons	Bir veya daha fazla düğmeleri bir araç çubuğu denetimi ekler.
CToolBarCtrl::AddString	Araç çubuğunun iç dizgi listesi için bir kaynak kimliği olarak geçen yeni bir dize ekler.
CToolBarCtrl::AddStrings	Yeni bir dize veya arabellek null ayrılmış dizeler, araç çubuğunun iç dizgi listesi için işaretçi olarak geçirilen dizeleri ekler.
CToolBarCtrl::AutoSize	Araç çubuğu denetimi yeniden boyutlandırır.
CToolBarCtrl::ChangeBitmap	Bit eşlem için geçerli araç çubuğu denetimi içindeki bir düğmeyi değiştirir.
CToolBarCtrl::CheckButton	Belirli bir düğme araç çubuğu denetimi temizler veya bakar.
CToolBarCtrl::CommandToIndex	Belirtilen komut tanımlayıcısı ile ilişkili düğme için sıfır tabanlı bir dizin alır.
CToolBarCtrl::Create	Araç çubuğu denetimi oluşturur ve ekler bir CToolBarCtrl nesnesi.
CToolBarCtrl::CreateEx	Belirtilen Windows genişletilmiş stilleri içeren bir araç çubuğu denetimi oluşturur ve ekler bir CToolBarCtrl nesnesi.
CToolBarCtrl::Customize	Araç çubuğunu Özelleştir iletişim kutusunu görüntüler.
CToolBarCtrl::DeleteButton	Bir düğme araç çubuğu denetimden siler.
CToolBarCtrl::EnableButton	Etkinleştirir veya belirtilen bir araç çubuğu denetimi düğmesini devre dışı bırakır.
CToolBarCtrl::GetAnchorHighlight	Ayarlama için bir araç çubuğu bağlantı vurgulama alır.
CToolBarCtrl::GetBitmap	Bir araç çubuğunda bir düğme ile ilişkili bitmap dizin alır.
CToolBarCtrl::GetBitmapFlags	Araç çubuğunun bitmaple ilişkilendirilmiş bayrakları alır.
CToolBarCtrl::GetButton	Belirtilen düğmeyi araç çubuğu denetimi hakkında bilgi alır.
CToolBarCtrl::GetButtonCount	Düğmeleri araç çubuğu denetimdeki geçerli sayısını alır.
CToolBarCtrl::GetButtonInfo	Bir araç çubuğu düğmesi için bilgileri alır.
CToolBarCtrl::GetButtonSize	Geçerli genişlik ve yüksekliği piksel cinsinden araç çubuğu düğmeleri alır.
CToolBarCtrl::GetColorScheme	Geçerli araç çubuğu denetimi renk düzenini alır.
CToolBarCtrl::GetDisabledImageList	Devre dışı görüntü düğmeleri araç çubuğu denetimi kullanan görüntü listesini alır.
CToolBarCtrl::GetDropTarget	Alır IDropTarget araç çubuğu denetimi arabirimi.
CToolBarCtrl::GetExtendedStyle	Araç çubuğu denetimi için genişletilmiş stillerini alır.
CToolBarCtrl::GetHotImageList	Araç çubuğu denetimi "etkin" olan düğmeleri göstermek için kullandığı resim listesi alır. Fare işaretçisini üzerinde olduğunda sıcak düğmesi vurgulanmış olarak görünür.
CToolBarCtrl::GetHotItem	Bir araç çubuğu, en sık kullanılan öğenin dizini alır.
CToolBarCtrl::GetImageList	Varsayılan durumlarına düğmeleri görüntülemek için araç çubuğu denetimi kullanan görüntü listesini alır.
CToolBarCtrl::GetInsertMark	Geçerli araç çubuğu ekleme işaretini alır.
CToolBarCtrl::GetInsertMarkColor	Ekleme işareti araç çubuğu çizmek için kullanılan rengi alır.
CToolBarCtrl::GetItemRect	Bir araç çubuğu denetimi düğmesini çevreleyen dikdörtgenin alır.
CToolBarCtrl::GetMaxSize	Tüm görünür düğmeleri ve araç çubuğunda ayırıcı toplam boyutunu alır.
CToolBarCtrl::GetMaxTextRows	En fazla araç çubuğunda görüntülenen metni satır sayısını alır.
CToolBarCtrl::GetMetrics	Araç çubuğu denetimi ölçümlerini alır.
CToolBarCtrl::GetPadding	Geçerli araç çubuğu denetimi yatay ve dikey doldurma alır.
CToolBarCtrl::GetPressedImageList	Basılı durumdaki düğmeleri göstermek için geçerli araç çubuğu denetimi kullanan görüntü listesini alır.
CToolBarCtrl::GetRect	Belirtilen araç çubuğu düğmesi için sınırlayıcı dikdörtgeni alır.
CToolBarCtrl::GetRows	Düğmeleri araç çubuğunda görüntülenen satır sayısını alır.
CToolBarCtrl::GetState	Olup o ayar etkinleştirilmiş, basılı, işaretli veya gibi bir araç çubuğu denetimi, belirtilen düğmeyi durumuyla ilgili bilgileri alır.
CToolBarCtrl::GetString	Araç dizesini alır.
CToolBarCtrl::GetStyle	Kullanılan stilleri şu anda araç çubuğu denetimi için alır.
CToolBarCtrl::GetToolTips	Araç İpucu denetim tutamacı, fırsatla ilişkili, araç çubuğu denetimi ile alır.
CToolBarCtrl::HideButton	Gizler veya belirtilen düğmeyi bir araç çubuğu denetimi gösterir.
CToolBarCtrl::HitTest	Burada bir noktayı bir araç çubuğu denetimi yatmaktadır belirler.
CToolBarCtrl::Indeterminate	Ayarlar veya belirtilen düğmeyi araç çubuğu denetimi (gri) belirsiz durumunu temizler.
CToolBarCtrl::InsertButton	Bir düğme araç çubuğu denetimi ekler.
CToolBarCtrl::InsertMarkHitTest	Bir araç çubuğunda bir nokta ekleme işareti bilgileri alır.
CToolBarCtrl::IsButtonChecked	Belirtilen araç çubuğu denetimi düğmesi işaretli olup olmadığını söyler.
CToolBarCtrl::IsButtonEnabled	Belirtilen düğmeyi araç çubuğu denetiminin etkinleştirilip etkinleştirilmeyeceğini belirtir.
CToolBarCtrl::IsButtonHidden	Araç çubuğu denetimi, belirtilen düğmeyi gizli olup olmadığını söyler.
CToolBarCtrl::IsButtonHighlighted	Araç çubuğu düğmesi vurgu durumunu denetler.
CToolBarCtrl::IsButtonIndeterminate	Araç çubuğu denetimi, belirtilen düğmeyi durumu belirsiz (gri) olup olmadığını söyler.
CToolBarCtrl::IsButtonPressed	Araç çubuğu denetimi, belirtilen düğmeyi basılı olup olmadığını söyler.
CToolBarCtrl::LoadImages	Bit eşlemler, bir araç çubuğunu denetimin görüntü listesine yükler.
CToolBarCtrl::MapAccelerator	Bir araç çubuğu düğmesinden Hızlandırıcı karakteri eşleştirir.
CToolBarCtrl::MarkButton	Bir araç çubuğu denetimi belirli bir düğmenin vurgu durumunu ayarlar.
CToolBarCtrl::MoveButton	Bir düğmeyi bir dizinden diğerine taşır.
CToolBarCtrl::PressButton	Tuşuna bastığında veya araç çubuğu denetimi, belirtilen düğmeyi serbest bırakır.
CToolBarCtrl::ReplaceBitmap	Varolan bir bit eşlemi, geçerli araç çubuğu denetimi ile yeni bir bitmap yerini alır.
CToolBarCtrl::RestoreState	Toolbar denetiminin durumunu geri yükler.
CToolBarCtrl::SaveState	Toolbar denetiminin durumunu kaydeder.
CToolBarCtrl::SetAnchorHighlight	Ayarlama için bir araç çubuğu bağlantı vurgulama ayarlar.
CToolBarCtrl::SetBitmapSize	Bir araç çubuğu denetimi eklenmesi için bit eşlemli görüntülerin boyutunu ayarlar.
CToolBarCtrl::SetButtonInfo	Bilgi için varolan bir düğmeyi araç çubuğu ayarlar.
CToolBarCtrl::SetButtonSize	Bir araç çubuğu denetimi eklenecek düğmelerin boyutunu ayarlar.
CToolBarCtrl::SetButtonStructSize	Boyutunu belirtir TBBUTTON yapısı.
CToolBarCtrl::SetButtonWidth	Toolbar denetiminin minimum ve maksimum düğme genişliğini ayarlar.
CToolBarCtrl::SetCmdID	Belirtilen düğmesine basıldığında sahip pencereyi gönderilmek üzere komut tanımlayıcısı ayarlar.
CToolBarCtrl::SetColorScheme	Geçerli araç çubuğu denetimi renk düzenini ayarlar.
CToolBarCtrl::SetDisabledImageList	Devre dışı görüntü düğmeleri araç çubuğu denetimi kullanan görüntü listesini ayarlar.
CToolBarCtrl::SetDrawTextFlags	Win32 işlevinde bayrakları ayarlar DrawText, hangi bayrakları nasıl ayarlanacağını göre biçimlendirilmiş belirtilen dikdörtgenin içindeki metni çizmek için kullanılır.
CToolBarCtrl::SetExtendedStyle	Genişletilmiş Stil araç çubuğu denetimi için ayarlar.
CToolBarCtrl::SetHotImageList	Araç çubuğu denetimi "etkin" düğmeleri görüntülemek için kullanacağı görüntü listesini ayarlar.
CToolBarCtrl::SetHotItem	En sık kullanılan öğeyi bir araç olarak ayarlar.
CToolBarCtrl::SetImageList	Araç çubuğunun varsayılan durumlarına olan düğmeleri göstermek için kullanacağı görüntü listesini ayarlar.
CToolBarCtrl::SetIndent	Bir araç çubuğu denetimi ilk düğmeyi girintisini ayarlar.
CToolBarCtrl::SetInsertMark	Geçerli ekleme işareti araç için ayarlar.
CToolBarCtrl::SetInsertMarkColor	Ekleme işareti araç çubuğu çizmek için kullanılan rengi ayarlar.
CToolBarCtrl::SetMaxTextRows	Araç çubuğunda görüntülenen metni satır sayısının üst sınırını ayarlar.
CToolBarCtrl::SetMetrics	Araç çubuğu denetimi ölçümlerini ayarlar.
CToolBarCtrl::SetOwner	Pencere araç çubuğu denetiminin bildirim iletilerini almak için ayarlar.
CToolBarCtrl::SetPadding	Geçerli araç çubuğu denetimi yatay ve dikey doldurma ayarlar.
CToolBarCtrl::SetPressedImageList	Basılı durumdaki düğmeleri göstermek için geçerli araç çubuğu denetimi kullanan görüntü listesini ayarlar.
CToolBarCtrl::SetRows	Düğmeleri araç çubuğunda görüntülenen satır sayısı ayarlar.
CToolBarCtrl::SetState	Bir araç çubuğu denetimi belirtilen düğme durumuna ayarlar.
CToolBarCtrl::SetStyle	Araç çubuğu denetimi için stiller belirler.
CToolBarCtrl::SetToolTips	Araç İpucu Denetim araç çubuğu denetimi ile ilişkilendirir.
CToolBarCtrl::SetWindowTheme	Toolbar denetiminin görsel stilini ayarlar.

Notlar

Bu denetim (ve bu nedenle CToolBarCtrl class) sonraki ve yalnızca Windows 95/98 ve Windows NT sürüm 3.51 altında çalışan programlar için kullanılabilir.

Windows araç çubuğu sık kullanılan bir veya daha fazla düğme içeren dikdörtgen alt pencere denetimdir. Bu düğmeleri bir bitmap görüntüsü, bir dize veya her ikisini de görüntüleyebilirsiniz. Kullanıcı bir düğmeyi seçtiğinde, araç çubuğunun sahibi penceresine bir komut iletisi gönderir. Genellikle, bir araç çubuğu düğmeleri uygulamanın menü öğelerine karşılık gelir; Kullanıcı bir uygulamanın komutlara erişmek için daha doğrudan bir yol sağlarlar.

CToolBarCtrlnesneleri birkaç önemli iç veri yapılarını içerir: düğme resmi bit eşlem listesi veya resim listesi, bir düğme etiketi dizgi listesi ve bir listesini TBBUTTON görüntüyü ilişkilendirmek ve/veya string position stil, yapıları durumu ve komut düğmesinin kimliği. Bu veri yapıları öğelerinin her sıfır tabanlı Index ile adlandırılır. Kullanabilmeniz için önce bir CToolBarCtrl nesnesi, bu veri yapıları ayarlamanız gerekir. Dizgi listesi yalnızca düğme etiketleri için kullanılabilir; araç çubuğundan dizesi alınamıyor.

Kullanmak için bir CToolBarCtrl nesne size genellikle aşağıdaki adımları izleyin:

Yapılandırma CToolBarCtrl nesnesi.
Call Create Windows araç çubuğu sık kullanılan denetim oluşturmak ve ona eklemek için CToolBarCtrl nesnesi. Stiller, aşağıdaki gibi kullanarak araç çubuğu stilini belirtmek tbstyle_transparent için saydam bir araç çubuğu veya tbstyle_dropdown açılan stil düğmelerini destekleyen bir araç için.
Görüntülenen araç çubuğundaki düğmelerin nasıl istediğinizi tanımlayın:
- Bitmap görüntüler için düğmeleri kullanmak için düğme bit eşlemler araç çubuğuna çağırarak eklemek AddBitmap.
- Düğme için bir görüntü listesinden görüntülenen görüntüleri kullanmak için resim listesi çağırarak belirtmek SetImageList, SetHotImageList, ya da SetDisabledImageList.
- Dize etiketleri için düğmeleri kullanmak için dizeleri araç çubuğuna çağırarak eklemek AddString ve/veya AddStrings.
Çağırarak araç çubuğuna düğme yapılarını eklemek AddButtons.
Değil sahibi penceresindeki araç çubuğu düğmesi için araç ipuçlarını istiyorsanız, bir CFrameWnd, ele alması gereken ttn_needtext açıklandığı gibi araç çubuğunun sahibi penceresinde iletilerin Araç ipucu bildirimleri işleme. Araç çubuğunun üst pencere türetilir, CFrameWnd, araç ipuçları görüntülenir sizden fazladan herhangi bir çaba olmadan çünkü CFrameWnd varsayılan işleyici sağlar.
Araç çubuğunu özelleştirmek, kullanıcının istiyorsanız sahibi penceresinde bildirim iletilerini özelleştirme açıklandığı gibi ele Özelleştirme bildirimleri işleme.

Kullanabileceğiniz SaveState kayıt defterinde toolbar denetiminin geçerli durumunu kaydetmek için ve RestoreState önceden kayıt defterinde saklanan bilgilere dayanarak durumuna geri yüklemek için. Kullanıcı daha sonra araç çubuğunu özgün durumuna geri yüklemek kullanıcının istediği durumlarda araç çubuğunu özelleştirme başlamadan önce uygulamanın kullandığı arasında araç çubuğu durumu deðiþtirmenin yaný sýra uygulamalar genellikle durumu depolar.

Internet Explorer sürüm 4.0 ve sonraki sürümleri için destek

Internet Explorer sürüm 4.0 ve sunulan işlevlerini desteklemek için araç çubuğu denetimleri resim listesi desteği ve saydam ve düz stilleri mfc sağlar.

Saydam bir araç çubuğu, araç çubuğunun altında istemcinin aradan olanak tanır. Saydam bir araç çubuğu oluşturmak için her ikisini birden kullanın: tbstyle_flat ve tbstyle_transparent stilleri. Saydam araç çubukları anında izleme özelliği; Fare işaretçisini araç çubuğunda sıcak düğmenin üzerine taşındığında, diğer bir deyişle, düğme görünümünü değiştirir. Araç çubukları ile oluşturulan yeni tbstyle_flat stili saydam olmayan düğmeleri içerir.

Resim listesi desteği varsayılan davranışı, sıcak görüntüleri ve resimleri devre dışı bırakılmış bir denetim daha fazla esneklik sağlar. Use GetImageList, GetHotImageList, ve GetDisabledImageList durumuna göre resmi işlemek için saydam araç çubuğu ile:

Daha fazla bilgi için CToolBarCtrl, bkz: denetimleri ve Kullanarak CToolBarCtrl.