CMFCDropDownToolbarButton Sınıfı
Tıklandığında normal bir düğme gibi davranan bir araç çubuğu düğmesi türü. Ancak, kullanıcı araç çubuğu düğmesini basılı tutarsa bir açılan araç çubuğu ( CMFCDropDownToolBar Sınıfı ) açar.
Sözdizimi
class CMFCDropDownToolbarButton : public CMFCToolBarButton
Üyeler
Ortak Oluşturucular
| Ad | Tanım |
|---|---|
| CMFCDropDownToolbarButton::CMFCDropDownToolbarButton | Bir CMFCDropDownToolbarButton nesne oluşturur. |
CMFCDropDownToolbarButton::~CMFCDropDownToolbarButton |
Yıkıcı. |
Genel Yöntemler
| Ad | Tanım |
|---|---|
| CMFCDropDownToolbarButton::CopyFrom | Başka bir araç çubuğu düğmesinin özelliklerini geçerli düğmeye kopyalar. (Geçersiz Kılmalar CMFCToolBarButton::CopyFrom.) |
CMFCDropDownToolbarButton::CreateObject |
Bu sınıf türünün dinamik bir örneğini oluşturmak için çerçeve tarafından kullanılır. |
| CMFCDropDownToolbarButton::D ropDownToolbar | Açılan araç çubuğunu açar. |
| CMFCDropDownToolbarButton::ExportToMenuButton | Araç çubuğu düğmesindeki metni bir menüye kopyalar. (Geçersiz Kılmalar CMFCToolBarButton::ExportToMenuButton.) |
| CMFCDropDownToolbarButton::GetDropDownToolBar | Düğmeyle ilişkili açılan araç çubuğunu alır. |
CMFCDropDownToolbarButton::GetThisClass |
Çerçeve tarafından, bu sınıf türüyle ilişkili CRuntimeClass nesnesine bir işaretçi almak için kullanılır. |
| CMFCDropDownToolbarButton::IsDropDown | Açılan araç çubuğunun şu anda açık olup olmadığını belirler. |
| CMFCDropDownToolbarButton::IsExtraSize | Düğmenin genişletilmiş kenarlıkla görüntülenip görüntülenemeyeceğini belirler. (Geçersiz Kılmalar CMFCToolBarButton::IsExtraSize.) |
| CMFCDropDownToolbarButton::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. (Geçersiz Kılmalar CMFCToolBarButton::OnCalculateSize.) |
CMFCDropDownToolbarButton::OnCancelMode |
WM_CANCELMODE iletisini işlemek için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CMCToolBarButton::OnCancelMode.) |
| CMFCDropDownToolbarButton::OnChangeParentWnd | Düğme yeni bir araç çubuğuna eklendiğinde çerçeve tarafından çağrılır. (Geçersiz Kılmalar CMFCToolBarButton::OnChangeParentWnd.) |
| CMFCDropDownToolbarButton::OnClick | Kullanıcı fare düğmesine tıkladığında çerçeve tarafından çağrılır. (Geçersiz Kılmalar CMFCToolBarButton::OnClick.) |
| CMFCDropDownToolbarButton::OnClickUp | Kullanıcı fare düğmesini serbest bıraktığında çerçeve tarafından çağrılır. (Geçersiz Kılmalar CMFCToolBarButton::OnClickUp.) |
| CMFCDropDownToolbarButton::OnContextHelp | Üst araç çubuğu bir WM_HELPHITTEST iletisini işlediğinde çerçeve tarafından çağrılır. (Geçersiz Kılmalar CMFCToolBarButton::OnContextHelp.) |
| CMFCDropDownToolbarButton::OnCustomizeMenu | Uygulama üst araç çubuğunda bir kısayol menüsü görüntülediğinde sağlanan menüyü değiştirir. (Geçersiz Kılmalar CMFCToolBarButton::OnCustomizeMenu.) |
| CMFCDropDownToolbarButton::OnDraw | Belirtilen stilleri ve seçenekleri kullanarak düğmeyi çizmek için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CMFCToolBarButton::OnDraw.) |
| CMFCDropDownToolbarButton::OnDrawOnCustomizeList | Özelleştir iletişim kutusunun Komutlar bölmesindeki düğmeyi çizmek için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CMFCToolBarButton::OnDrawOnCustomizeList.) |
| CMFCDropDownToolbarButton::Serialize | Bu nesneyi bir arşivden okur veya bir arşive yazar. (Geçersiz Kılmalar CMFCToolBarButton::Serialize.) |
| CMFCDropDownToolbarButton::SetDefaultCommand | Kullanıcı düğmeye tıkladığında çerçevenin kullandığı varsayılan komutu ayarlar. |
Veri Üyeleri
| Ad | Tanım |
|---|---|
| CMFCDropDownToolbarButton::m_uiShowBarDelay | Açılan araç çubuğu görüntülenmeden önce kullanıcının fare düğmesini basılı tutması gereken süreyi belirtir. |
Açıklamalar
a CMFCDropDownToolBarButton , düğmenin sağ alt köşesinde küçük bir oka sahip olması bakımından sıradan bir düğmeden farklıdır. Kullanıcı açılan araç çubuğundan bir düğme seçtikten sonra, çerçeve simgesini üst düzey araç çubuğu düğmesinde (sağ alt köşede küçük ok bulunan düğme) görüntüler.
Açılan araç çubuğunu uygulama hakkında bilgi için bkz . CMFCDropDownToolBar Sınıfı.
Nesne CMFCDropDownToolBarButton bir CMFCToolBarMenuButton Sınıfı nesnesine aktarılabilir ve açılır menü içeren bir menü düğmesi olarak görüntülenebilir.
Devralma Hiyerarşisi
Gereksinimler
Üst bilgi: afxdropdowntoolbar.h
CMFCDropDownToolbarButton::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. src türünde CMFCDropDownToolbarButtonolmalıdır.
CMFCDropDownToolbarButton::CMFCDropDownToolbarButton
Bir CMFCDropDownToolbarButton nesne oluşturur.
CMFCDropDownToolbarButton();
CMFCDropDownToolbarButton(
LPCTSTR lpszName,
CMFCDropDownToolBar* pToolBar);
Parametreler
Lpszname
[in] Düğmenin varsayılan metni.
pToolBar
[in] Kullanıcı düğmeye CMFCDropDownToolBar bastığında görüntülenen nesne işaretçisi.
Açıklamalar
Oluşturucunun ikinci aşırı yüklemesi, pToolBar'ın belirttiği araç çubuğundaki ilk düğmeyi açılan düğmeye kopyalar.
Genellikle, açılan araç çubuğu düğmesi, pToolBar'ın belirttiği araç çubuğundaki en son kullanılan düğmenin metnini kullanır. Düğme bir menü düğmesine dönüştürüldüğünde veya Özelleştir iletişim kutusunun Komutlar sekmesinde görüntülendiğinde lpszName tarafından belirtilen metni kullanır. Özelleştir iletişim kutusu hakkında daha fazla bilgi için bkz. CMFCToolBarsCustomizeDialog Sınıfı.
Örnek
Aşağıdaki örnek, sınıfının bir nesnesinin nasıl oluşturduğunu CMFCDropDownToolbarButton gösterir. Bu kod parçacığı Visual Studio Tanıtım örneğinin bir parçasıdır.
// Add dropdown resources button
// CMFCToolBarsCustomizeDialog* pDlgCust
// CMFCDropDownToolBar m_wndToolbarResource
pDlgCust->AddButton(_T("Build"), CMFCDropDownToolbarButton(_T("Add Resource"), &m_wndToolbarResource));
CMFCDropDownToolbarButton::D ropDownToolbar
Açılan araç çubuğunu açar.
BOOL DropDownToolbar(CWnd* pWnd);
Parametreler
Pwnd
[in] Açılan çerçevenin üst penceresi veya açılan araç çubuğu düğmesinin üst penceresini kullanmak için NULL.
İade Değeri
Yöntem başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
CMFCDropDownToolbarButton::OnClick yöntemi, kullanıcı araç çubuğu düğmesini basılı tuttuğunda açılan araç çubuğunu açmak için bu yöntemi çağırır.
Bu yöntemler, CMFCDropDownFrame::Create yöntemini kullanarak açılan araç çubuğunu oluşturur. Üst araç çubuğu dikey olarak sabitlenmişse, bu yöntem açılan araç çubuğunu sığdırmaya bağlı olarak üst araç çubuğunun sol tarafına veya sağ tarafına konumlandırır. Aksi takdirde, bu yöntem açılan araç çubuğunu üst araç çubuğunun altına konumlandırır.
pWnd NULL olduğunda ve açılan araç çubuğu düğmesinin üst penceresi yoksa bu yöntem başarısız olur.
CMFCDropDownToolbarButton::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.
İade Değeri
Yöntem başarılı olursa sıfır olmayan; aksi takdirde 0.
Açıklamalar
Bu yöntem temel sınıf uygulamasını ( CMFCToolBarButton::ExportToMenuButton) çağırır ve ardından hedef menü düğmesine bu düğmedeki her araç çubuğu menü öğesini içeren bir açılır menü ekler. Bu yöntem açılır menüye alt menü eklemez.
Üst araç çubuğu NULL m_pToolBarise veya temel sınıf uygulaması FALSE döndürüyorsa bu yöntem başarısız olur.
CMFCDropDownToolbarButton::GetDropDownToolBar
Düğmeyle ilişkili açılan araç çubuğunu alır.
CMFCToolBar* GetDropDownToolBar() const;
İade Değeri
Düğmeyle ilişkili açılan araç çubuğu.
Açıklamalar
Bu yöntem veri üyesini m_pToolBar döndürür.
CMFCDropDownToolbarButton::IsDropDown
Açılan araç çubuğunun şu anda açık olup olmadığını belirler.
BOOL IsDropDown() const;
İade Değeri
Açılan araç çubuğu şu anda açıksa sıfır olmayan; aksi takdirde 0.
Açıklamalar
Çerçeve, CMFCDropDownToolbarButton::D ropDownToolbar yöntemini kullanarak açılan araç çubuğunu açar. Kullanıcı açılan araç çubuğunun istemci dışı alanında sol fare düğmesine bastığında çerçeve açılır araç çubuğunu kapatır.
CMFCDropDownToolbarButton::IsExtraSize
Düğmenin genişletilmiş kenarlıkla görüntülenip görüntülenemeyeceğini belirler.
virtual BOOL IsExtraSize() const;
İade Değeri
Araç çubuğu düğmesi genişletilmiş kenarlıkla görüntülenebiliyorsa sıfır olmayan; aksi takdirde 0.
Açıklamalar
Genişletilmiş kenarlıklar hakkında daha fazla bilgi için bkz . CMFCToolBarButton::IsExtraSize.
CMFCDropDownToolbarButton::m_uiShowBarDelay
Açılan araç çubuğu görüntülenmeden önce kullanıcının fare düğmesini basılı tutması gereken süreyi belirtir.
static UINT m_uiShowBarDelay;
Açıklamalar
Gecikme süresi milisaniye cinsinden ölçülür. Varsayılan değer 500'dür. Bu paylaşılan veri üyesinin değerini değiştirerek başka bir gecikme ayarlayabilirsiniz.
CMFCDropDownToolbarButton::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.
İade Değeri
SIZE Düğmenin boyutlarını piksel cinsinden içeren bir yapı.
Açıklamalar
Bu yöntem, düğme boyutunun yatay boyutuna açılan okun genişliğini ekleyerek temel sınıf uygulamasını ( CMFCToolBarButton::OnCalculateSize) genişletir.
CMFCDropDownToolbarButton::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
Bu yöntem, metin etiketini ( CMFCToolBarButton::m_strText) temizleyip CMFCToolBarButton::m_bText ve CMFCToolBarButton::m_bUserButton veri üyelerini FALSE olarak ayarlayarak temel sınıf uygulamasını (CMFCToolBarButton::OnChangeParentWnd) geçersiz kılar.
CMFCDropDownToolbarButton::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.
İade Değeri
Düğme tıklama iletisini işlerse sıfır olmayan; aksi takdirde 0.
Açıklamalar
Bu yöntem, açılan araç çubuğunun durumunu güncelleştirerek CMFCToolBarButton::OnClick temel sınıf uygulamasını genişletir.
Kullanıcı araç çubuğu düğmesine tıkladığında, bu yöntem CMFCDropDownToolbarButton::m_uiShowBarDelay veri üyesi tarafından belirtilen süreyi bekleyen bir zamanlayıcı oluşturur ve ardından CMFCDropDownToolbarButton::D ropDownToolbar yöntemini kullanarak açılan araç çubuğunu açar. Bu yöntem, kullanıcı araç çubuğu düğmesine ikinci kez tıkladığınızda açılan araç çubuğunu kapatır.
CMFCDropDownToolbarButton::OnClickUp
Kullanıcı fare düğmesini serbest bıraktığında çerçeve tarafından çağrılır.
virtual BOOL OnClickUp();
İade Değeri
Düğme tıklama iletisini işlerse sıfır olmayan; aksi takdirde 0.
Açıklamalar
Bu yöntem, açılan araç çubuğunun durumunu güncelleştirerek CMFCToolBarButton::OnClickUp temel sınıf uygulamasını genişletir.
Bu yöntem etkinse açılan araç çubuğu zamanlayıcısını durdurur. Açıksa açılan araç çubuğunu kapatır.
Açılan araç çubuğu ve açılan araç çubuğu zamanlayıcı hakkında daha fazla bilgi için bkz . CMFCDropDownToolbarButton::OnClick.
CMFCDropDownToolbarButton::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.
İade Değeri
Düğme yardım iletisini işlerse sıfır olmayan; aksi takdirde 0.
Açıklamalar
Bu yöntem, bDelay false olarak ayarlanmış CMFCDropDownToolbarButton::OnClick yöntemini çağırarak temel sınıf uygulamasını (CMFCToolBarButton::OnContextHelp) genişletir. Bu yöntem, CMFCDropDownToolbarButton::OnClick tarafından döndürülen değeri döndürür.
WM_HELPHITTEST iletisi hakkında daha fazla bilgi için bkz . TN028: Bağlama Duyarlı Yardım Desteği.
CMFCDropDownToolbarButton::OnCustomizeMenu
Uygulama üst araç çubuğunda bir kısayol menüsü görüntülediğinde sağlanan menüyü değiştirir.
virtual BOOL OnCustomizeMenu(CMenu* pMenu);
Parametreler
pMenu
[in] Özelleştirebileceğiniz menü.
İade Değeri
Bu yöntem TRUE döndürür.
Açıklamalar
Bu yöntem, aşağıdaki menü öğelerini devre dışı bırakarak temel sınıf uygulamasını ( CMFCToolBarButton::OnCustomizeMenu) genişletir:
Düğme Resmini Kopyala
Düğme Görünümü
Image
Metin
Resim ve Metin
Çerçevenin özelleştirme modunda görüntülediği kısayol menüsünü değiştirmek için bu yöntemi geçersiz kılın.
CMFCDropDownToolbarButton::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.
CMFCDropDownToolbarButton::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ığı. Bu parametre TRUE ise düğme seçilir. Bu parametre YANLIŞ ise düğme seçilmez.
İade Değeri
Belirtilen cihaz bağlamındaki düğmenin piksel cinsinden genişliği.
Açıklamalar
Bu yöntem, düğmenin kendisini sahip çizim liste kutusunda görüntülemesi gerektiğinde özelleştirme iletişim kutusu ( Komutlar sekmesi) tarafından çağrılır.
Bu yöntem, temel sınıf uygulamasını (CMFCToolBarButton::OnDrawOnCustomizeList) düğmenin metin etiketini düğmenin adıyla (yani oluşturucuya geçirdiğiniz lpszName parametresinin değerine) değiştirerek genişletir.
CMFCDropDownToolbarButton::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, üst araç çubuğunun kaynak kimliğini serileştirerek temel sınıf uygulamasını ( CMFCToolBarButton::Serialize) genişletir. Arşiv yüklenirken ( CArchive::IsLoading sıfır olmayan bir değer döndürür), bu yöntem veri üyesini serileştirilmiş kaynak kimliğini içeren araç çubuğuna ayarlar m_pToolBar .
CMFCDropDownToolbarButton::SetDefaultCommand
Kullanıcı düğmeye tıkladığında çerçevenin kullandığı varsayılan komutu ayarlar.
void SetDefaultCommand(UINT uiCmd);
Parametreler
uiCmd
[in] Varsayılan komutun kimliği.
Açıklamalar
Kullanıcı düğmeye tıkladığında çerçevenin yürüttüğü varsayılan komutu belirtmek için bu yöntemi çağırın. uiCmd tarafından belirtilen komut kimliğine sahip bir öğe üst açılan araç çubuğunda bulunmalıdır.
Ayrıca bkz.
Hiyerarşi Grafiği
Sınıflar
CMFCDropDownToolBar Sınıfı
CMFCToolBar Sınıfı
CMFCToolBarMenuButton Sınıfı
İzlenecek yol: Araç Çubuklarına Denetimler Yerleştirme
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin