CMFCToolBarButton Sınıfı

Araç çubuklarına düğme işlevselliği sağlar.

Sözdizimi

class CMFCToolBarButton : public CObject

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CMFCToolBarButton::CMFCToolBarButton	Bir CMFCToolBarButton nesneyi oluşturur ve başlatır.
CMFCToolBarButton::~CMFCToolBarButton	Yıkıcı.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CMFCToolBarButton::CanBeDropped	Kullanıcının özelleştirme sırasında bir düğmeyi araç çubuğuna veya menüye yerleştirip konumlandıramayacağını belirtir.
CMFCToolBarButton::CanBeStored	Düğmenin depolanıp depolanamayacağını belirtir.
CMFCToolBarButton::CanBeStretched	Kullanıcının özelleştirme sırasında düğmeyi uzatıp uzatamayacağını belirtir.
CMFCToolBarButton::CompareWith	Bu örneği sağlanan CMFCToolBarButton nesneyle karşılaştırır.
CMFCToolBarButton::CopyFrom	Başka bir araç çubuğu düğmesinin özelliklerini geçerli düğmeye kopyalar.
CMFCToolBarButton::CreateFromOleData	Sağlanan COleDataObject nesneden bir CMFCToolBarButton nesne oluşturur.
CMFCToolBarButton::CreateObject	Bu sınıf türünün dinamik bir örneğini oluşturmak için çerçeve tarafından kullanılır.
CMFCToolBarButton::EnableWindow	Fare ve klavye girişini etkinleştirir veya devre dışı bırakır.
CMFCToolBarButton::ExportToMenuButton	Araç çubuğu düğmesindeki metni bir menüye kopyalar.
CMFCToolBarButton::GetClipboardFormat	Uygulamanın genel pano biçimini alır.
CMFCToolBarButton::GetHwnd	Araç çubuğu düğmesiyle ilişkili pencere tutamacını alır.
CMFCToolBarButton::GetImage	Düğmenin görüntü dizinini alır.
CMFCToolBarButton::GetInvalidateRect	Düğmenin istemci alanının yeniden çizilmesi gereken bölgesini alır.
CMFCToolBarButton::GetParentWnd	Düğmenin üst penceresini alır.
CMFCToolBarButton::GetProtectedCommands	Kullanıcının özelleştiremediği komutların listesini alır.
CMFCToolBarButton::GetTextSize	Düğme metninin boyutunu alır.
CMFCToolBarButton::HasFocus	Düğmenin geçerli giriş odağına sahip olup olmadığını belirler.
CMFCToolBarButton::HaveHotBorder	Kullanıcı düğmeyi seçtiğinde düğmenin kenarlarının görüntülenip görüntülenmeyeceğini belirler.
CMFCToolBarButton::IsDrawImage	Düğmede görüntü görüntülenip görüntülenmeyeceğini belirler.
CMFCToolBarButton::IsDrawText	Düğmede bir metin etiketinin görüntülenip görüntülenmeyeceğini belirler.
CMFCToolBarButton::IsDroppedDown	Düğmenin bir alt menü görüntüleyip görüntülemeyeceğini belirler.
CMFCToolBarButton::IsEditable	Düğmenin özelleştirilip özelleştirilemeyeceğini belirler.
CMFCToolBarButton::IsExtraSize	Düğmenin genişletilmiş kenarlıkla görüntülenip görüntülenemeyeceğini belirler.
CMFCToolBarButton::IsFirstInGroup	Düğmenin, düğme grubundaki ilk konumda olup olmadığını belirler.
CMFCToolBarButton::IsHidden	Düğmenin gizli olup olmadığını belirler.
CMFCToolBarButton::IsHorizontal	Düğmenin yatay bir araç çubuğunda bulunup bulunmadığını belirler.
CMFCToolBarButton::IsLastInGroup	Düğmenin düğme grubundaki son konumda olup olmadığını belirtir.
CMFCToolBarButton::IsLocked	Düğmenin kilitli (özelleştirilebilir olmayan) bir araç çubuğunda olup olmadığını belirler.
CMFCToolBarButton::IsOwnerOf	Düğmenin sağlanan pencere tutamacının sahibi olup olmadığını belirler.
CMFCToolBarButton::IsVisible	Araç çubuğu düğmesinin görünür olup olmadığını belirler.
CMFCToolBarButton::IsWindowVisible	Düğmenin temel pencere tutamacının görünür olup olmadığını belirler.
CMFCToolBarButton::NotifyCommand	Düğmenin WM_COMMAND iletisini işleyip işlemediğini belirtir.
CMFCToolBarButton::OnAddToCustomizePage	Düğme bir Özelleştir iletişim kutusuna eklendiğinde çerçeve tarafından çağrılır .
CMFCToolBarButton::OnBeforeDrag	Düğmenin sürüklenip sürüklenemeyeceğini belirtir.
CMFCToolBarButton::OnBeforeDrop	Kullanıcının düğmeyi hedef araç çubuğuna bırakıp bırakamayacağını belirtir.
CMFCToolBarButton::OnCalculateSize	Belirtilen cihaz bağlamı ve yerleştirme durumu için düğmenin boyutunu hesaplamak için çerçeve tarafından çağrılır.
CMFCToolBarButton::OnCancelMode	WM_CANCELMODE iletisini işlemek için çerçeve tarafından çağrılır.
CMFCToolBarButton::OnChangeParentWnd	Düğme yeni bir araç çubuğuna eklendiğinde çerçeve tarafından çağrılır.
CMFCToolBarButton::OnClick	Kullanıcı fare düğmesine tıkladığında çerçeve tarafından çağrılır.
CMFCToolBarButton::OnClickUp	Kullanıcı fare düğmesini serbest bıraktığında çerçeve tarafından çağrılır.
CMFCToolBarButton::OnContextHelp	Üst araç çubuğu bir WM_HELPHITTEST iletisini işlediğinde çerçeve tarafından çağrılır.
CMFCToolBarButton::OnCtlColor	Üst araç çubuğu bir WM_CTLCOLOR iletisini işlediğinde çerçeve tarafından çağrılır.
CMFCToolBarButton::OnCustomizeMenu	Uygulama üst araç çubuğunda bir kısayol menüsü görüntülendiğinde düğmenin sağlanan menüyü değiştirmesine izin verir.
CMFCToolBarButton::OnDblClk	Üst araç çubuğu bir WM_LBUTTONDBLCLK iletisini işlediğinde çerçeve tarafından çağrılır.
CMFCToolBarButton::OnDraw	Belirtilen stilleri ve seçenekleri kullanarak düğmeyi çizmek için çerçeve tarafından çağrılır.
CMFCToolBarButton::OnDrawOnCustomizeList	Özelleştir iletişim kutusunun Komutlar bölmesindeki düğmeyi çizmek için çerçeve tarafından çağrılır.
CMFCToolBarButton::OnGetCustomToolTipText	Düğmenin özel araç ipucu metnini almak için çerçeve tarafından çağrılır.
CMFCToolBarButton::OnGlobalFontsChanged	Genel yazı tipi değiştiğinde çerçeve tarafından çağrılır.
CMFCToolBarButton::OnMove	Üst araç çubuğu hareket ettiğinde çerçeve tarafından çağrılır.
CMFCToolBarButton::OnShow	Düğme görünür veya görünmez hale geldiğinde çerçeve tarafından çağrılır.
CMFCToolBarButton::OnSize	Üst araç çubuğu boyutunu veya konumunu değiştirdiğinde çerçeve tarafından çağrılır ve bu değişiklik düğmenin boyutunu değiştirmesini gerektirir.
CMFCToolBarButton::OnToolHitTest	Üst araç çubuğunun bir noktanın düğmenin sınırlayıcı dikdörtgeninde olup olmadığını belirlemesi gerektiğinde çerçeve tarafından çağrılır.
CMFCToolBarButton::OnUpdateToolTip	Üst araç çubuğu araç ipucu metnini güncelleştirdiğinde çerçeve tarafından çağrılır.
CMFCToolBarButton::P repareDrag	Düğme sürükle ve bırak işlemi gerçekleştirmek üzereyken çerçeve tarafından çağrılır.
CMFCToolBarButton::Rect	Düğmenin sınırlayıcı dikdörtgenini alır.
CMFCToolBarButton::ResetImageToDefault	Düğmeyle ilişkili görüntüyü varsayılan değere ayarlar.
CMFCToolBarButton::SaveBarState	Araç çubuğu düğmesinin durumunu kaydeder.
CMFCToolBarButton::Serialize	Bu nesneyi bir arşivden okur veya bir arşive yazar. (Geçersiz Kılmalar CObject::Serialize.)
CMFCToolBarButton::SetACCData	Sağlanan CAccessibilityData nesneyi araç çubuğu düğmesinden erişilebilirlik verileriyle doldurur.
CMFCToolBarButton::SetClipboardFormatName	Genel pano biçimini yeniden adlandırır.
CMFCToolBarButton::SetImage	Düğmenin görüntü dizinini ayarlar.
CMFCToolBarButton::SetProtectedCommands	Kullanıcının özelleştiremeyeceği komutların listesini ayarlar.
CMFCToolBarButton::SetRadio	Bir düğme işaretli durumunu değiştirdiğinde çerçeve tarafından çağrılır.
CMFCToolBarButton::SetRect	Düğmenin sınırlayıcı dikdörtgenini ayarlar.
CMFCToolBarButton::SetStyle	Düğmenin stilini ayarlar.
CMFCToolBarButton::SetVisible	Düğmenin görünür olup olmadığını belirtir.
CMFCToolBarButton::Show	Düğmeyi gösterir veya gizler.

Veri Üyeleri

Veri Akışı Adı	Açıklama
CMFCToolBarButton::m_bImage	Düğmede görüntü görüntülenip görüntülenmeyeceğini belirtir.
CMFCToolBarButton::m_bText	Düğmede bir metin etiketinin görüntülenip görüntülenmeyeceğini belirtir.
CMFCToolBarButton::m_bTextBelow	Düğmedeki resmin altında metin etiketinin görüntülenip görüntülenmeyeceğini belirtir.
CMFCToolBarButton::m_bUserButton	Düğmenin kullanıcı tanımlı bir görüntüye sahip olup olmadığını belirtir.
CMFCToolBarButton::m_bWholeText	Düğmenin sınırlayıcı dikdörtgene sığmasa bile tam metin etiketini görüntüleyip görüntülemeyeceğini belirtir.
CMFCToolBarButton::m_bWrap	Ayırıcının yanındaki düğmenin sonraki satıra yerleştirilip yerleştirilmeyeceğini belirtir.
CMFCToolBarButton::m_bWrapText	Çok satırlı metin etiketlerinin etkinleştirilip etkinleştirilmediğini belirtir.
CMFCToolBarButton::m_nID	Düğmenin komut kimliği.
CMFCToolBarButton::m_nStyle	Düğmenin stili.
CMFCToolBarButton::m_strText	Düğmenin metin etiketi.

Açıklamalar

CMFCToolbarButton Nesne, araç çubuğunda bulunan bir denetimdir. Davranışı sıradan bir düğmeninkine benzer. Bu nesneye bir resim ve metin etiketi atayabilirsiniz. Araç çubuğu düğmesinin komut kimliği de olabilir. Kullanıcı araç çubuğu düğmesine tıkladığında, çerçeve bu kimliğin belirttiği komutu yürütür.

Genellikle araç çubuğu düğmeleri özelleştirilebilir: Kullanıcı düğmeleri bir araç çubuğundan diğerine sürükleyebilir, metin etiketlerini ve resimleri kopyalayabilir, yapıştırabilir, silebilir ve düzenleyebilir. Kullanıcının araç çubuğunu özelleştirmesini önlemek için araç çubuğunu iki yoldan biriyle kilitleyebilirsiniz. CMFCToolBar::LoadToolBar çağrısı yaparken bayrağı TRUE olarak ayarlayın bLocked veya CMFCToolBarButton::SetProtectedCommands yöntemini kullanarak tek bir düğmenin komut kimliğini korumalı komutların genel listesine ekleyin.

CMFCToolBarButton nesneler, uygulamadaki araç çubuğu görüntülerinin genel koleksiyonlarındaki görüntüleri görüntüler. Bu koleksiyonlar üst araç çubuğu olan CMFCToolBar Sınıfı tarafından korunur. Daha fazla bilgi için bkz . CMFCToolBarImages Sınıfı.

Kullanıcı bir araç çubuğu düğmesine tıkladığında, üst araç çubuğu fare iletisini işler ve düğmeye uygun eylemleri iletir. Düğmenin geçerli bir komut kimliği varsa, üst araç çubuğu WM_COMMAND iletisini üst çerçeveye gönderir.

CMFCToolBarButton sınıfı, CMFCToolBarMenuButton Sınıfı, CMFCToolBarEditBoxButton Sınıfı ve CMFCToolBarComboBoxButton Sınıfı gibi diğer araç çubuğu düğme sınıfları için temel sınıftır.

Örnek

Aşağıdaki örnekte, sınıfındaki çeşitli yöntemleri kullanarak bir CMFCToolBarButton nesnenin nasıl yapılandırılır gösterilmektedir CMFCToolBarButton . Örnekte fare ve klavye girişini etkinleştirme, düğmenin görüntü dizinini ayarlama, düğmenin sınırlayıcı dikdörtgenini ayarlama ve düğmenin görünür olmasını sağlama işlemleri gösterilmektedir. Bu kod parçacığı, Sekme Denetimi örneğinin bir parçasıdır.

CMFCToolBarButton *pOffice2007 = NULL;
int nIndex = -1;

for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
{
   // CMFCToolBar m_wndToolBarTheme
   nIndex = m_wndToolBarTheme.CommandToIndex(uiCmd);

   CMFCToolBarButton *pButton = m_wndToolBarTheme.GetButton(nIndex);

   if (pButton != NULL)
   {
      pOffice2007 = pButton;
      break;
   }
}

pOffice2007->EnableWindow();
pOffice2007->SetImage(1);
pOffice2007->SetRect(CRect(1, 1, 1, 1));
pOffice2007->SetVisible();
pOffice2007->Show(true);

Devralma Hiyerarşisi

CObject

CMFCToolBarButton

Gereksinimler

Üst bilgi: afxtoolbarbutton.h

CMFCToolBarButton::CanBeDropped

Kullanıcının özelleştirme sırasında bir düğmeyi araç çubuğuna veya menüye yerleştirip konumlandıramayacağını belirtir.

virtual BOOL CanBeDropped(CMFCToolBar* pToolbar);

Parametreler

pToolbar
[in] Kullanılma -yan.

Dönüş Değeri

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

Açıklamalar

Varsayılan olarak, özelleştirilebilir (yani kilitli olmayan) her araç çubuğuna bir araç çubuğu düğmesi bırakılabilir.

Bu yöntemin varsayılan uygulaması TRUE döndürür. Kullanıcının düğmeyi yeniden konumlandırmasını engellemek istiyorsanız bu yöntemi geçersiz kılın ve YANLIŞ döndürebilirsiniz.

CMFCToolBarButton::CanBeStored

Düğmenin depolanıp depolanamayacağını belirler.

virtual BOOL CanBeStored() const;

Dönüş Değeri

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

Açıklamalar

Çerçeve, düğmenin sürükle ve bırak işlemine katılıp katılamayacağını belirlemek için bu yöntemi kullanır.

Varsayılan uygulama TRUE döndürür. Düğmeniz sürükleyip bırakma işleminin bir parçası olarak depolanamıyorsa bu yöntemi geçersiz kılın. Sürükle ve bırak işlemleri hakkında daha fazla bilgi için bkz . OLE sürükle ve bırak.

CMFCToolBarButton::CanBeStretched

Kullanıcının özelleştirme sırasında düğmeyi uzatıp uzatamayacağını belirtir.

virtual BOOL CanBeStretched() const;

Dönüş Değeri

Bu yöntem YANLIŞ döndürür.

Açıklamalar

Bu yöntem, düğmenin özelleştirme modunda esnetilip genişletilemeyeceğini belirlemek için çerçeve tarafından kullanılır.

Bu yöntemin varsayılan uygulaması FALSE döndürür. Birleşik giriş kutusu veya kaydırıcı gibi değişken genişlikli bir denetim için TRUE döndürmek için bu yöntemi geçersiz kılın.

Özelleştirme modu hakkında daha fazla bilgi için bkz . CMFCToolBar::SetCustomizeMode.

CMFCToolBarButton::CMFCToolBarButton

Bir CMFCToolBarButton nesneyi oluşturur ve başlatır.

CMFCToolBarButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE,
    BOOL bLocked=FALSE);

Parametreler

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

iImage
[in] Resim koleksiyonundaki düğmenin görüntü dizini.

lpszText
[in] Düğmenin metin etiketi. NULL olabilir.

bUserButton
[in] Düğmenin kullanıcı tanımlı olup olmadığını belirleyen boole değeri. Bu parametre TRUE ise düğme kullanıcı tanımlıdır. Aksi takdirde, düğme görüntüsü bir kaynaktan yüklenir.

Engellenmiş
[in] Düğmenin özelleştirilip özelleştirilemeyeceğini belirleyen boole değeri. Bu parametre TRUE ise, düğme özelleştirilemez. Aksi takdirde düğme özelleştirilebilir.

CMFCToolBarButton::CompareWith

Bu örneği sağlanan CMFCToolBarButton nesneyle karşılaştırır.

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parametreler

Diğer
[in] Bu örnekle karşılaştıracak nesneye başvuru.

Dönüş Değeri

Sağlanan nesne bu örneğin değerine eşitse sıfır olmayan; aksi takdirde, 0.

Açıklamalar

Varsayılan uygulama, sağlanan nesnenin komut kimliğinin bu örneğin komut kimliğine eşit olup olmadığını belirler. İki CMFCToolBarButton nesnenin eşit olup olmadığını belirlemek için ek işlem yapmanız gerekiyorsa bu yöntemi geçersiz kılın.

CMFCToolBarButton::CopyFrom

Başka bir araç çubuğu düğmesinin özelliklerini geçerli düğmeye kopyalar.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parametreler

Src
[in] Kopyalanacak kaynak düğmeye başvuru.

Açıklamalar

Başka bir araç çubuğu düğmesini bu araç çubuğu düğmesine kopyalamak için bu yöntemi çağırabilirsiniz.

CMFCToolBarButton::CreateFromOleData

Sağlanan COleDataObject nesneden bir CMFCToolBarButton nesne oluşturur.

static CMFCToolBarButton* __stdcall CreateFromOleData(COleDataObject* pDataObject);

Parametreler

pDataObject
[in] Kaynak OLE veri nesnesi.

Dönüş Değeri

Oluşturulan CMFCToolBarButton nesnesi.

Açıklamalar

Bu yöntem, çeşitli biçimlerde veri aktarımı gerçekleştirmek için çerçeve tarafından kullanılır. Örneğin, CMFCOutlookBarPane::OnDragOver yöntemi sürükle ve bırak işlemlerini gerçekleştirmek için bu yöntemi kullanır.

CMFCToolBarButton::EnableWindow

Fare ve klavye girişini etkinleştirir veya devre dışı bırakır.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parametreler

bEnable
[in] Girişi etkinleştirmek için bu parametreyi TRUE veya girişi devre dışı bırakmak için FALSE olarak ayarlayın.

Açıklamalar

Bu yöntem, girişi etkinleştirmek veya devre dışı bırakmak için işlevini çağırır EnableWindow . Daha fazla bilgi için bkz . Windows SDK'sında EnableWindow .

CMFCToolBarButton::ExportToMenuButton

Araç çubuğu düğmesindeki metni bir menüye kopyalar.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parametreler

menuButton
[in] Hedef menü düğmesine başvuru.

Dönüş Değeri

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

Açıklamalar

Çerçeve, bir araç çubuğu düğmesindeki metni menü düğmesine kopyalamak için bu yöntemi çağırır. Varsayılan uygulama, düğmenin metin etiketini kopyalar. Metin etiketi boşsa, bu yöntem düğmenin araç ipucu metnini kopyalar.

Bu yöntemin varsayılan uygulaması TRUE döndürür. Çerçeve, CMFCToolbarButton öğesinden türetilen bir nesneyi menü düğmesine dönüştürdüğünde ek eylemler yapmak istiyorsanız bu yöntemi geçersiz kılın.

CMFCToolBarButton::GetClipboardFormat

Uygulamanın genel pano biçimini alır.

static CLIPFORMAT __stdcall GetClipboardFormat();

Dönüş Değeri

Uygulamanın genel CLIPFORMAT değeri.

Açıklamalar

Çerçeve, OLE veri aktarımı işlemlerinin pano biçimini almak için bu yöntemi çağırır. Örneğin, CMFCToolBarButton::CreateFromOleData yöntemi, kaynak OLE veri nesnesinden veri kopyalamak için bu yöntemi kullanır.

Bu yöntem, bu yöntem ilk kez çağrıldığında genel CLIPFORMAT değerini ayarlar. Bu yönteme yapılan sonraki tüm çağrılar bu değeri döndürür.

Uygulamalar arasında sürükle ve bırak işlemlerinin gerçekleşmesine izin vermek için CMFCToolBarButton::SetClipboardFormatName yöntemini çağırın.

MFC'deki panolar hakkında daha fazla bilgi için bkz . Pano.

CMFCToolBarButton::GetHwnd

Araç çubuğu düğmesiyle ilişkili pencere tutamacını alır.

virtual HWND GetHwnd();

Dönüş Değeri

Araç çubuğu düğmesiyle ilişkilendirilmiş pencere tutamacı veya araç çubuğu düğmesinin ilişkili pencere tutamacı yoksa NULL.

Açıklamalar

Bu yöntemin varsayılan uygulaması NULL döndürür. Belirli denetiminizin pencere tutamacını döndürmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::GetImage

Düğmenin görüntü dizinini alır.

int GetImage() const;

Dönüş Değeri

Bu düğmeyle ilişkilendirilmiş görüntünün dizini.

Açıklamalar

Düğmenin kullanıcı tanımlı bir görüntüsü varsa (yani, oluşturucuda bUserButton TRUE ise), döndürülen dizin kullanıcı tanımlı görüntüler koleksiyonunda bir görüntü belirtir (bkz. CMFCToolBar::GetUserImages). Aksi takdirde, dizin bir kaynak dosyasından yüklenen görüntülerin koleksiyonunda bir görüntü belirtir (bkz . CMFCToolBar::GetImages). Kaynak dosyaları hakkında daha fazla bilgi için bkz . Kaynak Dosyalarıyla Çalışma.

CMFCToolBarButton::GetInvalidateRect

Düğmenin istemci alanının yeniden çizilmesi gereken bölgesini alır.

virtual const CRect GetInvalidateRect() const;

Dönüş Değeri

CRect Yeniden çizilmesi gereken bölgeyi belirten nesne.

Açıklamalar

Bu yöntemin varsayılan uygulaması istemci alanının tamamını döndürür. Farklı bir alanın yeniden çizilmesi istiyorsanız bu yöntemi geçersiz kılın.

CMFCToolBarButton::GetParentWnd

Düğmenin üst penceresini alır.

CWnd* GetParentWnd() const;

Dönüş Değeri

Düğmenin üst penceresi.

CMFCToolBarButton::GetProtectedCommands

Kullanıcının özelleştiremediği komutların listesini alır.

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

Dönüş Değeri

Korumalı komutların listesi.

Açıklamalar

Özelleştirme modunda, çerçeve korunan araç çubuğu düğmesi komutlarını devre dışı bırakır. Kullanıcı, devre dışı bırakılmış araç çubuğu düğmelerinde sürükle ve bırak ve düzenle işlemlerini gerçekleştiremez.

Korumalı komutların listesini tanımlamak için CMFCToolBarButton::SetProtectedCommands yöntemini kullanın.

CMFCToolBarButton::GetTextSize

Düğme metninin boyutunu alır.

SIZE GetTextSize() const;

Dönüş Değeri

Düğme metninin boyutunu piksel cinsinden içeren bir SIZE nesnesi.

CMFCToolBarButton::HasFocus

Düğmenin geçerli giriş odağına sahip olup olmadığını belirler.

virtual BOOL HasFocus() const;

Dönüş Değeri

Giriş odağı düğmedeyse sıfır olmayan; aksi takdirde 0.

Açıklamalar

Düğme giriş odağına sahipse veya giriş odağını içeren pencerenin alt veya alt penceresiyse, bu yöntemin varsayılan uygulaması sıfırdan farklı bir değer döndürür. Bu davranışı özelleştirmek için bu işlevi geçersiz kılabilirsiniz.

CMFCToolBarButton::HaveHotBorder

Kullanıcı düğmeyi seçtiğinde düğmenin kenarlarının görüntülenip görüntülenmeyeceğini belirler.

virtual BOOL HaveHotBorder() const;

Dönüş Değeri

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

Açıklamalar

Çerçeve, bir kullanıcı seçtiğinde araç çubuğu düğmesinin kenarlığını görüntüleyip görüntülemeyeceğini belirlemek için bu yöntemi çağırır.

Varsayılan uygulama TRUE döndürür. Bu davranışı özelleştirmek için bu yöntemi geçersiz kılabilirsiniz.

CMFCToolBarButton::IsDrawImage

Düğmede görüntü görüntülenip görüntülenmeyeceğini belirler.

BOOL IsDrawImage() const;

Dönüş Değeri

Düğmede bir resim görüntüleniyorsa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Araç çubuğu düğmesinde ilişkilendirilmiş görüntü yoksa ( CMFCToolBarButton::GetImage işlevi -1 döndürür) veya CMFCToolBarButton::m_bImage YANLIŞ olarak ayarlandıysa , bu yöntem YANLIŞ döndürür.

CMFCToolBarButton::IsDrawText

Düğmede bir metin etiketinin görüntülenip görüntülenmeyeceğini belirler.

BOOL IsDrawText() const;

Dönüş Değeri

Bir metin etiketi görüntüleniyorsa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Araç çubuğu düğmesinin ilişkili metin etiketi yoksa ( CMFCToolBarButton::m_strText boşsa) veya CMFCToolBarButton::m_bText YANLIŞ olarak ayarlanmışsa, bu yöntem YANLIŞ döndürür.

CMFCToolBarButton::IsDroppedDown

Düğmenin bir alt menü görüntüleyip görüntülemeyeceğini belirler.

virtual BOOL IsDroppedDown() const;

Dönüş Değeri

Bu yöntem YANLIŞ döndürür.

Açıklamalar

Bu yöntemin varsayılan uygulaması FALSE döndürür. Denetiminiz bir alt menü görüntülüyorsa TRUE döndürmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::IsEditable

Düğmenin özelleştirilip özelleştirilemeyeceğini belirler.

virtual BOOL IsEditable() const;

Dönüş Değeri

Bir düğme kullanıcı tarafından özelleştirilebiliyorsa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Çerçeve, kullanıcının sürükleyip bırakma veya düzenleme işlemlerini kullanarak araç çubuğu düğmesini özelleştirip özelleştiremeyeceğini belirlemek için bu yöntemi çağırır.

Düğmenin komut kimliği standart bir komutsa (işlevi çağırarak IsStandardCommand bunu belirleyebilirsiniz) veya komut kimliği korumalı komutlar listesindeyse varsayılan uygulama FALSE döndürür. Korumalı komutlar hakkında daha fazla bilgi için bkz . CMFCToolBarButton::GetProtectedCommands ve CMFCToolBarButton::SetProtectedCommands.

Davranışını özelleştirmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::IsExtraSize

Düğmenin genişletilmiş kenarlıkla görüntülenip görüntülenemeyeceğini belirler.

virtual BOOL IsExtraSize() const;

Dönüş Değeri

Araç çubuğu düğmesi genişletilmiş kenarlıkla görüntülenebiliyorsa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Çeşitli dış görünümler, araç çubuğu düğmelerinin kenarlıkları için fazladan boyut kullanır (örneğin, yuvarlak düğmeler).

Kullanıcı bu düğmeyi bir araç çubuğundan diğerine taşırsa, çerçeve CMFCToolBarButton::OnChangeParentWnd yöntemini çağırır. CMFCToolBarButton::OnChangeParentWnd yöntemi, yeni üst araç çubuğunun ek boyut bayrağını ayarlar (daha fazla bilgi için bkz. CMFCToolBar::IsButtonExtraSizeAvailable).

CMFCToolBarButton::IsFirstInGroup

Düğmenin, düğme grubundaki ilk konumda olup olmadığını belirler.

virtual BOOL IsFirstInGroup() const;

Dönüş Değeri

Düğme, düğme grubundaki ilk düğmeyse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Bu yöntem, bir düğme grubunu aynı satıra konumlandırılmış ve ayırıcılarla veya araç çubuğunun kenarlarıyla sınırlanmış bir düğme kümesi olarak tanımlar. Araç çubuğu düğmesi Özelleştir düğmesine başvuruyorsa bu yöntem YANLIŞ döndürür. Özelleştir düğmesi hakkında daha fazla bilgi için bkz. CMFCToolBar::GetCustomizeButton.

Düğmenin düğme grubundaki son konumda olup olmadığını belirlemek için CMFCToolBarButton::IsLastInGroup yöntemini çağırın.

CMFCToolBarButton::IsHidden

Düğmenin gizli olup olmadığını belirler.

BOOL IsHidden() const;

Dönüş Değeri

Düğme gizliyse sıfır olmayan (görünmez); aksi takdirde 0.

Açıklamalar

Çerçeve, araç çubuğu düğmesinin görünür olup olmadığını belirlemek için üst araç çubuğu esnetildiğinde bu yöntemi çağırır.

CMFCToolBarButton::SetVisible yöntemini kullanarak düğmeyi görünmez olacak şekilde ayarlarsanız, araç çubuğu düğmesinin görünür olup olmadığını belirlemek için CMFCToolBarButton::IsVisible kullanın.

Varsayılan olarak, tüm araç çubuğu düğmeleri görünür durumdadır. Araç çubuğu düğmelerini gizlemek veya göstermek için CMFCToolBarButton::Show yöntemini kullanın.

CMFCToolBarButton::IsHorizontal

Düğmenin yatay bir araç çubuğunda bulunup bulunmadığını belirler.

BOOL IsHorizontal() const;

Dönüş Değeri

Yatay bir araç çubuğunda bir araç çubuğu düğmesi bulunuyorsa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Çerçeve, araç çubuğu düğmelerinin düzenini belirlemek için bu yöntemi çağırır.

Bu yöntem veri üyesini m_bHorz döndürür. Veri üyesinin m_bHorz varsayılan değeri TRUE'dur; CMFCToolBarButton::OnDraw yöntemine yapılan her çağrıda sıfırlanır.

CMFCToolBarButton::IsLastInGroup

Düğmenin düğme grubundaki son konumda olup olmadığını belirtir.

virtual BOOL IsLastInGroup() const;

Dönüş Değeri

Düğme, düğme grubundaki son düğmeyse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Bu yöntem, bir düğme grubunu aynı satıra yerleştirilmiş ve ayırıcılarla veya araç çubuğunun kenarlarıyla sınırlanmış bir düğme kümesi olarak tanımlar Bu yöntem, araç çubuğu düğmesinin üst araç çubuğu yoksa veya araç çubuğu düğmesi Özelleştir düğmesine başvuruyorsa YANLIŞ döndürür. Özelleştir düğmesi hakkında daha fazla bilgi için bkz. CMFCToolBar::GetCustomizeButton.

Düğmenin düğme grubundaki ilk konumda olup olmadığını belirlemek için CMFCToolBarButton::IsFirstInGroup yöntemini çağırın.

CMFCToolBarButton::IsLocked

Düğmenin kilitli (özelleştirilebilir olmayan) bir araç çubuğunda olup olmadığını belirler.

BOOL IsLocked() const;

Dönüş Değeri

Düğme kilitli bir araç çubuğundaysa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Çerçeve, kullanıcının sürükleyip bırakma veya düzenleme işlemlerini kullanarak araç çubuğu düğmesini özelleştirip özelleştiremeyeceğini belirlemek için bu yöntemi çağırır. CMFCToolBar::LoadToolBar yöntemini kullanarak üst araç çubuğunda kilitli özniteliği ayarlayın. Çerçeve, bu özniteliğin değerini üst araç çubuğuna ekleyen her araç çubuğu düğmesinin ( CMFCToolbarButton) oluşturucusuna geçirir.

CMFCToolBarButton::IsOwnerOf

Düğmenin sağlanan pencere tutamacının sahibi olup olmadığını belirler.

virtual BOOL IsOwnerOf(HWND hwnd);

Parametreler

hwnd
[in] Pencere tutamacı.

Dönüş Değeri

Düğme sağlanan pencere tutamacının sahibiyse sıfır olmayan; aksi takdirde 0.

Açıklamalar

hwnd doğrudan pencere tutamacına başvuruyorsa veya düğmeyle ilişkilendirilmiş pencere tutamacının alt öğesiyse bu yöntem sıfır olmayan döndürür. Hwnd NULL ise bu yöntem 0 döndürür.

CMFCToolBarButton::IsVisible

Araç çubuğu düğmesinin görünür olup olmadığını belirler.

BOOL IsVisible() const;

Dönüş Değeri

Araç çubuğu düğmesi görünür durumdaysa sıfır olmayan; aksi takdirde 0.

Açıklamalar

CMFCToolBarButton::SetVisible yöntemini kullanarak araç çubuğu düğmesini gösterebilir veya gizleyebilirsiniz. Üst araç çubuğunun düzenini yeniden hesaplamak için CMFCToolBarButton::SetVisible çağrısı yaptıktan sonra üst araç çubuğunda CPane::AdjustSizeImmediate yöntemini çağırın.

CMFCToolBarButton::IsWindowVisible

Düğmenin temel pencere tutamacının görünür olup olmadığını belirler.

virtual BOOL IsWindowVisible();

Dönüş Değeri

Düğmenin temel pencere tutamacı görünür durumdaysa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Temel alınan pencere tutamacının stiller özniteliği WS_VISIBLE stilini içeriyorsa bu yöntem sıfır olmayan bir değer döndürür. Düğmenin temel pencere tutamacı NULL ise bu yöntem YANLIŞ döndürür.

CMFCToolBarButton::m_bImage

Düğmede görüntü görüntülenip görüntülenmeyeceğini belirtir.

BOOL m_bImage;

Açıklamalar

Bu veri üyesi TRUE olarak ayarlanırsa, çerçeve araç çubuğu düğmesiyle ilişkili görüntüyü görüntüler; aksi takdirde çerçeve görüntüyü görüntülemez. Bu üye, CMFCToolBarButton::m_bImage yönteminin dönüş değerini etkiler.

CMFCToolBarButton::m_bText

Düğmede bir metin etiketinin görüntülenip görüntülenmeyeceğini belirtir.

BOOL m_bText;

Açıklamalar

Bu veri üyesi TRUE olarak ayarlanırsa, çerçeve araç çubuğu düğmesinin metin etiketini görüntüler; aksi takdirde çerçeve metin etiketini görüntülemez. Bu üye, CMFCToolBarButton::m_bText yönteminin dönüş değerini etkiler.

CMFCToolBarButton::m_bTextBelow

Düğmedeki resmin altında metin etiketinin görüntülenip görüntülenmeyeceğini belirtir.

BOOL m_bTextBelow;

Açıklamalar

Bu üye değişkeni TRUE olarak ayarlanırsa, çerçeve görüntünün altında düğmenin metnini görüntüler. Bu üyenin varsayılan değeri YANLIŞ'tır.

CMFCToolBarButton::m_bUserButton

Düğmenin kullanıcı tanımlı bir görüntüye sahip olup olmadığını belirtir

BOOL m_bUserButton;

Açıklamalar

Düğmeyle ilişkilendirilmiş kullanıcı tanımlı bir görüntü olduğunda bu veri üyesi TRUE olarak ayarlanır.

CMFCToolBarButton::m_bWholeText

Düğmenin sınırlayıcı dikdörtgene sığmasa bile tam metin etiketini görüntüleyip görüntülemeyeceğini belirtir.

BOOL m_bWholeText;

Açıklamalar

Bu veri üyesi TRUE olarak ayarlanırsa, çerçeve düğmeyi büyüleyerek tam metin etiketini görüntüler. Aksi takdirde çerçeve, metin etiketine bir üç nokta ( ...) keserek ekler.

CMFCToolBarButton::m_bWrap

Ayırıcının yanındaki düğmenin sonraki satıra yerleştirilip yerleştirilmeyeceğini belirtir.

BOOL m_bWrap;

Açıklamalar

Çerçeve, araç çubuğu düğmesi geçerli satıra sığmadığında veya bir düzen belirttiğinizde (örneğin, satır başına belirli sayıda araç çubuğu düğmesi) bu veri üyesini TRUE olarak ayarlar.

Bu veri üyesi TRUE olarak ayarlanmışsa ve araç çubuğu yatay olarak yerleştirilmişse veya kayansa, çerçeve bu düğmeyi bir sonraki satıra yerleştirir.

Bu veri üyesinin varsayılan değeri YANLIŞ'tır.

CMFCToolBarButton::m_bWrapText

Çok satırlı metin etiketlerinin etkinleştirilip etkinleştirilmediğini belirtir.

AFX_IMPORT_DATA static BOOL m_bWrapText;

Açıklamalar

Bu statik üye değişkeni TRUE ise, çerçeve tüm araç çubuklarının araç çubuğu düğmelerinde çok satırlı metin etiketlerini görüntülemesini sağlar.

Bu veri üyesinin varsayılan değeri YANLIŞ'tır.

CMFCToolBarButton::m_nID

Düğmenin komut kimliği.

UINT m_nID;

Açıklamalar

-1 komut kimliği, düğmenin ayırıcı olduğunu gösterir. Tüm düğme ayırıcıları TBBS_SEPARATOR stiline sahiptir. Düğme stilleri hakkında daha fazla bilgi için bkz . CMFCToolBarButton::m_nStyle .

CMFCToolBarButton::m_nStyle

Düğmenin stili.

UINT m_nStyle;

Açıklamalar

Kullanılabilir araç çubuğu düğmesi stillerinin listesi için bkz . Araç Çubuğu Denetim Stilleri .

CMFCToolBarButton::m_strText

Düğmenin metin etiketi.

CString m_strText;

Açıklamalar

Bu veri üyesi düğmenin metin etiketini içerir. Metin etiketi boş olabilir.

CMFCToolBarButton::NotifyCommand

Düğmenin WM_COMMAND iletisini işleyip işlemediğini belirtir.

virtual BOOL NotifyCommand(int iNotifyCode);

Parametreler

iNotifyCode
[in] komutuyla ilişkili bildirim iletisi.

Dönüş Değeri

Bu yöntem YANLIŞ döndürür.

Açıklamalar

Çerçeve, üst pencereye bir WM_COMMAND iletisi göndermek üzereyken bu yöntemi çağırır.

Varsayılan olarak, bu yöntem YANLIŞ döndürür. WM_COMMAND iletisini işlemek istiyorsanız TRUE veya üst araç çubuğunun iletiyi işlemesi gerektiğini belirtmek için FALSE döndürmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnAddToCustomizePage

Düğme bir Özelleştir iletişim kutusuna eklendiğinde çerçeve tarafından çağrılır .

virtual void OnAddToCustomizePage();

Açıklamalar

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz. Düğme Özelleştir iletişim kutusuna eklendiğinde bazı eylemler gerçekleştirmek istiyorsanız bu yöntemi geçersiz kılın .

CMFCToolBarButton::OnBeforeDrag

Düğmenin sürüklenip sürüklenemeyeceğini belirtir.

virtual BOOL OnBeforeDrag() const;

Dönüş Değeri

Düğme sürüklenebiliyorsa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Kullanıcı düğmeyi sürüklemeye başlamadan önce çerçeve bu yöntemi çağırır.

Bu yöntemin varsayılan uygulaması TRUE döndürür. Düğmenin sürüklenmesi devre dışı bırakmak için FALSE döndürmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnBeforeDrop

Kullanıcının düğmeyi hedef araç çubuğuna bırakıp bırakamayacağını belirtir.

virtual BOOL OnBeforeDrop(CMFCToolBar* pTarget);

Parametreler

pTarget
[in] Sürükle ve bırak işleminin hedefi.

Dönüş Değeri

Düğme sağlanan hedef araç çubuğuna bırakılabilirse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Düğme bir araç çubuğuna bırakılmadan önce çerçeve bu yöntemi çağırır.

Bu yöntemin varsayılan uygulaması TRUE döndürür. Belirtilen hedefte bırakma işlemini devre dışı bırakmak için FALSE döndürmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnCalculateSize

Belirtilen cihaz bağlamı ve yerleştirme durumu için düğmenin boyutunu hesaplamak için çerçeve tarafından çağrılır.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parametreler

pDC
[in] Düğmeyi görüntüleyen cihaz bağlamı.

sizeDefault
[in] Düğmenin varsayılan boyutu.

bHorz
[in] Üst araç çubuğunun takma birimi durumu. Araç çubuğu yatay olarak yerleştirilmişse veya kayansa bu parametre TRUE, dikey olarak yerleştirilmişse YANLIŞ parametresidir.

Dönüş Değeri

SIZE Düğmenin boyutlarını piksel cinsinden içeren bir yapı.

Açıklamalar

Çerçeve, belirtilen cihaz bağlamı ve takma birimi durumu için araç çubuğu düğmesinin boyutunu belirlemek için bu yöntemi çağırır.

Varsayılan uygulama metin ve görüntü boyutlarını (görüntüleniyorsa), metin ve görüntü konumlarını (resmin altındaki veya sağ tarafındaki metin) ve araç çubuğu takma birimi durumunu dikkate alır.

Standart olmayan bir düğmenin (örneğin, düzenleme kutusu düğmesi) boyutunu sağlamak istiyorsanız bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnCancelMode

WM_CANCELMODE iletisini işlemek için çerçeve tarafından çağrılır.

virtual void OnCancelMode();

Açıklamalar

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz. WM_CANCELMODE iletisini işlemek istiyorsanız bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnChangeParentWnd

Düğme yeni bir araç çubuğuna eklendiğinde çerçeve tarafından çağrılır.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parametreler

pWndParent
[in] Yeni üst pencere.

Açıklamalar

Düğme, örneğin kullanıcı bir araç çubuğundan başka bir araç çubuğuna sürüklediğinde bir araç çubuğuna eklenir.

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz.

CMFCToolBarButton::OnClick

Kullanıcı fare düğmesine tıkladığında çerçeve tarafından çağrılır.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay=TRUE);

Parametreler

pWnd
[in] Araç çubuğu düğmesinin üst penceresi.

bDelay
[in] İletinin gecikmeli olarak işlenmesi gerekiyorsa TRUE.

Dönüş Değeri

Bu yöntem YANLIŞ döndürür.

Açıklamalar

Kullanıcı araç çubuğu düğmesine tıkladığında çerçeve bu yöntemi çağırır.

Varsayılan uygulama hiçbir şey yapmaz ve YANLIŞ döndürür. Düğme tıklama iletisini işlerse sıfır olmayan bir değer döndürmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnClickUp

Kullanıcı fare düğmesini serbest bıraktığında çerçeve tarafından çağrılır.

virtual BOOL OnClickUp();

Dönüş Değeri

Bu yöntem YANLIŞ döndürür.

Açıklamalar

Kullanıcı araç çubuğu düğmesini serbest bıraktığında çerçeve bu yöntemi çağırır.

Varsayılan uygulama hiçbir şey yapmaz ve YANLIŞ döndürür. Düğme tıklama iletisini işlerse sıfır olmayan bir değer döndürmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnContextHelp

Üst araç çubuğu bir WM_HELPHITTEST iletisini işlediğinde çerçeve tarafından çağrılır.

virtual BOOL OnContextHelp(CWnd* pWnd);

Parametreler

pWnd
[in] Araç çubuğu düğmesinin üst penceresi.

Dönüş Değeri

Bu yöntem YANLIŞ döndürür.

Açıklamalar

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz ve YANLIŞ döndürür. Düğme yardım iletisini işlerse sıfır olmayan bir değer döndürmek için bu yöntemi geçersiz kılın.

WM_HELPHITTEST iletisi hakkında daha fazla bilgi için bkz . TN028: Bağlama Duyarlı Yardım Desteği.

CMFCToolBarButton::OnCtlColor

Üst araç çubuğu bir WM_CTLCOLOR iletisini işlediğinde çerçeve tarafından çağrılır.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parametreler

pDC
[in] Düğmeyi görüntüleyen cihaz bağlamı.

nCtlColor
[in] Belirli bir renk bildirimi.

Dönüş Değeri

Çerçevenin düğmenin arka planını boyamak için kullandığı fırça nesnesinin tutamacı.

Açıklamalar

Üst araç çubuğu, Windows denetimi içeren bir araç çubuğu düğmesi için WM_CTLCOLOR iletisini işlediğinde çerçeve bu yöntemi çağırır. Araç çubuğu düğmesi penceresizse çerçeve bu yöntemi çağırmaz.

Araç çubuğu çerçevesi özelleştirme modundayken ve araç çubuğu düğmesinin kilidi açıldığında çerçeve bu yöntemi çağırır. Özelleştirme modu hakkında daha fazla bilgi için bkz . CMFCToolBar::SetCustomizeMode. Araç çubuğu düğmelerini kilitleme hakkında daha fazla bilgi için bkz . CMFCToolBarButton::IsLocked.

Varsayılan uygulama hiçbir şey yapmaz ve NULL döndürür.

CMFCToolBarButton::OnCustomizeMenu

Uygulama üst araç çubuğunda bir kısayol menüsü görüntülendiğinde düğmenin sağlanan menüyü değiştirmesine izin verir.

virtual BOOL OnCustomizeMenu(CMenu* pMenu);

Parametreler

pMenu
[in] Özelleştirebileceğiniz menü.

Dönüş Değeri

Bu yöntem YANLIŞ döndürür.

Açıklamalar

Varsayılan uygulama hiçbir şey yapmaz ve YANLIŞ döndürür. Sağlanan menünün içeriğini değiştirmek istiyorsanız bu yöntemi geçersiz kılın ve sıfır olmayan bir değer döndürebilirsiniz.

CMFCToolBarButton::OnDblClk

Üst araç çubuğu bir WM_LBUTTONDBLCLK iletisini işlediğinde çerçeve tarafından çağrılır.

virtual void OnDblClk(CWnd* pWnd);

Parametreler

pWnd
[in] - Düğmenin üst penceresi.

Açıklamalar

Bu yöntem, üst araç çubuğu bir WM_LBUTTONDBLCLK iletisini işlediğinde yöntemi tarafından CMFCToolBar::OnLButtonDblClk çağrılır.

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz.

CMFCToolBarButton::OnDraw

Belirtilen stilleri ve seçenekleri kullanarak düğmeyi çizmek için çerçeve tarafından çağrılır.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz=TRUE,
    BOOL bCustomizeMode=FALSE,
    BOOL bHighlight=FALSE,
    BOOL bDrawBorder=TRUE,
    BOOL bGrayDisabledButtons=TRUE);

Parametreler

pDC
[in] Düğmeyi görüntüleyen cihaz bağlamı.

Rect
[in] Düğmenin sınırlayıcı dikdörtgeni.

pImages
[in] Düğmeyle ilişkili araç çubuğu görüntülerinin koleksiyonu.

bHorz
[in] Üst araç çubuğunun takma birimi durumu. Düğme yatay olarak yerleştirildiğinde bu parametre TRUE, dikey olarak yerleştirildiğinde YANLIŞ parametresidir.

bCustomizeMode
[in] Araç çubuğunun özelleştirme modunda olup olmadığını belirtir. Bu parametre, araç çubuğu özelleştirme modundayken TRUE, araç çubuğu özelleştirme modunda olmadığında YANLIŞ'tır.

bHighlight
[in] Düğmenin vurgulanıp vurgulu olmadığını belirtir. Düğme vurgulandığında bu parametre TRUE, düğme vurgulanmadığında YANLIŞ parametresidir.

bDrawBorder
[in] Düğmenin kenarlığını görüntüleyip görüntülemeyeceğini belirtir. Bu parametre, düğmenin kenarlığını görüntülemesi gerektiğinde TRUE, kenarlığının görüntülenmemesi gerektiğinde YANLIŞ parametresidir.

bGrayDisabledButtons
[in] Devre dışı düğmeleri gölgelendirmeyi veya devre dışı bırakılan görüntüler koleksiyonunu kullanmayı belirtir. Devre dışı bırakılan düğmelerin gölgeli olması gerektiğinde bu parametre TRUE, devre dışı bırakılan görüntüler koleksiyonunun kullanılması gerektiğinde YANLIŞ parametresidir.

Açıklamalar

Araç çubuğu düğmesi çizimlerini özelleştirmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnDrawOnCustomizeList

Özelleştir iletişim kutusunun Komutlar bölmesindeki düğmeyi çizmek için çerçeve tarafından çağrılır.

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parametreler

pDC
[in] Düğmeyi görüntüleyen cihaz bağlamı.

Rect
[in] Düğmenin sınırlayıcı dikdörtgeni.

bSelected
[in] Düğmenin seçili olup olmadığını belirtir. Bu parametre TRUE ise düğme seçilir. Bu parametre YANLIŞ ise düğme seçilmez.

Dönüş Değeri

Belirtilen cihaz bağlamındaki düğmenin piksel cinsinden genişliği.

Açıklamalar

Bu yöntem, düğme kendisini sahip çizim liste kutusunda görüntülemek üzereyken özelleştirme iletişim kutusu ( Komutlar sekmesi) tarafından çağrılır.

Bu yöntemin varsayılan uygulaması, varsa düğmenin görüntüsünü ve metin etiketini görüntüler. Düğmenin metin etiketi kullanılamıyorsa, yöntem araç ipucu metnini görüntüler.

Özel çizim yapmak için bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnGetCustomToolTipText

Düğmenin özel araç ipucu metnini almak için çerçeve tarafından çağrılır.

virtual BOOL OnGetCustomToolTipText(CString& strToolTip);

Parametreler

strToolTip
[out] CString Özel araç ipucu metnini alan nesne.

Dönüş Değeri

Bu yöntem YANLIŞ döndürür.

Açıklamalar

Çerçeve, araç çubuğu düğmesi için araç ipucu görüntülendiğinde bu yöntemi çağırır. Bu yöntem FALSE döndürürse, çerçeve varsayılan bir araç ipucu kullanır.

Varsayılan uygulama hiçbir şey yapmaz ve YANLIŞ döndürür. Bu yöntemi geçersiz kılın ve araç çubuğu düğmesi için özel araç ipucu metni sağlamak üzere sıfır olmayan bir değer döndürebilirsiniz.

CMFCToolBarButton::OnGlobalFontsChanged

Genel yazı tipi değiştiğinde çerçeve tarafından çağrılır.

virtual void OnGlobalFontsChanged();

Açıklamalar

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz. Düğme metnini görüntülemek için kullanılan yazı tipini güncelleştirmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnMove

Üst araç çubuğu hareket ettiğinde çerçeve tarafından çağrılır.

virtual void OnMove();

Açıklamalar

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz. Üst araç çubuğu hareket ettiğinde düğmeyi yeniden konumlandırmak için bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnShow

Düğme görünür veya görünmez hale geldiğinde çerçeve tarafından çağrılır.

virtual void OnShow(BOOL bShow);

Parametreler

bShow
[in] Düğmenin görünür olup olmadığını belirtir. Bu parametre TRUE ise düğme görünür. Aksi takdirde düğme görünmez.

Açıklamalar

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz. Düğmenin görünürlüğünü güncelleştirmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnSize

Üst araç çubuğu boyutunu veya konumunu değiştirdiğinde çerçeve tarafından çağrılır ve bu değişiklik düğmenin boyutunu değiştirmesine neden olur.

virtual void OnSize(int iSize);

Parametreler

iSize
[in] Düğmenin yeni genişliği.

Açıklamalar

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz. Üst araç çubuğunun boyutu veya konumu değiştiğinde düğmeyi yeniden boyutlandırmak için bu yöntemi geçersiz kılın.

CMFCToolBarButton::OnToolHitTest

Üst araç çubuğunun bir noktanın düğmenin sınırlayıcı dikdörtgeninde olup olmadığını belirlemesi gerektiğinde çerçeve tarafından çağrılır.

virtual BOOL OnToolHitTest(
    const CWnd* pWnd,
    TOOLINFO* pTI);

Parametreler

pWnd
[in] Düğmenin üst penceresi. NULL olabilir.

Ptı
[in] Araç TOOLINFO ipucu denetimindeki bir araç hakkında bilgi içeren yapı.

Dönüş Değeri

Düğmenin OnMenuButtonToolHitTest üst çerçeve penceresine bir işaretçi alıp alamadığının sonucu; aksi takdirde YANLIŞ.

Açıklamalar

Bu yöntem, üst pencereyi geçerli bir çerçeve nesnesine dönüştürebiliyorsa aşağıdaki yöntemlerden birini çağırır:

• CMDIFrameWndEx::OnMenuButtonToolHitTest

• CFrameWndEx::OnMenuButtonToolHitTest

• COleIPFrameWndEx::OnMenuButtonToolHitTest

CMFCToolBarButton::OnUpdateToolTip

Üst araç çubuğu araç ipucu metnini güncelleştirdiğinde çerçeve tarafından çağrılır.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parametreler

pWndParent
[in] Üst pencere.

iButtonIndex
[in] Üst düğme koleksiyonundaki düğmenin sıfır tabanlı dizini.

wndToolTip
[in] Araç ipucu metnini görüntüleyen denetim.

str
[out] CString Güncelleştirilmiş araç ipucu metnini alan nesne.

Dönüş Değeri

Bu yöntem YANLIŞ döndürür.

Açıklamalar

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz ve YANLIŞ döndürür. Araç ipucu metin dizesi sağlarsanız sıfır olmayan bir değer döndürmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::P repareDrag

Düğme sürükle ve bırak işlemi gerçekleştirmek üzereyken çerçeve tarafından çağrılır.

virtual BOOL PrepareDrag(COleDataSource& srcItem);

Parametreler

srcItem
[in] COleDataSource Sürükle ve bırak işlemiyle ilgili durum bilgilerini depolayan nesne.

Dönüş Değeri

İşlem başarılı olursa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Çerçeve, araç çubuğu düğmesini sağlanan COleDataSource nesnede durumunu depolamak üzere hazırlamak için bu yöntemi çağırır. Bu yöntem, kendisini paylaşılan bir dosyaya seri hale getirerek ve sonra bu dosyayı COleDataSource::CacheGlobalData yöntemine geçirerek durumunu depolar. Araç çubuğu düğmesini serileştirme hakkında daha fazla bilgi için bkz . CMFCToolBarButton::Serialize.

Düğme depolanamıyorsa bu yöntem hiçbir şey yapmaz ve TRUE döndürür ( CMFCToolBarButton::CanBeStored yöntemi FALSE döndürür). Nesne serileştirme sırasında bir özel durum oluşursa YANLIŞ döndürür.

OLE sürükle ve bırak işlemleri hakkında daha fazla bilgi için bkz . OLE sürükle ve bırak.

CMFCToolBarButton::Rect

Düğmenin sınırlayıcı dikdörtgenini alır.

const CRect& Rect() const;

Dönüş Değeri

Düğmenin CRect sınırlayıcı dikdörtgenini içeren nesne.

CMFCToolBarButton::ResetImageToDefault

Düğmeyle ilişkili görüntüyü varsayılan değere ayarlar.

virtual void ResetImageToDefault();

Açıklamalar

Bu yöntem, CMFCToolBar::GetDefaultImage yöntemini kullanarak üst araç çubuğundan varsayılan görüntüyü alır. Düğmenin ilişkili varsayılan görüntüsü yoksa, bu yöntem CStringT::LoadString yöntemini kullanarak düğmenin metin etiketini dize kaynağına göre ayarlar. Dize kaynakları hakkında daha fazla bilgi için bkz . Kaynak Dosyalarıyla Çalışma.

Düğme kullanıcı tanımlı bir görüntüye sahipse bu yöntem hiçbir şey yapmaz.

CMFCToolBarButton::SaveBarState

Araç çubuğu düğmesinin durumunu kaydeder.

virtual void SaveBarState();

Açıklamalar

Çerçeve, sürükle ve bırak işleminin sonucu olarak bir CMFCToolBarButton nesne oluşturduğunda bu yöntemi çağırır.

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz. Araç çubuğu düğmesinin durumunu bir dış veri kaynağına kaydetmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::Serialize

Bu nesneyi bir arşivden okur veya bir arşive yazar.

virtual void Serialize(CArchive& ar);

Parametreler

Ar
[in] Serileştirebileceğiniz CArchive veya serileştirildiği nesne.

Açıklamalar

Bu yöntem pano veya sürükle ve bırak işlemleri gibi veri aktarımı işlemlerini destekler. Düğmenin kimlik, metin etiketi ve görüntü kimliği gibi özelliklerini sağlanan CArchive nesneden veya nesneye okur veya yazar.

Serileştirme örnekleri için bkz . Serileştirme: Bir Nesneyi Seri Hale Getirme.

CMFCToolBarButton::SetACCData

Sağlanan CAccessibilityData nesneyi araç çubuğu düğmesinden erişilebilirlik verileriyle doldurur.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parametreler

pParent
[in] Araç çubuğu düğmesinin üst penceresi.

data
[in] CAccessibilityData Araç çubuğu düğmesinin erişilebilirlik verileriyle doldurulmuş bir nesne.

Dönüş Değeri

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

Açıklamalar

Araç çubuğu düğmeniz erişilebilirlik verileri sağlamıyorsa FALSE döndürmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::SetClipboardFormatName

Genel pano biçimini yeniden adlandırır.

static void __stdcall SetClipboardFormatName(LPCTSTR lpszName);

Parametreler

lpszName
[in] Genel pano biçiminin yeni adı. NULL olamaz.

Açıklamalar

Bu yöntem, sürükle ve bırak işlemlerinin birden çok uygulama arasında gerçekleşmesini mümkün kılar. Her uygulamanın aynı pano biçimi adını sağlaması gerekir.

Çerçeve CMFCToolBarButton::GetClipboardFormat'ı çağırmadan önce bu yöntemi çağırmalısınız.

CMFCToolBarButton::SetImage

Düğmenin görüntü dizinini ayarlar.

virtual void SetImage(int iImage);

Parametreler

iImage
[in] Araç çubuğu görüntüleri koleksiyonundaki görüntünün dizini.

Açıklamalar

Araç çubuğu düğmesi bir ayırıcıysa, iImage ayırıcı düğmesinin yeni genişliğine başvurur.

iImage sıfırdan küçükse, bu yöntem görüntünün çizimini devre dışı bırakır ve düğmenin metin etiketinin çizilme özelliğini etkinleştirir.

CMFCToolBarButton::SetProtectedCommands

Kullanıcının özelleştiremeyeceği komutların listesini ayarlar.

static void SetProtectedCommands(const CList<UINT,UINT>& lstCmds);

Parametreler

lstCmds
[in] Korumalı komutların listesi.

Açıklamalar

Özelleştirme modunda, çerçeve korunan araç çubuğu düğmesi komutlarını devre dışı bırakır. Kullanıcı, devre dışı bırakılmış araç çubuğu düğmelerinde sürükle ve bırak ve düzenle işlemlerini gerçekleştiremez.

Korumalı komutların listesini almak için CMFCToolBarButton::GetProtectedCommands yöntemini kullanın.

CMFCToolBarButton::SetRadio

Bir düğme işaretli durumunu değiştirdiğinde çerçeve tarafından çağrılır.

virtual void SetRadio();

Açıklamalar

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz. Düğme işaretli durumunu değiştirdiğinde özel bir eylem gerçekleştirmek için bu yöntemi geçersiz kılın.

CMFCToolBarButton::SetRect

Düğmenin sınırlayıcı dikdörtgenini ayarlar.

void SetRect(const CRect rect);

Parametreler

Rect
[in] Düğmenin yeni sınırlayıcı dikdörtgeni.

Açıklamalar

Bu yöntem, yeni sınırlayıcı dikdörtgeni ayarladıktan sonra CMFCToolBarButton::OnMove yöntemini çağırır.

CMFCToolBarButton::SetStyle

Düğmenin stilini ayarlar.

virtual void SetStyle(UINT nStyle);

Parametreler

nStyle
[in] Düğmenin yeni stili.

Açıklamalar

Varsayılan uygulama, CMFCToolBarButton::m_nStyle veri üyesini nStyle olarak ayarlar. Stildeki değişikliği işlemek için ek işlem gerçekleştirmek istiyorsanız bu yöntemi geçersiz kılın. Geçerli stil bayraklarının listesi için bkz . ToolBar Denetim Stilleri .

CMFCToolBarButton::SetVisible

Düğmenin görünür olup olmadığını belirtir.

void SetVisible(BOOL bShow=TRUE);

Parametreler

bShow
[in] Düğmenin gösterilip gösterilmeyeceğini veya gizleneceğini belirten boole değeri. Bu parametre TRUE ise, düğme gösterilir. Parametre FALSE ise düğme gizlenir.

Açıklamalar

Belirli bir araç çubuğu düğmesini gizlemek veya göstermek için bu işlevi kullanın. Bu yöntemi çağırdıktan sonra CPane::AdjustSizeImmediate yöntemini çağırın.

CMFCToolBarButton::Show

Düğmeyi gösterir veya gizler.

void Show(BOOL bShow);

Parametreler

bShow
[in] Düğmenin gösterilip gösterilmeyeceğini veya gizleneceğini belirten boole değeri. Bu parametre TRUE ise, düğme gösterilir. Parametre FALSE ise düğme gizlenir.

Açıklamalar

Çerçeve, üst araç çubuğu yeniden boyutlandırıldığında araç çubuğu düğmelerinin görünürlüğünü güncelleştirmek için bu yöntemi çağırır. Düğme artık araç çubuğunun sınırlarına sığmadığında, çerçeve bShow false olarak ayarlanmış bu yöntemi çağırır. Çerçeve, düğme yeniden boyutlandırıldıktan sonra araç çubuğunun sınırlarına yeniden sığdığında bShow true olarak ayarlanmış bu yöntemi çağırır.

Düğmenin genel görünürlüğünü ayarlamak için CMFCToolBarButton::SetVisible yöntemini kullanın.

Bu yöntem, düğmenin görünürlük durumunu güncelleştirdikten sonra CMFCToolBarButton::OnShow yöntemini çağırır.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CMFCToolBar Sınıfı
CMFCToolBarImages Sınıfı