CToolBarCtrl Sınıf

Windows araç çubuğu ortak denetiminin işlevselliğini sağlar.

Sözdizimi

class CToolBarCtrl : public CWnd

Üyeler

Ortak Oluşturucular

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

Genel Yöntemler

Veri Akışı Adı	Açıklama
CToolBarCtrl::AddBitmap	Araç çubuğu denetimi için kullanılabilen düğme görüntüleri listesine bir veya daha fazla bit eşlem düğmesi görüntüsü ekler.
CToolBarCtrl::AddButtons	Araç çubuğu denetimine bir veya daha fazla düğme ekler.
CToolBarCtrl::AddString	Araç çubuğunun iç dize listesine kaynak kimliği olarak geçirilen yeni bir dize ekler.
CToolBarCtrl::AddStrings	Araç çubuğunun iç dize listesine, ayrılmış dizelerin arabelleğine NULLişaretçi olarak geçirilen yeni bir dize veya dize ekler.
CToolBarCtrl::AutoSize	Araç çubuğu denetimini yeniden boyutlandırıyor.
CToolBarCtrl::ChangeBitmap	Geçerli araç çubuğu denetimindeki bir düğmenin bit eşlemini değiştirir.
CToolBarCtrl::CheckButton	Araç çubuğu denetimindeki belirli bir düğmeyi denetler veya temizler.
CToolBarCtrl::CommandToIndex	Belirtilen komut tanımlayıcısıyla ilişkili düğme için sıfır tabanlı dizini alır.
CToolBarCtrl::Create	Bir araç çubuğu denetimi oluşturur ve bunu bir CToolBarCtrl nesneye ekler.
CToolBarCtrl::CreateEx	Belirtilen Windows genişletilmiş stilleriyle bir araç çubuğu denetimi oluşturur ve bunu bir CToolBarCtrl nesneye ekler.
CToolBarCtrl::Customize	Araç Çubuğunu Özelleştir iletişim kutusunu görüntüler.
CToolBarCtrl::DeleteButton	Araç çubuğu denetiminden bir düğmeyi siler.
CToolBarCtrl::EnableButton	Araç çubuğu denetiminde belirtilen düğmeyi etkinleştirir veya devre dışı bırakır.
CToolBarCtrl::GetAnchorHighlight	Araç çubuğunun tutturucu vurgu ayarını alır.
CToolBarCtrl::GetBitmap	Araç çubuğundaki bir düğmeyle ilişkili bit eşlemin dizinini alır.
CToolBarCtrl::GetBitmapFlags	Araç çubuğunun bit eşlemiyle ilişkili bayrakları alır.
CToolBarCtrl::GetButton	Bir araç çubuğu denetiminde belirtilen düğme hakkında bilgi alır.
CToolBarCtrl::GetButtonCount	Araç çubuğu denetiminde bulunan düğmelerin sayısını alır.
CToolBarCtrl::GetButtonInfo	Araç çubuğundaki bir düğmenin bilgilerini alır.
CToolBarCtrl::GetButtonSize	Araç çubuğu düğmelerinin geçerli genişliğini ve yüksekliğini piksel cinsinden alır.
CToolBarCtrl::GetColorScheme	Geçerli araç çubuğu denetiminin renk düzenini alır.
CToolBarCtrl::GetDisabledImageList	Araç çubuğu denetiminin devre dışı düğmeleri görüntülemek için kullandığı görüntü listesini alır.
CToolBarCtrl::GetDropTarget	Araç çubuğu denetiminin IDropTarget arabirimini alır.
CToolBarCtrl::GetExtendedStyle	Araç çubuğu denetimi için genişletilmiş stilleri alır.
CToolBarCtrl::GetHotImageList	Araç çubuğu denetiminin "sık erişimli" düğmeleri görüntülemek için kullandığı görüntü listesini alır. Fare işaretçisi üzerindeyken etkin bir düğme vurgulanmış olarak görünür.
CToolBarCtrl::GetHotItem	Araç çubuğundaki sık erişimli öğenin dizinini alır.
CToolBarCtrl::GetImageList	Bir araç çubuğu denetiminin düğmeleri varsayılan durumunda görüntülemek için kullandığı görüntü listesini alır.
CToolBarCtrl::GetInsertMark	Araç çubuğu için geçerli ekleme işaretini alır.
CToolBarCtrl::GetInsertMarkColor	Araç çubuğunun ekleme işaretini çizmek için kullanılan rengi alır.
CToolBarCtrl::GetItemRect	Araç çubuğu denetimindeki bir düğmenin sınırlayıcı dikdörtgenini alır.
CToolBarCtrl::GetMaxSize	Araç çubuğundaki tüm görünür düğmelerin ve ayırıcıların toplam boyutunu alır.
CToolBarCtrl::GetMaxTextRows	Araç çubuğu düğmesinde görüntülenen en fazla metin satırı sayısını alır.
CToolBarCtrl::GetMetrics	Araç çubuğu denetiminin ölçümlerini alır.
CToolBarCtrl::GetPadding	Geçerli araç çubuğu denetiminin yatay ve dikey doldurmasını alır.
CToolBarCtrl::GetPressedImageList	Geçerli araç çubuğu denetiminin basılı durumdaki düğmeleri temsil etmek için kullandığı 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	Araç çubuğunda o anda görüntülenen düğme satırlarının sayısını alır.
CToolBarCtrl::GetState	Araç çubuğu denetiminde belirtilen düğmenin durumu hakkında etkin, basılmış veya işaretli gibi bilgileri alır.
CToolBarCtrl::GetString	Bir araç çubuğu dizesi alır.
CToolBarCtrl::GetStyle	Araç çubuğu denetimi için kullanılmakta olan stilleri alır.
CToolBarCtrl::GetToolTips	Araç ipucu denetiminin araç çubuğu denetimiyle ilişkili tutamacını (varsa) alır.
CToolBarCtrl::HideButton	Bir araç çubuğu denetiminde belirtilen düğmeyi gizler veya gösterir.
CToolBarCtrl::HitTest	Bir noktanın araç çubuğu denetiminde nerede olduğunu belirler.
CToolBarCtrl::Indeterminate	Bir araç çubuğu denetiminde belirtilen düğmenin belirsiz (gri) durumunu ayarlar veya temizler.
CToolBarCtrl::InsertButton	Araç çubuğu denetimine düğme ekler.
CToolBarCtrl::InsertMarkHitTest	Araç çubuğundaki bir noktanın ekleme işareti bilgilerini alır.
CToolBarCtrl::IsButtonChecked	Bir araç çubuğu denetiminde belirtilen düğmenin işaretli olup olmadığını bildirir.
CToolBarCtrl::IsButtonEnabled	Bir araç çubuğu denetiminde belirtilen düğmenin etkinleştirilip etkinleştirilmediğini bildirir.
CToolBarCtrl::IsButtonHidden	Bir araç çubuğu denetiminde belirtilen düğmenin gizli olup olmadığını bildirir.
CToolBarCtrl::IsButtonHighlighted	Araç çubuğu düğmesinin vurgu durumunu denetler.
CToolBarCtrl::IsButtonIndeterminate	Bir araç çubuğu denetiminde belirtilen düğmenin durumunun belirsiz (gri) olup olmadığını belirtir.
CToolBarCtrl::IsButtonPressed	Bir araç çubuğu denetiminde belirtilen düğmeye basılıp basılmadığını bildirir.
CToolBarCtrl::LoadImages	Bit eşlemleri bir araç çubuğu denetiminin görüntü listesine yükler.
CToolBarCtrl::MapAccelerator	Bir hızlandırıcı karakterini araç çubuğu düğmesine eşler.
CToolBarCtrl::MarkButton	Araç çubuğu denetimindeki belirli bir düğmenin vurgu durumunu ayarlar.
CToolBarCtrl::MoveButton	Düğmeyi bir dizinden diğerine taşır.
CToolBarCtrl::PressButton	Bir araç çubuğu denetiminde belirtilen düğmeye basar veya bırakır.
CToolBarCtrl::ReplaceBitmap	Geçerli araç çubuğu denetimindeki mevcut bit eşlemi yeni bir bit eşlem ile değiştirir.
CToolBarCtrl::RestoreState	Araç çubuğu denetiminin durumunu geri yükler.
CToolBarCtrl::SaveState	Araç çubuğu denetiminin durumunu kaydeder.
CToolBarCtrl::SetAnchorHighlight	Araç çubuğu için tutturucu vurgu ayarını ayarlar.
CToolBarCtrl::SetBitmapSize	Araç çubuğu denetimine eklenecek bit eşlemli görüntülerin boyutunu ayarlar.
CToolBarCtrl::SetButtonInfo	Araç çubuğundaki mevcut bir düğmenin bilgilerini ayarlar.
CToolBarCtrl::SetButtonSize	Araç çubuğu denetimine eklenecek düğmelerin boyutunu ayarlar.
CToolBarCtrl::SetButtonStructSize	Yapının boyutunu TBBUTTON belirtir.
CToolBarCtrl::SetButtonWidth	Araç çubuğu denetiminde en düşük ve en yüksek düğme genişliklerini ayarlar.
CToolBarCtrl::SetCmdID	Belirtilen düğmeye basıldığında sahip penceresine gönderilecek komut tanımlayıcısını ayarlar.
CToolBarCtrl::SetColorScheme	Geçerli araç çubuğu denetiminin renk düzenini ayarlar.
CToolBarCtrl::SetDisabledImageList	Araç çubuğu denetiminin devre dışı düğmeleri görüntülemek için kullanacağı resim listesini ayarlar.
CToolBarCtrl::SetDrawTextFlags	Belirtilen dikdörtgendeki metni çizmek için kullanılan Win32 işlevindeki DrawTextbayrakları, bayrakların nasıl ayarlandıklarına göre biçimlendirilmiş olarak ayarlar.
CToolBarCtrl::SetExtendedStyle	Araç çubuğu denetimi için genişletilmiş stilleri ayarlar.
CToolBarCtrl::SetHotImageList	Araç çubuğu denetiminin "sık erişimli" düğmeleri görüntülemek için kullanacağı görüntü listesini ayarlar.
CToolBarCtrl::SetHotItem	Araç çubuğundaki sık erişimli öğeyi ayarlar.
CToolBarCtrl::SetImageList	Araç çubuğunun varsayılan durumundaki düğmeleri görüntülemek için kullanacağı görüntü listesini ayarlar.
CToolBarCtrl::SetIndent	Araç çubuğu denetimindeki ilk düğmenin girintisini ayarlar.
CToolBarCtrl::SetInsertMark	Araç çubuğu için geçerli ekleme işaretini ayarlar.
CToolBarCtrl::SetInsertMarkColor	Araç çubuğunun ekleme işaretini çizmek için kullanılan rengi ayarlar.
CToolBarCtrl::SetMaxTextRows	Araç çubuğu düğmesinde görüntülenen en fazla metin satırı sayısını ayarlar.
CToolBarCtrl::SetMetrics	Araç çubuğu denetiminin ölçümlerini ayarlar.
CToolBarCtrl::SetOwner	Araç çubuğu denetiminden bildirim iletileri almak için pencereyi ayarlar.
CToolBarCtrl::SetPadding	Geçerli araç çubuğu denetiminin yatay ve dikey doldurmasını ayarlar.
CToolBarCtrl::SetPressedImageList	Geçerli araç çubuğu denetiminin basılan durumdaki düğmeleri temsil etmek için kullandığı görüntü listesini ayarlar.
CToolBarCtrl::SetRows	Araç çubuğunda görüntülenen düğme satırlarının sayısını ayarlar.
CToolBarCtrl::SetState	Bir araç çubuğu denetiminde belirtilen düğmenin durumunu ayarlar.
CToolBarCtrl::SetStyle	Araç çubuğu denetiminin stillerini ayarlar.
CToolBarCtrl::SetToolTips	Araç ipucu denetimini araç çubuğu denetimiyle ilişkilendirir.
CToolBarCtrl::SetWindowTheme	Araç çubuğu denetiminin görsel stilini ayarlar.

Açıklamalar

Bu denetim (ve dolayısıyla CToolBarCtrl sınıfı) yalnızca Windows 95/98 ve Windows NT sürüm 3.51 ve üzeri altında çalışan programlarda kullanılabilir.

Windows araç çubuğu ortak denetimi, bir veya daha fazla düğme içeren dikdörtgen bir alt penceredir. Bu düğmeler bit eşlem görüntüsü, dize veya her ikisini de görüntüleyebilir. Kullanıcı bir düğme seçtiğinde, araç çubuğunun sahip penceresine bir komut iletisi gönderir. Genellikle, araç çubuğundaki düğmeler uygulamanın menüsündeki öğelere karşılık gelir; kullanıcının bir uygulamanın komutlarına erişmesi için daha doğrudan bir yol sağlar.

CToolBarCtrl nesneler birkaç önemli iç veri yapısı içerir: düğme görüntüsü bit eşlemlerinin veya görüntü listesinin listesi, düğme etiketi dizelerinin listesi ve bir görüntüyü ve/veya dizeyi düğmenin konumu, stili, durumu ve komut kimliğiyle ilişkilendiren yapıların listesi TBBUTTON . Bu veri yapılarının öğelerinin her birine sıfır tabanlı bir dizin tarafından başvurulur. Bir CToolBarCtrl nesneyi kullanabilmeniz için önce bu veri yapılarını ayarlamanız gerekir. Dize listesi yalnızca düğme etiketleri için kullanılabilir; araç çubuğundan dizeleri alamazsınız.

Bir CToolBarCtrl nesneyi kullanmak için genellikle şu adımları izlersiniz:

1. Nesnesini oluşturma CToolBarCtrl .

2. Windows araç çubuğu ortak denetimini oluşturmak ve nesneye eklemek için çağrısı Create yapın CToolBarCtrl . Saydam araç çubuğu veya TBSTYLE_DROPDOWN açılan stil düğmelerini destekleyen bir araç çubuğu gibi TBSTYLE_TRANSPARENT stilleri kullanarak araç çubuğunun stilini belirtin.

3. Araç çubuğundaki düğmelerin nasıl görüntülenmesini istediğinizi belirleyin:

   • Düğmelerin bit eşlem görüntülerini kullanmak için çağırarak AddBitmapdüğme bit eşlemlerini araç çubuğuna ekleyin.

   • Düğmeler için bir görüntü listesinden görüntülenen görüntüleri kullanmak için , SetHotImageListveya SetDisabledImageListçağırarak SetImageListgörüntü listesini belirtin.

   • Düğmeler için dize etiketlerini kullanmak için ve/veya AddStringsöğesini çağırarak AddString dizeleri araç çubuğuna ekleyin.

4. komutunu çağırarak AddButtonsaraç çubuğuna düğme yapıları ekleyin.

5. Olmayan bir sahip penceresinde CFrameWndaraç çubuğu düğmesi için araç ipuçları istiyorsanız, araç çubuğunun sahip penceresindeki iletileri Araç İpucu Bildirimlerini İşleme bölümünde açıklandığı gibi işlemeniz TTN_NEEDTEXT gerekir. Araç çubuğunun üst penceresi öğesinden CFrameWndtüretilmişse, araç ipuçları, varsayılan bir işleyici sağladığından, sizden CFrameWnd ek bir çaba olmadan görüntülenir.

6. Kullanıcınızın araç çubuğunu özelleştirebilmesini istiyorsanız, Özelleştirme Bildirimlerini İşleme bölümünde açıklandığı gibi sahip penceresinde özelleştirme bildirim iletilerini işleyin.

Bir araç çubuğu denetiminin geçerli durumunu kayıt defterine kaydetmek ve RestoreState daha önce kayıt defterinde depolanan bilgilere göre durumu geri yüklemek için kullanabilirsinizSaveState. Uygulama kullanımları arasında araç çubuğu durumunu kaydetmeye ek olarak, uygulamalar genellikle kullanıcının daha sonra araç çubuğunu özgün durumuna geri yüklemek istemesi durumunda araç çubuğunu özelleştirmeye başlamadan önce durumu depolar.

Internet Explorer Sürüm 4.0 ve Üzeri desteği

MFC, Internet Explorer, sürüm 4.0 ve sonraki sürümlerde sunulan işlevleri desteklemek için, araç çubuğu denetimleri için görüntü listesi desteği ve saydam ve düz stiller sağlar.

Saydam araç çubuğu, araç çubuğunun altındaki istemcinin aracılığıyla gösterilmesini sağlar. Saydam araç çubuğu oluşturmak için hem TBSTYLE_TRANSPARENT hem de TBSTYLE_FLAT stillerini kullanın. Saydam araç çubukları etkin izleme özelliğine sahiptir; başka bir ifadeyle, fare işaretçisi araç çubuğundaki etkin bir düğmenin üzerine geldiğinde düğmenin görünümü değişir. Yalnızca TBSTYLE_FLAT stille oluşturulan araç çubukları saydam olmayan düğmeler içerir.

Görüntü listesi desteği, denetimin varsayılan davranış, sık erişimli görüntüler ve devre dışı bırakılan görüntüler için daha fazla esneklik sağlamasına olanak tanır. Resmi durumuna göre işlemek için saydam araç çubuğuyla , GetHotImageListve GetDisabledImageList kullanınGetImageList:

kullanma CToolBarCtrlhakkında daha fazla bilgi için bkz. Denetimler ve Kullanma CToolBarCtrl.

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CToolBarCtrl

Gereksinimler

Üstbilgi: afxcmn.h

CToolBarCtrl::AddBitmap

Araç çubuğu denetiminde depolanan düğme görüntüleri listesine bir veya daha fazla düğme görüntüsü ekler.

int AddBitmap(
    int nNumButtons,
    UINT nBitmapID);

int AddBitmap(
    int nNumButtons,
    CBitmap* pBitmap);

Parametreler

nNumButtons
Bit eşlem içindeki düğme görüntüsü sayısı.

nBitmapID
Eklenecek düğme görüntüsünü veya resimleri içeren bit eşlemin kaynak tanımlayıcısı.

pBitmap
CBitmap Eklenecek düğme görüntüsünü veya resimleri içeren nesnenin işaretçisi.

Dönüş Değeri

Başarılı olursa ilk yeni görüntünün sıfır tabanlı dizini; aksi takdirde - 1.

Açıklamalar

Bit eşlemi araç çubuğuna eklemeden önce renkleri eşlemek için Windows API'sini CreateMappedBitmap kullanabilirsiniz. Bir CBitMap nesneye işaretçi geçirirseniz, araç çubuğu yok edilene kadar bit eşlemin yok edilmediğinden emin olmanız gerekir.

CToolBarCtrl::AddButtons

Araç çubuğu denetimine bir veya daha fazla düğme ekler.

BOOL AddButtons(
    int nNumButtons,
    LPTBBUTTON lpButtons);

Parametreler

nNumButtons
Eklenecek düğme sayısı.

lpButtons
Eklenecek düğmeler hakkında bilgi içeren bir yapı dizisinin TBBUTTON adresi. Dizide, tarafından nNumButtonsbelirtilen düğmelerle aynı sayıda öğe olmalıdır.

Dönüş Değeri

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

Açıklamalar

İşaretçi lpButtons bir yapı dizisine TBBUTTON işaret eder. Her TBBUTTON yapı, eklenen düğmeyi düğmenin stili, görüntüsü ve/veya dizesi, komut kimliği, durumu ve kullanıcı tanımlı verileriyle ilişkilendirir:

typedef struct _TBBUTTON {
    int iBitmap;    // zero-based index of button image
    int idCommand;  // command to be sent when button pressed
    BYTE fsState;   // button state--see below
    BYTE fsStyle;   // button style--see below
    DWORD dwData;   // application-defined value
    int iString;    // zero-based index of button label string
} TBBUTTON;

Üyeler şunlardır:

• iBitmap

  Düğme görüntüsünün sıfır tabanlı dizini, bu düğme için görüntü yoksa -1.

• idCommand

  Düğmeyle ilişkilendirilmiş komut tanımlayıcısı. Düğme seçildiğinde bu tanımlayıcı bir WM_COMMAND iletide gönderilir. Üyenin fsStyle TBSTYLE_SEP değeri varsa, bu üye sıfır olmalıdır.

• fsState

  Düğme durumu bayrakları. Aşağıda listelenen değerlerin bir bileşimi olabilir:

  • TBSTATE_CHECKED Düğme stiline sahiptir ve düğmeye TBSTYLE_CHECKED basılıyor.

  • TBSTATE_ENABLED Düğme, kullanıcı girişini kabul eder. Bu duruma sahip olmayan bir düğme kullanıcı girişini kabul etmez ve gri renktedir.

  • TBSTATE_HIDDEN Düğme görünmez ve kullanıcı girişi alamaz.

  • TBSTATE_INDETERMINATE Düğme gri renktedir.

  • TBSTATE_PRESSED Düğmeye basılıyor.

  • TBSTATE_WRAP Düğmeyi izleyen satır sonu. Düğmenin de TBSTATE_ENABLED durumu olmalıdır.

• fsStyle

  Düğme stili. Aşağıda listelenen değerlerin bir bileşimi olabilir:

  • TBSTYLE_BUTTON Standart bir anında iletme düğmesi oluşturur.

  • TBSTYLE_CHECK Kullanıcı her tıklayışında basılan ve bastırılmamış durumlar arasında geçiş yapmak için bir düğme oluşturur. Düğme, basılı durumdayken farklı bir arka plan rengine sahiptir.

  • TBSTYLE_CHECKGROUP Gruptaki başka bir düğmeye basılana kadar basılı kalan bir onay düğmesi oluşturur.

  • TBSTYLE_GROUP Gruptaki başka bir düğmeye basılana kadar basılı kalan bir düğme oluşturur.

  • TBSTYLE_SEP Düğme grupları arasında küçük bir boşluk sağlayarak bir ayırıcı oluşturur. Bu stile sahip bir düğme kullanıcı girişi almaz.

• dwData

  Kullanıcı tanımlı veriler.

• iString

  Düğmenin etiketi olarak kullanılacak dizenin sıfır tabanlı dizini, bu düğme için dize yoksa -1.

Dizini sağladığınız görüntü ve/veya dize daha önce , AddStringve/veya AddStringskullanılarak AddBitmaparaç çubuğu denetiminin listesine eklenmiş olmalıdır.

CToolBarCtrl::AddString

Araç çubuğunun iç dize listesine kaynak kimliği olarak geçirilen yeni bir dize ekler.

int AddString(UINT nStringID);

Parametreler

nStringID
Araç çubuğu denetiminin dize listesine eklenecek dize kaynağının kaynak tanımlayıcısı.

Dönüş Değeri

Başarılı olursa eklenen ilk yeni dizenin sıfır tabanlı dizini; aksi takdirde -1.

CToolBarCtrl::AddStrings

Araç çubuğu denetimi için kullanılabilen dizeler listesine yeni bir dize veya dize ekler.

int AddStrings(LPCTSTR lpszStrings);

Parametreler

lpszStrings
Araç çubuğunun dize listesine eklenecek bir veya daha fazla NULLsonlandırılan dize içeren arabelleğin adresi. Son dize iki NULL karakterle sonlandırılmalıdır.

Dönüş Değeri

Başarılı olursa eklenen ilk yeni dizenin sıfır tabanlı dizini; aksi takdirde -1.

Açıklamalar

Arabellekteki dizeler bir NULL karakterle ayrılmalıdır. Son dizenin iki NULL sonlandırıcısı olduğundan emin olmalısınız. Sabit bir dizeyi düzgün biçimlendirmek için şu şekilde yazabilirsiniz:

// one null added automatically
lpszStrings = _T("Only one string to add\0");

veya:

// adds three strings with one call
lpszStrings = _T("String 1\0String 2\0String 3\0");

bir içinde birden NULL fazla karakter olması mümkün olmadığından bu işleve nesne CStringgeçirmemelisinizCString.

CToolBarCtrl::AutoSize

Araç çubuğu denetiminin tamamını yeniden boyutlandırıyor.

void AutoSize();

Açıklamalar

Üst pencerenin boyutu değiştiğinde veya araç çubuğunun boyutu değiştiğinde (örneğin, düğmeyi veya bit eşlem boyutunu ayarladığınızda veya dize eklediğinizde) bu işlevi çağırmalısınız.

CToolBarCtrl::ChangeBitmap

Geçerli araç çubuğu denetimindeki bir düğmenin bit eşlemini değiştirir.

BOOL ChangeBitmap(
    int idButton,
    int iBitmap);

Parametreler

idButton
[in] Yeni bit eşlem almak için düğmenin komut tanımlayıcısı.

iBitmap
[in] Geçerli araç çubuğu denetiminin görüntü listesindeki bir görüntünün sıfır tabanlı dizini.

Dönüş Değeri

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

Açıklamalar

Bu yöntem başarılı olursa, sistem belirtilen görüntüyü belirtilen düğmede görüntüler.

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

Örnek

Aşağıdaki kod örneği, Dosya Kaydet düğmesinin bit eşlemini Hakkında düğmesinin bit eşlemine değiştirir.

{
   // Change the bitmap for the File Save button, whose
   // command ID is ID_FILE_SAVE, to the bitmap for the
   // About button, whose index is 7.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ChangeBitmap(ID_FILE_SAVE, 7);
}

CToolBarCtrl::CheckButton

Araç çubuğu denetimindeki belirli bir düğmeyi denetler veya temizler.

BOOL CheckButton(
    int nID,
    BOOL bCheck = TRUE);

Parametreler

nID
Kontrol etmek veya temizlemek için düğmenin komut tanımlayıcısı.

bCheck
TRUE ögesini FALSE seçin.

Dönüş Değeri

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

Açıklamalar

Bir düğme işaretlendiğinde, düğmeye basılmış gibi görünür. Birden fazla düğme durumunu değiştirmek istiyorsanız, bunun yerine aramayı SetState göz önünde bulundurun.

CToolBarCtrl::CommandToIndex

Belirtilen komut tanımlayıcısıyla ilişkili düğme için sıfır tabanlı dizini alır.

UINT CommandToIndex(UINT nID) const;

Parametreler

nID
Düğme dizinini bulmak istediğiniz komut kimliği.

Dönüş Değeri

Komut kimliğiyle ilişkili düğme için sıfır tabanlı dizin.

Açıklamalar

CToolBarCtrl::Create

Bir araç çubuğu denetimi oluşturur ve bunu bir CToolBarCtrl nesneye ekler.

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

Parametreler

dwStyle
Araç çubuğu denetiminin stilini belirtir. Araç çubukları her zaman stile WS_CHILD sahip olmalıdır. Ayrıca, Açıklamalar altında açıklandığı gibi araç çubuğu stilleri ve pencere stillerinin herhangi bir bileşimini belirtebilirsiniz.

rect
İsteğe bağlı olarak araç çubuğu denetiminin boyutunu ve konumunu belirtir. Nesne veya RECT yapı olabilirCRect.

pParentWnd
Araç çubuğu denetiminin üst penceresini belirtir. Bu olmamalıdır NULL.

nID
Araç çubuğu denetiminin kimliğini belirtir.

Dönüş Değeri

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

Açıklamalar

İki adımda bir CToolBarCtrl oluşturursunuz. İlk olarak oluşturucuyu çağırın ve ardından araç çubuğu denetimini oluşturan ve nesnesine ekleyen öğesini çağırınCreateCToolBarCtrl. Araç çubuğu denetimine aşağıdaki pencere stillerini uygulayın.

• WS_CHILD Her zaman

• WS_VISIBLE Genelde

• WS_DISABLED Nadiren

Pencere stillerinin açıklaması için Bkz CreateWindow . Windows SDK'sı.

İsteğe bağlı olarak, Windows SDK'da açıklandığı gibi ortak denetim stillerinin bir bileşimini uygulayın.

Denetime veya düğmelerin kendilerine araç çubuğu stillerinin bir bileşimini uygulayın. Stiller, Windows SDK'sında Araç Çubuğu Denetimi ve Düğme Stilleri konu başlığında açıklanmıştır.

Genişletilmiş araç çubuğu stillerini kullanmak için çağrısı SetExtendedStyle yaptıktan sonra öğesini arayın Create. Genişletilmiş pencere stillerine sahip bir araç çubuğu oluşturmak için yerine öğesini çağırın CToolBarCtrl::CreateEx Create.

Araç çubuğu denetimi, araç çubuğu penceresinin boyutunu ve konumunu otomatik olarak ayarlar. Yükseklik, araç çubuğundaki düğmelerin yüksekliğini temel alır. Genişlik, üst pencerenin istemci alanının genişliğiyle aynıdır. CCS_TOP ve CCS_BOTTOM stilleri, araç çubuğunun istemci alanının üst veya alt kısmı boyunca konumlandırılıp konumlandırılmadığını belirler. Varsayılan olarak, araç çubuğunun CCS_TOP stili vardır.

CToolBarCtrl::CreateEx

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

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

Parametreler

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

dwStyle
Araç çubuğu denetiminin stilini belirtir. Araç çubukları her zaman stile WS_CHILD sahip olmalıdır. Ayrıca, araç çubuğu stilleri ve pencere stillerinin herhangi bir bileşimini, öğesinin Açıklamalar bölümünde Createaçıklandığı gibi belirtebilirsiniz.

rect
oluşturulacak pencerenin boyutunu ve konumunu istemci koordinatlarında pParentWndaçıklayan bir RECT yapı başvurusu.

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

nID
Denetimin alt pencere kimliği.

Dönüş Değeri

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

Açıklamalar

Create Yerine, Windows genişletilmiş stil ön biçimi WS_EX_tarafından belirtilen genişletilmiş Windows stilleri uygulamak için kullanınCreateEx. CreateEx tarafından dwExStylebelirtilen genişletilmiş Windows stilleriyle denetimi oluşturur. kullanarak SetExtendedStylebir denetime özgü genişletilmiş stilleri ayarlayın. Örneğin, gibi WS_EX_CONTEXTHELPstilleri ayarlamak için kullanınCreateEx, ancak gibi TBSTYLE_EX_DRAWDDARROWSstilleri ayarlamak için kullanınSetExtendedStyle. Daha fazla bilgi için Bkz. Windows SDK'sında Araç Çubuğu Genişletilmiş Stilleri'nde açıklanan stiller .

CToolBarCtrl::CToolBarCtrl

Bir CToolBarCtrl nesne oluşturur.

CToolBarCtrl();

Açıklamalar

Araç çubuğunu kullanılabilir hale getirmek için aramanız Create gerekir.

CToolBarCtrl::Customize

Araç Çubuğunu Özelleştir iletişim kutusunu görüntüler.

void Customize();

Açıklamalar

Bu iletişim kutusu, kullanıcının düğmeleri ekleyerek ve silerek araç çubuğunu özelleştirmesine olanak tanır. Özelleştirmeyi desteklemek için, araç çubuğunuzun üst penceresi Özelleştirme Bildirimlerini İşleme bölümünde açıklandığı gibi özelleştirme bildirim iletilerini işlemelidir. Araç çubuğunuz da içinde CToolBarCtrl::Createaçıklandığı gibi stiliyle CCS_ADJUSTABLE oluşturulmuş olmalıdır.

CToolBarCtrl::DeleteButton

Araç çubuğu denetiminden bir düğmeyi siler.

BOOL DeleteButton(int nIndex);

Parametreler

nIndex
Silinecek düğmenin sıfır tabanlı dizini.

Dönüş Değeri

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

Açıklamalar

CToolBarCtrl::EnableButton

Araç çubuğu denetiminde belirtilen düğmeyi etkinleştirir veya devre dışı bırakır.

BOOL EnableButton(
    int nID,
    BOOL bEnable = TRUE);

Parametreler

nID
Etkinleştirmek veya devre dışı bırakmak için düğmenin komut tanımlayıcısı.

bEnable
TRUE düğmesini etkinleştirmek için; FALSE düğmesini devre dışı bırakın.

Dönüş Değeri

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

Açıklamalar

Bir düğme etkinleştirildiğinde düğmeye basılabilir ve işaretlenebilir. Birden fazla düğme durumunu değiştirmek istiyorsanız, bunun yerine aramayı SetState göz önünde bulundurun.

CToolBarCtrl::GetAnchorHighlight

Araç çubuğunun tutturucu vurgu ayarını alır.

BOOL GetAnchorHighlight() const;

Dönüş Değeri

Sıfır değilse, tutturucu vurgulama etkinleştirilir. Sıfır ise, yer işareti vurgulama devre dışı bırakılır.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETANCHORHIGHLIGHTdavranışını uygular.

CToolBarCtrl::GetBitmap

Araç çubuğundaki bir düğmeyle ilişkili bit eşlemin dizinini alır.

int GetBitmap(int nID) const;

Parametreler

nID
Bit eşlem dizini alınacak düğmenin komut tanımlayıcısı.

Dönüş Değeri

Başarılı olursa bit eşlem dizinini veya aksi takdirde sıfırı döndürür.

Açıklamalar

Windows SDK'sında işlevini TB_GETBITMAP uygular.

CToolBarCtrl::GetBitmapFlags

Araç çubuğundan bit eşlem bayraklarını alır.

UINT GetBitmapFlags() const;

Dönüş Değeri

UINT TBBF_LARGE Ekran büyük araç çubuğu bit eşlemlerini destekleyemiyorsa bayrağı ayarlanmış bir, aksi takdirde temizleyin.

Açıklamalar

Araç çubuğunu oluşturduktan sonra ancak araç çubuğuna bit eşlemler eklemeden önce çağırmalısınız. Dönüş değeri, ekranın büyük bit eşlemleri destekleyip desteklemediğini gösterir. Ekran büyük bit eşlemleri destekliyorsa ve bunları kullanmayı seçerseniz kullanarak büyük bit eşleminizi AddBitmapeklemeden önce ve SetButtonSize çağrısı SetBitmapSize yapın.

CToolBarCtrl::GetButton

Bir araç çubuğu denetiminde belirtilen düğme hakkında bilgi alır.

BOOL GetButton(
    int nIndex,
    LPTBBUTTON lpButton) const;

Parametreler

nIndex
Bilgi alınacak düğmenin sıfır tabanlı dizini.

lpButton
TBBUTTON Düğme bilgilerinin bir kopyasını alacak yapının adresi. Yapı hakkında TBBUTTON bilgi için bkzCToolBarCtrl::AddButtons.

Dönüş Değeri

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

CToolBarCtrl::GetButtonCount

Araç çubuğu denetiminde bulunan düğmelerin sayısını alır.

int GetButtonCount() const;

Dönüş Değeri

Düğmelerin sayısı.

CToolBarCtrl::GetButtonInfo

Araç çubuğundaki bir düğmenin bilgilerini alır.

int GetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi) const;

Parametreler

nID
Düğme tanımlayıcısı.

ptbbi
Düğme bilgilerini alan bir TBBUTTONINFO yapı işaretçisi.

Dönüş Değeri

Başarılı olursa, düğmenin sıfır tabanlı dizini; aksi takdirde -1.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETBUTTONINFOdavranışını uygular.

CToolBarCtrl::GetButtonSize

Araç çubuğu düğmesinin boyutunu alır.

DWORD GetButtonSize() const;

Dönüş Değeri

DWORD sırasıyla ve HIWORDiçindeki LOWORD genişlik ve yükseklik değerlerini içeren bir değer.

CToolBarCtrl::GetButtonText

Geçerli araç çubuğu denetiminde belirtilen düğmenin görüntüleme metnini alır.

CString GetButtonText(int idButton) const;

Parametreler

idButton
[in] Görüntüleme metni alınan düğmenin tanımlayıcısı.

Dönüş Değeri

CString Belirtilen düğmenin görünen metnini içeren bir.

Açıklamalar

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

CToolBarCtrl::GetColorScheme

Geçerli araç çubuğu denetiminin renk düzenini alır.

BOOL GetColorScheme(COLORSCHEME* lpColorScheme) const;

Parametreler

lpColorScheme
[out] Renk düzeni bilgilerini alan bir COLORSCHEME yapı işaretçisi. Bu yöntem döndürdüğünde, yapı araç çubuğu denetiminin vurgu rengini ve gölge rengini açıklar.

Dönüş Değeri

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

Açıklamalar

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

CToolBarCtrl::GetDisabledImageList

Araç çubuğu denetiminin devre dışı düğmeleri görüntülemek için kullandığı görüntü listesini alır.

CImageList* GetDisabledImageList() const;

Dönüş Değeri

Bir nesnenin işaretçisi CImageList veya NULL devre dışı bırakılmış görüntü listesi ayarlanmadıysa.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETDISABLEDIMAGELISTdavranışını uygular. MFC uygulaması GetDisabledImageList , bir CImageList görüntü listesinin tutamacından ziyade araç çubuğu denetiminin düğme görüntülerini içeren bir nesne kullanır.

CToolBarCtrl::GetDropTarget

Araç çubuğu denetiminin IDropTarget arabirimini alır.

HRESULT GetDropTarget(IDropTarget** ppDropTarget) const;

Parametreler

ppDropTarget
Arabirim işaretçisine yönelik bir IDropTarget işaretçi. Hata oluşursa, bu adrese bir NULL işaretçi yerleştirilir.

Dönüş Değeri

İşlemin başarılı veya başarısız olduğunu gösteren bir HRESULT değer döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETOBJECTdavranışını uygular.

CToolBarCtrl::GetExtendedStyle

Araç çubuğu denetimi için genişletilmiş stilleri alır.

DWORD GetExtendedStyle() const;

Dönüş Değeri

DWORD Araç çubuğu denetimi için kullanılmakta olan genişletilmiş stilleri temsil eden bir. Stillerin listesi için Bkz . Windows SDK'sında Araç Çubuğu Genişletilmiş Stilleri.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETEXTENDEDSTYLEdavranışını uygular.

CToolBarCtrl::GetHotImageList

Araç çubuğu denetiminin "sık erişimli" düğmeleri görüntülemek için kullandığı görüntü listesini alır. Fare işaretçisi üzerindeyken etkin bir düğme vurgulanmış olarak görünür.

CImageList* GetHotImageList() const;

Dönüş Değeri

Bir nesnenin işaretçisi CImageList veya NULL devre dışı bırakılmış görüntü listesi ayarlanmadıysa.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETHOTIMAGELISTdavranışını uygular. Fare işaretçisi üzerindeyken etkin bir düğme vurgulanmış olarak görünür.

CToolBarCtrl::GetHotItem

Araç çubuğundaki sık erişimli öğenin dizinini alır.

int GetHotItem() const;

Dönüş Değeri

Araç çubuğundaki etkin öğenin sıfır tabanlı dizini.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETHOTITEMdavranışını uygular.

CToolBarCtrl::GetImageList

Bir araç çubuğu denetiminin düğmeleri varsayılan durumunda görüntülemek için kullandığı görüntü listesini alır.

CImageList* GetImageList() const;

Dönüş Değeri

Nesne işaretçisi CImageList veya NULL resim listesi ayarlı değilse.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETIMAGELISTdavranışını uygular.

CToolBarCtrl::GetInsertMark

Araç çubuğu için geçerli ekleme işaretini alır.

void GetInsertMark(TBINSERTMARK* ptbim) const;

Parametreler

ptbim
Ekleme işaretini alan bir TBINSERTMARK yapı işaretçisi.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETINSERTMARKdavranışını uygular.

CToolBarCtrl::GetInsertMarkColor

Araç çubuğunun ekleme işaretini çizmek için kullanılan rengi alır.

COLORREF GetInsertMarkColor() const;

Dönüş Değeri

COLORREF Geçerli ekleme işareti rengini içeren bir değer.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETINSERTMARKCOLORdavranışını uygular.

CToolBarCtrl::GetItemRect

Araç çubuğu denetimindeki bir düğmenin sınırlayıcı dikdörtgenini alır.

BOOL GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parametreler

nIndex
Bilgi alınacak düğmenin sıfır tabanlı dizini.

lpRect
Sınırlayıcı dikdörtgenin koordinatlarını alan bir RECT CRect yapının veya nesnenin adresi.

Dönüş Değeri

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

Açıklamalar

Bu işlev, durumu olarak ayarlanmış düğmeler için sınırlayıcı dikdörtgeni TBSTATE_HIDDENalmaz.

CToolBarCtrl::GetMaxSize

Araç çubuğundaki tüm görünür düğmelerin ve ayırıcıların toplam boyutunu alır.

BOOL GetMaxSize(LPSIZE pSize) const;

Parametreler

pSize
Öğelerin boyutunu alan bir SIZE yapı işaretçisi.

Dönüş Değeri

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

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETMAXSIZEdavranışını uygular.

CToolBarCtrl::GetMaxTextRows

Araç çubuğu düğmesinde görüntülenen en fazla metin satırı sayısını alır.

int GetMaxTextRows() const;

Dönüş Değeri

Araç çubuğu düğmesinde görüntülenen en fazla metin satırı sayısı.

CToolBarCtrl::GetMetrics

Nesnenin ölçümlerini CToolBarCtrl alır.

void GetMetrics(LPTBMETRICS ptbm) const;

Parametreler

ptbm
Nesnenin TBMETRICS yapısına ilişkin CToolBarCtrl bir işaretçi.

Açıklamalar

Bu üye işlevi, Windows SDK'sında açıklandığı gibi iletinin TB_GETMETRICS işlevselliğine öykünmektedir.

CToolBarCtrl::GetPadding

Geçerli araç çubuğu denetiminin yatay ve dikey doldurmasını alır.

BOOL GetPadding(
    int* pnHorzPadding,
    int* pnVertPadding) const;

Parametreler

pnHorzPadding
[out] Araç çubuğu denetiminin yatay doldurmasını piksel cinsinden alan tamsayı.

pnVertPadding
[out] Araç çubuğu denetiminin dikey doldurmasını piksel cinsinden alan tamsayı.

Dönüş Değeri

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

Açıklamalar

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

CToolBarCtrl::GetPressedImageList

Geçerli araç çubuğu denetiminin basılı durumdaki düğmeleri temsil etmek için kullandığı görüntü listesini alır.

CImageList* GetPressedImageList();

Dönüş Değeri

Geçerli denetimin görüntü listesini içeren veya NULL böyle bir CImageList görüntü listesi ayarlı değilse işaretçi.

Açıklamalar

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

CToolBarCtrl::GetRect

Belirtilen araç çubuğu düğmesi için sınırlayıcı dikdörtgeni alır.

BOOL GetRect(
    int nID,
    LPRECT lpRect) const;

Parametreler

nID
Düğme tanımlayıcısı.

lpRect
Sınırlayıcı dikdörtgen bilgilerini almak için bir RECT yapı işaretçisi.

Dönüş Değeri

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

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETRECTdavranışını uygular.

CToolBarCtrl::GetRows

Araç çubuğu denetimi tarafından şu anda görüntülenen düğme satırlarının sayısını alır.

int GetRows() const;

Dönüş Değeri

Araç çubuğunda şu anda görüntülenen düğme satırlarının sayısı.

Açıklamalar

Araç çubuğu stille TBSTYLE_WRAPABLE oluşturulmadığı sürece satır sayısının her zaman bir olacağını unutmayın.

CToolBarCtrl::GetState

Araç çubuğu denetiminde belirtilen düğmenin durumu hakkında etkin, basılmış veya işaretli gibi bilgileri alır.

int GetState(int nID) const;

Parametreler

nID
Bilgi alınacak düğmenin komut tanımlayıcısı.

Dönüş Değeri

Başarılı olursa düğme durumu bilgileri veya aksi takdirde -1. Düğme durumu bilgileri, içinde CToolBarCtrl::AddButtonslistelenen değerlerin bir bileşimi olabilir.

Açıklamalar

Düğme durumlarından birden fazlasını almak istiyorsanız bu işlev özellikle kullanışlıdır. Yalnızca bir durumu almak için şu üye işlevlerinden birini kullanın: IsButtonEnabled, IsButtonChecked, IsButtonPressed, IsButtonHiddenveya IsButtonIndeterminate. Ancak, GetState düğme durumunu algılamanın TBSTATE_WRAP tek yolu üye işlevidir.

CToolBarCtrl::GetString

Bir araç çubuğu dizesi alır.

int GetString(
    int nString,
    LPTSTR lpstrString,
    int cchMaxLen) const;

int GetString(
    int nString,
    CString& str) const;

Parametreler

nString
Dizenin dizini.

lpstrString
Dizeyi döndürmek için kullanılan arabelleğe işaretçi.

cchMaxLen
Arabellek bayt cinsinden uzunluğu.

str
Dize.

Dönüş Değeri

Başarılı olursa dizenin uzunluğu, değilse -1.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_GETSTRINGdavranışını uygular.

CToolBarCtrl::GetStyle

Bir araç çubuğu denetimine uygulanmış olan stilleri alır.

DWORD GetStyle() const;

Dönüş Değeri

DWORD Windows SDK'sında açıklandığı gibi araç çubuğu denetim stillerinin bir bileşimini içeren.

CToolBarCtrl::GetToolTips

Araç ipucu denetiminin araç çubuğu denetimiyle ilişkili tutamacını (varsa) alır.

CToolTipCtrl* GetToolTips() const;

Dönüş Değeri

Bu araç çubuğuyla ilişkili nesnenin CToolTipCtrl işaretçisi veya NULL araç çubuğunun ilişkili bir araç ipucu denetimi yoksa.

Açıklamalar

Araç çubuğu denetimi normalde kendi araç ipucu denetimini oluşturduğundan ve koruduğundan, çoğu programın bu işlevi çağırması gerekmez.

CToolBarCtrl::HitTest

Bir noktanın araç çubuğu denetiminde nerede olduğunu belirler.

int HitTest(LPPOINT ppt) const;

Parametreler

ppt
Üyedeki isabet testinin x koordinatını ve üyedeki x isabet testinin y koordinatını içeren bir POINT yapı işaretçisiy. Koordinatlar araç çubuğunun istemci alanına göredir.

Dönüş Değeri

Araç çubuğundaki bir noktanın konumunu gösteren tamsayı değeri. Değer sıfır veya pozitif bir değerse, bu dönüş değeri, noktanın bulunduğu ayrıştırıcı olmayan öğenin sıfır tabanlı dizinidir.

Dönüş değeri negatifse, nokta bir düğmenin içinde yer almaz. Dönüş değerinin mutlak değeri, ayırıcı öğenin dizini veya en yakın ayrıştırıcı olmayan öğedir.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_HITTESTdavranışını uygular.

CToolBarCtrl::HideButton

Bir araç çubuğu denetiminde belirtilen düğmeyi gizler veya gösterir.

BOOL HideButton(
    int nID,
    BOOL bHide = TRUE);

Parametreler

nID
Gizlenecek veya gösterilecek düğmenin komut tanımlayıcısı.

bHide
TRUE düğmesini gizleyebilir ve FALSE gösterebilirsiniz.

Dönüş Değeri

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

Açıklamalar

Birden fazla düğme durumunu değiştirmek istiyorsanız, bunun yerine aramayı SetState göz önünde bulundurun.

CToolBarCtrl::Indeterminate

Bir araç çubuğu denetiminde belirtilen düğmenin belirsiz durumunu ayarlar veya temizler.

BOOL Indeterminate(
    int nID,
    BOOL bIndeterminate = TRUE);

Parametreler

nID
Belirsiz durumu ayarlanacak veya temizlenecek düğmenin komut tanımlayıcısı.

bIndeterminate
TRUE komutuyla belirtilen düğmenin FALSE belirsiz durumunu ayarlamak ve temizlemek için.

Dönüş Değeri

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

Açıklamalar

Belirsiz düğmeler, bir sözcük işlemcisinin araç çubuğundaki kalın düğmenin, seçilen metin hem kalın hem de normal karakterler içerdiğinde nasıl görüneceği gibi gri görüntülenir. Birden fazla düğme durumunu değiştirmek istiyorsanız, bunun yerine aramayı SetState göz önünde bulundurun.

CToolBarCtrl::InsertButton

Araç çubuğu denetimine düğme ekler.

BOOL InsertButton(
    int nIndex,
    LPTBBUTTON lpButton);

Parametreler

nIndex
Bir düğmenin sıfır tabanlı dizini. Bu işlev, yeni düğmeyi bu düğmenin soluna ekler.

lpButton
Eklenecek düğme hakkında bilgi içeren bir TBBUTTON yapının adresi. Yapının açıklaması TBBUTTON için bkzCToolBarCtrl::AddButtons.

Dönüş Değeri

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

Açıklamalar

Dizini sağladığınız görüntü ve/veya dize daha önce , AddStringve/veya AddStringskullanılarak AddBitmaparaç çubuğu denetiminin listesine eklenmiş olmalıdır.

CToolBarCtrl::InsertMarkHitTest

Araç çubuğundaki bir noktanın ekleme işareti bilgilerini alır.

BOOL InsertMarkHitTest(
    LPPOINT ppt,
    LPTBINSERTMARK ptbim) const;

Parametreler

ppt
Araç çubuğunun istemci alanına göre isabet testi koordinatlarını içeren bir POINT yapı işaretçisi.

ptbim
Ekleme işareti bilgilerini alan bir TBINSERTMARK yapı işaretçisi.

Dönüş Değeri

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

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_INSERTMARKHITTESTdavranışını uygular.

CToolBarCtrl::IsButtonChecked

Araç çubuğu denetiminde belirtilen düğmenin işaretli olup olmadığını belirler.

BOOL IsButtonChecked(int nID) const;

Parametreler

nID
Araç çubuğundaki düğmenin komut tanımlayıcısı.

Dönüş Değeri

Düğme işaretliyse sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

Birden fazla düğme durumu almak istiyorsanız aramayı GetState göz önünde bulundurun.

CToolBarCtrl::IsButtonEnabled

Bir araç çubuğu denetiminde belirtilen düğmenin etkinleştirilip etkinleştirilmediğini belirler.

BOOL IsButtonEnabled(int nID) const;

Parametreler

nID
Araç çubuğundaki düğmenin komut tanımlayıcısı.

Dönüş Değeri

Düğme etkinse sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

Birden fazla düğme durumu almak istiyorsanız aramayı GetState göz önünde bulundurun.

CToolBarCtrl::IsButtonHidden

Bir araç çubuğu denetiminde belirtilen düğmenin gizli olup olmadığını belirler.

BOOL IsButtonHidden(int nID) const;

Parametreler

nID
Araç çubuğundaki düğmenin komut tanımlayıcısı.

Dönüş Değeri

Düğme gizliyse sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

Birden fazla düğme durumu almak istiyorsanız aramayı GetState göz önünde bulundurun.

CToolBarCtrl::IsButtonHighlighted

Araç çubuğu düğmesinin vurgu durumunu denetler.

BOOL IsButtonHighlighted(int nID) const;

Parametreler

nID
[in] Araç çubuğu düğmesinin komut kimliği.

Dönüş Değeri

Düğme vurgulanmışsa pozitif tamsayı, düğme vurgulanmadıysa 0 veya hata oluşursa -1.

CToolBarCtrl::IsButtonIndeterminate

Araç çubuğu denetiminde belirtilen düğmenin belirsiz olup olmadığını belirler.

BOOL IsButtonIndeterminate(int nID) const;

Parametreler

nID
[in] Araç çubuğundaki düğmenin komut tanımlayıcısı.

Dönüş Değeri

Düğme belirsizse pozitif tamsayı, düğme belirsiz değilse sıfır veya hata oluşursa -1.

Açıklamalar

Seçili metin hem kalın hem de normal karakterler içerdiğinde sözcük işlemcisinin araç çubuğundaki kalın düğmenin görünümü gibi belirsiz düğmeler soluk görüntülenir. Birden fazla düğme durumu almak istiyorsanız aramayı GetState göz önünde bulundurun.

CToolBarCtrl::IsButtonPressed

Bir araç çubuğu denetiminde belirtilen düğmeye basılıp basılmayacağını belirler.

BOOL IsButtonPressed(int nID) const;

Parametreler

nID
Araç çubuğundaki düğmenin komut tanımlayıcısı.

Dönüş Değeri

Düğmeye basıldığında sıfır olmayan, aksi takdirde sıfır.

Açıklamalar

Birden fazla düğme durumu almak istiyorsanız aramayı GetState göz önünde bulundurun.

CToolBarCtrl::LoadImages

Bit eşlemleri bir araç çubuğu denetiminin görüntü listesine yükler.

void LoadImages(
    int iBitmapID,
    HINSTANCE hinst);

Parametreler

iBitmapID
Yüklenecek görüntüleri içeren bit eşlem kimliği. Kendi bit eşlem kaynağınızı belirtmek için bu parametreyi bir bit eşlem kaynağının kimliğine ve olarak NULLayarlayınhInst. Bit eşlem kaynağınız görüntü listesine tek bir görüntü olarak eklenir. Bu parametreyi HINST_COMMCTRL aşağıdaki kimliklerden birine ayarlayarak hinst ve ayarlayarak standart, sistem tanımlı bit eşlemler ekleyebilirsiniz:

Bit Eşlem Kimliği	Açıklama
IDB_HIST_LARGE_COLOR	Büyük boyutlu gezgin bit eşlemleri
IDB_HIST_SMALL_COLOR	Gezgin bit eşlemleri küçük boyutlu
IDB_STD_LARGE_COLOR	Büyük boyutlu standart bit eşlemler
IDB_STD_SMALL_COLOR	Küçük boyutlu standart bit eşlemler
IDB_VIEW_LARGE_COLOR	Bit eşlemleri büyük boyutta görüntüleme
IDB_VIEW_SMALL_COLOR	Bit eşlemleri küçük boyutta görüntüleme

hinst
Program örneği tanıtıcısını çağıran uygulamaya gönderir. Bu parametre, standart bir görüntü listesi yüklemek için olabilir HINST_COMMCTRL .

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_LOADIMAGESdavranışını uygular.

CToolBarCtrl::MapAccelerator

Bir hızlandırıcı karakterini araç çubuğu düğmesine eşler.

BOOL MapAccelerator(
    TCHAR chAccel,
    UINT* pIDBtn);

Parametreler

chAccel
Eşlenecek hızlandırıcı karakteri. Bu karakter, düğmenin metninde altı çizili olan karakterle aynıdır.

pIDBtn
içinde belirtilen chAccelhızlandırıcıya karşılık gelen düğmenin komut tanımlayıcısını alan bir UINT işaretçi.

Dönüş Değeri

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

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_MAPACCELERATORdavranışını uygular.

CToolBarCtrl::MarkButton

Araç çubuğu denetimindeki belirli bir düğmenin vurgu durumunu ayarlar.

BOOL MarkButton(
    int nID,
    BOOL fHighlight = TRUE);

Parametreler

nID
Düğme tanımlayıcısı.

fHighlight
Ayarlanacak vurgu durumunu belirtir. Varsayılan olarak, TRUE. olarak ayarlanırsa FALSE, düğme varsayılan durumuna ayarlanır.

Dönüş Değeri

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

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_MARKBUTTONdavranışını uygular.

CToolBarCtrl::MoveButton

Düğmeyi bir dizinden diğerine taşır.

BOOL MoveButton(
    UINT nOldPos,
    UINT nNewPos);

Parametreler

nOldPos
Taşınacak düğmenin sıfır tabanlı dizini.

nNewPos
Düğmenin hedefinin sıfır tabanlı dizini.

Dönüş Değeri

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

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_MOVEBUTTONdavranışını uygular.

CToolBarCtrl::PressButton

Bir araç çubuğu denetiminde belirtilen düğmeye basar veya bırakır.

BOOL PressButton(int nID, BOOL bPress = TRUE);

Parametreler

nID
[in] Basılmasını veya serbest bırakılmasını istediğiniz düğmenin komut tanımlayıcısı.

bPress
[in] TRUE belirtilen düğmeye basmak için; FALSE öğesini seçin. Varsayılan değer şudur: TRUE.

Dönüş Değeri

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

Açıklamalar

Birden fazla düğme durumunu değiştirmek istiyorsanız, bunun yerine aramayı SetState göz önünde bulundurun.

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

CToolBarCtrl::ReplaceBitmap

Geçerli araç çubuğu denetimindeki mevcut bit eşlemi yeni bir bit eşlem ile değiştirir.

BOOL ReplaceBitmap(LPTBREPLACEBITMAP pReplaceBitmap);

Parametreler

pReplaceBitmap
[in] Değiştirilecek bit eşlemi ve yeni bit eşlemi açıklayan bir TBREPLACEBITMAP yapı işaretçisi.

Dönüş Değeri

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

Açıklamalar

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

Örnek

Aşağıdaki kod örneği standart araç çubuğunun bit eşlemini farklı bir bit eşlem ile değiştirir.

{
   // Replace one toolbar bitmap with another.
   TBREPLACEBITMAP tbrb;
   tbrb.hInstOld = ::AfxGetInstanceHandle();
   tbrb.nIDOld = IDR_MAINFRAME;
   tbrb.hInstNew = ::AfxGetInstanceHandle();
   tbrb.nIDNew = IDR_MAINFRAME1;
   tbrb.nButtons = 8;
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ReplaceBitmap(&tbrb);
}

CToolBarCtrl::RestoreState

Araç çubuğu denetiminin durumunu, parametreler tarafından belirtilen kayıt defterindeki konumdan geri yükler.

void RestoreState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Parametreler

hKeyRoot
Kayıt defterinde şu anda açık olan bir anahtarı veya önceden tanımlanmış aşağıdaki ayrılmış tanıtıcı değerlerinden birini tanımlar:

• HKEY_CLASSES_ROOT

• HKEY_CURRENT_USER

• HKEY_LOCAL_MACHINE

• HKEY_USERS

lpszSubKey
Bir NULLdeğerin ilişkilendirildiği alt anahtarın adını içeren -terminated dizesini gösterir. Bu parametre veya boş bir dize işaretçisi olabilir NULL . parametresi ise NULL, değer parametresi tarafından tanımlanan anahtara hKeyRoot eklenir.

lpszValueName
Alınacak değerin adını içeren bir dizeye işaret ediyor. Anahtarda bu ada sahip bir değer zaten yoksa işlev bunu anahtara ekler.

CToolBarCtrl::SaveState

Araç çubuğu denetiminin durumunu, parametreler tarafından belirtilen kayıt defterindeki konuma kaydeder.

void SaveState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Parametreler

hKeyRoot
Kayıt defterinde şu anda açık olan bir anahtarı veya önceden tanımlanmış aşağıdaki ayrılmış tanıtıcı değerlerinden birini tanımlar:

• HKEY_CLASSES_ROOT

• HKEY_CURRENT_USER

• HKEY_LOCAL_MACHINE

• HKEY_USERS

lpszSubKey
Bir NULLdeğerin ilişkilendirildiği alt anahtarın adını içeren -terminated dizesini gösterir. Bu parametre veya boş bir dize işaretçisi olabilir NULL . parametresi ise NULL, değer parametresi tarafından tanımlanan anahtara hKeyRoot eklenir.

lpszValueName
Ayarlanacağı değerin adını içeren bir dizeyi gösterir. Anahtarda bu ada sahip bir değer zaten yoksa işlev bunu anahtara ekler.

CToolBarCtrl::SetAnchorHighlight

Araç çubuğu için tutturucu vurgu ayarını ayarlar.

BOOL SetAnchorHighlight(BOOL fAnchor = TRUE);

Parametreler

fAnchor
[in] Yer işareti vurgulamanın etkin mi yoksa devre dışı mı olduğunu belirtir. Bu değer sıfır değilse, yer işareti vurgulama etkinleştirilir. Bu değer sıfırsa, yer işareti vurgulama devre dışı bırakılır

Dönüş Değeri

Önceki yer işareti ayarı. Vurgulama etkinleştirildiyse, bu değer sıfırdan farklı bir değerdir. Vurgulama etkinleştirilmediyse, bu değer sıfırdır.

Açıklamalar

Bu yöntem, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_SETANCHORHIGHLIGHTdavranışını uygular.

CToolBarCtrl::SetBitmapSize

Araç çubuğu denetimine eklenecek gerçek bit eşlemlenmiş görüntülerin boyutunu ayarlar.

BOOL SetBitmapSize(CSize size);

Parametreler

size
Bit eşlemlenmiş görüntülerin piksel cinsinden genişliği ve yüksekliği.

Dönüş Değeri

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

Açıklamalar

Bu işlev yalnızca araç çubuğuna bit eşlem eklemeden önce çağrılmalıdır. Uygulama bit eşlem boyutunu açıkça ayarlamazsa varsayılan olarak 16 x 15 piksel olur.

CToolBarCtrl::SetButtonInfo

Araç çubuğundaki mevcut bir düğmenin bilgilerini ayarlar.

BOOL SetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi);

Parametreler

nID
Düğme tanımlayıcısı.

ptbbi
Düğme bilgilerini alan bir TBBUTTONINFO yapı işaretçisi.

Dönüş Değeri

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

Açıklamalar

Üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_SETBUTTONINFOdavranışını uygular.

CToolBarCtrl::SetButtonSize

Araç çubuğu denetimindeki düğmelerin boyutunu ayarlar.

BOOL SetButtonSize(CSize size);

Parametreler

size
Düğmelerin piksel cinsinden genişliği ve yüksekliği.

Dönüş Değeri

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

Açıklamalar

Düğme boyutu her zaman en az bit eşlem boyutu kadar büyük olmalıdır. Bu işlev yalnızca araç çubuğuna bit eşlem eklemeden önce çağrılmalıdır. Uygulama düğme boyutunu açıkça ayarlamazsa varsayılan olarak 24 x 22 piksel olur.

Örnek

örneğine CToolBar::GetToolBarCtrlbakın.

CToolBarCtrl::SetButtonStructSize

Yapının boyutunu TBBUTTON belirtir.

void SetButtonStructSize(int nSize);

Parametreler

nSize
Yapının bayt cinsinden boyutu TBBUTTON .

Açıklamalar

Yapıda TBBUTTON ek veri depolamak isterseniz, öğesinden TBBUTTONyeni bir yapı türetebilir, ihtiyacınız olan üyeleri ekleyebilir veya ilk üyesi olarak bir yapı içeren yeni bir TBBUTTON yapı oluşturabilirsiniz. Daha sonra araç çubuğuna yeni yapının boyutunu denetlemek için bu işlevi çağırabilirsiniz.

Yapı hakkında TBBUTTON daha fazla bilgi için bkzCToolBarCtrl::AddButtons.

CToolBarCtrl::SetButtonWidth

Araç çubuğu denetiminde en düşük ve en yüksek düğme genişliklerini ayarlar.

BOOL SetButtonWidth(
    int cxMin,
    int cxMax);

Parametreler

cxMin
Piksel cinsinden en düşük düğme genişliği. Araç çubuğu düğmeleri hiçbir zaman bu değerden daha dar olmaz.

cxMax
Piksel cinsinden maksimum düğme genişliği. Düğme metni çok genişse, denetim bunu üç noktayla görüntüler.

Dönüş Değeri

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

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_SETBUTTONWIDTHdavranışını uygular.

CToolBarCtrl::SetCmdID

Belirtilen düğmeye basıldığında sahip penceresine gönderilecek komut tanımlayıcısını ayarlar.

BOOL SetCmdID(
    int nIndex,
    UINT nID);

Parametreler

nIndex
Komut kimliği ayarlanacak düğmenin sıfır tabanlı dizini.

nID
Seçili düğmenin ayarlanacağı komut kimliği.

Dönüş Değeri

Başarılı olursa sıfır olmayan döndürür; aksi takdirde sıfır.

CToolBarCtrl::SetColorScheme

Geçerli araç çubuğu denetiminin renk düzenini ayarlar.

void SetColorScheme(const COLORSCHEME* lpColorScheme);

Parametreler

lpColorScheme
[in] Araç çubuğu denetiminin vurgu rengini ve gölge rengini açıklayan bir COLORSCHEME yapı işaretçisi.

Açıklamalar

Windows Vista görsel teması ayarlandıysa bu yöntemin hiçbir etkisi olmaz.

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

Örnek

Aşağıdaki kod örneği, geçerli araç çubuğu denetiminin renk düzenini ayarlar. Kod örneği, her araç düğmesinin sol ve üst kenarlarını kırmızı, sağ ve alt kenarlarını mavi yapar. Kullanıcı düğmeye bastığında, düğmenin kırmızı kenarları mavi olur ve mavi kenarları kırmızı olur.

//Set color scheme for the current toolbar control.
//Make the left and top edges of the tool button red,
//and the right and bottom edges blue. The colors
//reverse when a button is pressed.
//This method has no effect if the Vista visual theme
//is set.
{
   COLORSCHEME cs;
   cs.dwSize = sizeof(COLORSCHEME);
   cs.clrBtnHighlight = RGB(255, 0, 0);
   cs.clrBtnShadow = RGB(0, 0, 255);
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetColorScheme(&cs);
}

CToolBarCtrl::SetDisabledImageList

Araç çubuğu denetiminin devre dışı düğmeleri görüntülemek için kullanacağı resim listesini ayarlar.

CImageList* SetDisabledImageList(CImageList* pImageList);

Parametreler

pImageList
Devre dışı bırakılan düğme görüntülerini görüntülemek için araç çubuğu denetimi tarafından kullanılacak görüntüleri içeren bir CImageList nesne işaretçisi.

Dönüş Değeri

Devre dışı bırakılan düğme görüntülerini görüntülemek için araç çubuğu denetimi tarafından daha önce kullanılmış olan bir CImageList nesnenin işaretçisi.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_SETDISABLEDIMAGELISTdavranışını uygular. MFC uygulaması SetDisabledImageList , araç çubuğu denetiminin devre dışı bırakılan düğme görüntülerini içeren bir CImageList nesneyi, görüntü listesinin tutamacı yerine kullanır.

CToolBarCtrl::SetDrawTextFlags

Belirtilen dikdörtgendeki metni çizmek için kullanılan Win32 işlevindeki DrawTextbayrakları, bayrakların nasıl ayarlandıklarına göre biçimlendirilmiş olarak ayarlar.

DWORD SetDrawTextFlags(
    DWORD dwMask,
    DWORD dwDTFlags);

Parametreler

dwMask
Win32 işlevinde DrawTextbelirtilen ve metni çizerken hangi bitlerin dwDTFlags kullanılacağını gösteren bir veya daha fazla DT_ bayrağın birleşimi.

dwDTFlags
Win32 işlevinde DrawTextbelirtilen ve düğme metninin DT_ nasıl çizileceğini gösteren bir veya daha fazla bayrağın birleşimi. Düğme metni çizildiğinde bu değere DrawText geçirilir.

Dönüş Değeri

DWORD Önceki metin çizim bayraklarını içeren.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_SETDRAWTEXTFLAGSdavranışını uygular. Bu üye işlevi, win32 işlevindeki DrawTextbayrakları ayarlar ve bu da belirtilen dikdörtgende bayrakların nasıl ayarlandığına göre biçimlendirilmiş metin çizer.

CToolBarCtrl::SetExtendedStyle

Araç çubuğu denetimi için genişletilmiş stilleri ayarlar.

DWORD SetExtendedStyle(DWORD dwExStyle);

Parametreler

dwExStyle
Yeni genişletilmiş stilleri belirten bir değer. Bu parametre, araç çubuğu genişletilmiş stillerinin bir bileşimi olabilir.

Dönüş Değeri

DWORD Önceki genişletilmiş stilleri temsil eden bir. Stillerin listesi için Bkz . Windows SDK'sında Araç Çubuğu Genişletilmiş Stilleri.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_SETEXTENDEDSTYLEdavranışını uygular.

CToolBarCtrl::SetHotImageList

Araç çubuğu denetiminin "sık erişimli" düğmeleri görüntülemek için kullanacağı görüntü listesini ayarlar.

CImageList* SetHotImageList(CImageList* pImageList);

Parametreler

pImageList
Etkin düğme görüntülerini görüntülemek için araç çubuğu denetimi tarafından kullanılacak görüntüleri içeren bir CImageList nesne işaretçisi.

Dönüş Değeri

Daha önce araç çubuğu denetimi tarafından etkin düğme görüntülerini görüntülemek için kullanılan bir CImageList nesne işaretçisi.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_SETHOTIMAGELISTdavranışını uygular.

MFC uygulaması SetHotImageList , bir CImageList görüntü listesinin tutamacı yerine araç çubuğu denetiminin etkin düğme görüntülerini içeren bir nesne kullanır. İşaretçi üzerindeyken etkin bir düğme vurgulanmış olarak görünür.

CToolBarCtrl::SetHotItem

Araç çubuğundaki sık erişimli öğeyi ayarlar.

int SetHotItem(int nHot);

Parametreler

nHot
Sık erişimli yapılacak öğenin sıfır tabanlı dizin numarası. Bu değer -1 ise, öğelerin hiçbiri sık erişimli olmaz.

Dönüş Değeri

Önceki sık erişimli öğenin dizini veya sık erişimli öğe yoksa -1.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_SETHOTITEMdavranışını uygular.

CToolBarCtrl::SetImageList

Araç çubuğunun varsayılan durumundaki düğmeleri görüntülemek için kullanacağı görüntü listesini ayarlar.

CImageList* SetImageList(CImageList* pImageList);

Parametreler

pImageList
Düğme görüntülerini varsayılan durumlarında görüntülemek için araç çubuğu denetimi tarafından kullanılacak görüntüleri içeren bir CImageList nesne işaretçisi.

Dönüş Değeri

Düğme görüntülerini varsayılan durumlarında görüntülemek için daha önce araç çubuğu denetimi tarafından kullanılan bir CImageList nesne işaretçisi.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_SETIMAGELISTdavranışını uygular.

MFC uygulaması SetImageList , bir CImageList görüntü listesinin tutamacından ziyade araç çubuğu denetiminin düğme görüntülerini içeren bir nesne kullanır.

CToolBarCtrl::SetIndent

Araç çubuğu denetimindeki ilk düğmenin girintisini ayarlar.

BOOL SetIndent(int iIndent);

Parametreler

iIndent
Piksel cinsinden girintiyi belirten değer.

Dönüş Değeri

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

CToolBarCtrl::SetInsertMark

Araç çubuğu için geçerli ekleme işaretini ayarlar.

void SetInsertMark(TBINSERTMARK* ptbim);

Parametreler

ptbim
TBINSERTMARK Ekleme işaretini içeren yapı işaretçisi.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_SETINSERTMARKdavranışını uygular.

CToolBarCtrl::SetInsertMarkColor

Araç çubuğunun ekleme işaretini çizmek için kullanılan rengi ayarlar.

COLORREF SetInsertMarkColor(COLORREF clrNew);

Parametreler

clrNew
COLORREF Yeni ekleme işareti rengini içeren bir değer.

Dönüş Değeri

Önceki COLORREF ekleme işareti rengini içeren bir değer.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi Win32 iletisinin TB_SETINSERTMARKCOLORdavranışını uygular.

CToolBarCtrl::SetMaxTextRows

Araç çubuğu düğmesinde görüntülenen en fazla metin satırı sayısını ayarlar.

BOOL SetMaxTextRows(int iMaxRows);

Parametreler

iMaxRows
Ayarlanacak en fazla satır sayısı.

Dönüş Değeri

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

CToolBarCtrl::SetMetrics

Nesnenin ölçümlerini CToolBarCtrl ayarlar.

void SetMetrics(LPTBMETRICS ptbm);

Parametreler

ptbm
Nesnenin TBMETRICS yapısına ilişkin CToolBarCtrl bir işaretçi.

Açıklamalar

Bu üye işlevi, Windows SDK'sında açıklandığı gibi iletinin TB_SETMETRICS işlevselliğine öykünmektedir.

CToolBarCtrl::SetOwner

Araç çubuğu denetimi için sahip penceresini ayarlar.

void SetOwner(CWnd* pWnd);

Parametreler

pWnd
Araç çubuğu denetimi için CWnd yeni sahip penceresi olacak veya CWndtüretilmiş nesnenin işaretçisi.

Açıklamalar

Sahip penceresi, araç çubuğundan bildirim alan penceredir.

CToolBarCtrl::SetPadding

Geçerli araç çubuğu denetiminin yatay ve dikey doldurmasını ayarlar.

DWORD SetPadding(
    int nHorzPadding,
    int nVertPadding);

Parametreler

nHorzPadding
[in] Araç çubuğu denetiminin yatay doldurmasını piksel cinsinden belirtir.

nVertPadding
[in] Araç çubuğu denetiminin dikey doldurmasını piksel cinsinden belirtir.

Dönüş Değeri

DWORD Düşük sözcüğü önceki yatay doldurma değerini, yüksek sözcüğü ise önceki dikey doldurma değerini içeren bir. Doldurma değerleri piksel cinsinden ölçülür.

Açıklamalar

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

Örnek

Aşağıdaki kod örneği, geçerli araç çubuğu denetiminin yatay ve dikey doldurmasını 20 piksel olarak ayarlar.

{
   // Set the horizontal and vertical padding of the current
   // toolbar control.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetPadding(50, 50);
}

CToolBarCtrl::SetPressedImageList

Geçerli araç çubuğu denetiminin basılan durumdaki düğmeleri temsil etmek için kullandığı görüntü listesini ayarlar.

CImagelist* SetPressedImageList(
    int iImageID,
    CImageList* pImageList);

Parametreler

iImageID
[in] Görüntü listesinin sıfır tabanlı dizini. Yalnızca bir resim listesi kullanıyorsanız bu parametreyi sıfır olarak ayarlayın.

pImageList
[in] Yeni görüntü listesini içeren bir CImageList işaretçi.

Dönüş Değeri

Geçerli denetimin önceki görüntü listesini içeren veya NULL böyle bir CImageList görüntü listesi ayarlanmadıysa işaretçi.

Açıklamalar

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

Örnek

Aşağıdaki kod örneği, basılan görüntü listesini varsayılan görüntü listesiyle aynı olacak şekilde ayarlar.

{
   // SetPressedImageList
   // Set the pressed image list to be the same as the
   // normal image list.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CImageList *pNormalCil = m_toolBarCtrl.GetImageList();
   CImageList *pPressedCil = m_toolBarCtrl.GetPressedImageList();
   m_toolBarCtrl.SetPressedImageList(0, pNormalCil);
}

CToolBarCtrl::SetRows

Araç çubuğu denetiminden kendisini istenen satır sayısına yeniden boyutlandırmasını ister.

void SetRows(
    int nRows,
    BOOL bLarger,
    LPRECT lpRect);

Parametreler

nRows
İstenen satır sayısı.

bLarger
Araç çubuğu istenen satır sayısına göre yeniden boyutlandırılamazsa daha fazla satır mı yoksa daha az satır mı kullanılacağını bildirir.

lpRect
Araç çubuğunun CRect yeni sınırlayıcı dikdörtgenini alacak nesneye veya RECT yapıya işaret eder.

Açıklamalar

Araç çubuğu kendisini istenen sayı veya satıra yeniden boyutlandıramıyorsa, değerine bLargerbağlı olarak kendisini bir sonraki büyük veya sonraki küçük geçerli boyuta yeniden boyutlandıracaktır. ise bLarger TRUE, yeni satır sayısı istenen sayıdan büyük olur. ise bLarger FALSE, yeni satır sayısı istenen sayıdan küçük olur.

Düğmeler, tüm satırların aynı sayıda düğme (son satır dışında) olacak şekilde düzenlenebiliyorsa, araç çubuğu için belirli bir satır sayısı geçerlidir. Örneğin, dört düğme içeren bir araç çubuğu, son iki satırın daha kısa olması gerekeceğinden üç satıra boyutlandırılamaz. Bunu üç satıra boyutlandırmaya çalıştıysanız, ise dört satır bLarger TRUE ve ise bLarger FALSEiki satır alırsınız.

Araç çubuğunda ayırıcılar varsa, belirli sayıda satırın geçerli olduğu durumlar için kurallar daha karmaşıktır. Düzen, düğme gruplarının (gruptaki ilk ve son düğmeden önce ayırıcı içeren düğmeler) hiçbir zaman grup bir satıra sığmadığı sürece birkaç satıra ayrılmaması için hesaplanır.

Bir grup bir satıra sığmazsa, büyük grubun sona erdiği satıra sığsa bile sonraki grup bir sonraki satırda başlar. Bu kuralın amacı, büyük gruplar arasındaki ayrımı daha belirgin hale getirmektir. Sonuçta elde edilen dikey ayırıcılar satır olarak sayılır.

Ayrıca üye işlevinin SetRows her zaman en küçük araç çubuğu boyutuyla sonuçlanacak düzeni seçeceğini unutmayın. Stile sahip TBSTYLE_WRAPABLE bir araç çubuğu oluşturup denetimi yeniden boyutlandırmak, denetimin genişliğine göre yukarıda özetlenen yöntemi uygular.

Bu işlev yalnızca stille TBSTYLE_WRAPABLE oluşturulmuş araç çubukları için çağrılabilir.

CToolBarCtrl::SetState

Bir araç çubuğu denetiminde belirtilen düğmenin durumunu ayarlar.

BOOL SetState(
    int nID,
    UINT nState);

Parametreler

nID
Düğmenin komut tanımlayıcısı.

nState
Durum bayrakları. içindeki düğme durumları CToolBarCtrl::AddButtonsiçin listelenen değerlerin bir bileşimi olabilir.

Dönüş Değeri

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

Açıklamalar

Düğme durumlarından birden fazlasını ayarlamak istiyorsanız bu işlev özellikle kullanışlıdır. Yalnızca bir durum ayarlamak için şu üye işlevlerinden birini kullanın: EnableButton, CheckButton, HideButton, Indeterminateveya PressButton.

CToolBarCtrl::SetStyle

Araç çubuğu denetiminin stillerini ayarlar.

void SetStyle(DWORD dwStyle);

Parametreler

dwStyle
DWORD Windows SDK'sında açıklandığı gibi araç çubuğu denetim stillerinin bir bileşimini içeren.

CToolBarCtrl::SetToolTips

Araç ipucu denetimini araç çubuğu denetimiyle ilişkilendirir.

void SetToolTips(CToolTipCtrl* pTip);

Parametreler

pTip
Nesne işaretçisi CToolTipCtrl .

CToolBarCtrl::SetWindowTheme

Nesnenin görsel stilini CToolBarCtrl ayarlar.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parametreler

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

Dönüş Değeri

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

Açıklamalar

Bu üye işlevi, Windows SDK'sında açıklandığı gibi iletinin TB_SETWINDOWTHEME işlevselliğine öykünmektedir.

Ayrıca bkz.

MFC Örneği CMNCTRL1
MFC Örneği MFCIE
CWnd Sınıf
Hiyerarşi Grafiği
CToolBar Sınıf