Aracılığıyla paylaş

CMFCToolBarsCustomizeDialog Sınıfı

  • Makale

Kullanıcının bir uygulamadaki araç çubuklarını, menüleri, klavye kısayollarını, kullanıcı tanımlı araçları ve görsel stili özelleştirmesine olanak tanıyan, modsuz sekme iletişim kutusu ( CPropertySheet Sınıfı). Genellikle, kullanıcı Araçlar menüsünden Özelleştir'i seçerek bu iletişim kutusuna erişir.

Özelleştir iletişim kutusunda altı sekme vardır: Komutlar, Araç Çubukları, Araçlar, Klavye, Menü ve Seçenekler.

Sözdizimi

class CMFCToolBarsCustomizeDialog : public CPropertySheet

Üyeler

Ortak Oluşturucular

Adı Açıklama
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog Bir CMFCToolBarsCustomizeDialog nesne oluşturur.
CMFCToolBarsCustomizeDialog::~CMFCToolBarsCustomizeDialog Yıkıcı.

Genel Yöntemler

Adı Açıklama
CMFCToolBarsCustomizeDialog::AddButton Komutlar sayfasındaki komut listesine bir araç çubuğu düğmesi ekler
CMFCToolBarsCustomizeDialog::AddMenu Kaynaklardan bir menü yükler ve CMFCToolBarsCustomizeDialog::AddMenuCommands öğesini çağırarak bu menüyü Komutlar sayfasındaki komut listesine ekler.
CMFCToolBarsCustomizeDialog::AddMenuCommands Kaynaklardan bir menü yükler ve CMFCToolBarsCustomizeDialog::AddMenuCommands öğesini çağırarak bu menüyü Komutlar sayfasındaki komut listesine ekler.
CMFCToolBarsCustomizeDialog::AddToolBar Kaynaklardan bir araç çubuğu yükler. Ardından, menüdeki her komut için CMFCToolBarsCustomizeDialog::AddButton yöntemini çağırarak Komutlar sayfasındaki komutlar listesinde belirtilen kategorinin altında bir düğme ekleyin.
CMFCToolBarsCustomizeDialog::Create Özelleştirme iletişim kutusunu görüntüler.
CMFCToolBarsCustomizeDialog::EnableTools Daha sonraki kullanımlar için ayrılmıştır.
CMFCToolBarsCustomizeDialog::EnableUserDefinedToolbars Özelleştir iletişim kutusunu kullanarak yeni araç çubukları oluşturmayı etkinleştirir veya devre dışı bırakır.
CMFCToolBarsCustomizeDialog::FillAllCommandsList Sağlanan CListBox nesneyi Tüm Komutlar kategorisindeki komutlarla doldurur.
CMFCToolBarsCustomizeDialog::FillCategoriesComboBox Sağlanan CComboBox nesneyi Özelleştir iletişim kutusundaki her komut kategorisinin adıyla doldurur.
CMFCToolBarsCustomizeDialog::FillCategoriesListBox Sağlanan CListBox nesneyi Özelleştir iletişim kutusundaki her komut kategorisinin adıyla doldurur.
CMFCToolBarsCustomizeDialog::GetCommandName Verilen komut kimliğiyle ilişkili adı alır.
CMFCToolBarsCustomizeDialog::GetCountInCategory Sağlanan listede verilen metin etiketine sahip öğelerin sayısını alır.
CMFCToolBarsCustomizeDialog::GetFlags İletişim kutusunun davranışını etkileyen bayrak kümesini alır.
CMFCToolBarsCustomizeDialog::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.
CMFCToolBarsCustomizeDialog::OnEditToolbarMenuImage Kullanıcının araç çubuğu düğmesini veya menü öğesi simgesini özelleştirebilmesi için bir görüntü düzenleyicisi başlatır.
CMFCToolBarsCustomizeDialog::OnInitDialog Özellik sayfası başlatmayı artırmak için geçersiz kılar. (Geçersiz Kılmalar CPropertySheet::OnInitDialog.)
CMFCToolBarsCustomizeDialog::P ostNcDestroy Pencere yok edildikten sonra çerçeve tarafından çağrılır. (Geçersiz Kılmalar CPropertySheet::PostNcDestroy.)
CMFCToolBarsCustomizeDialog::RemoveButton Belirtilen komut kimliğine sahip düğmeyi belirtilen kategoriden veya tüm kategorilerden kaldırır.
CMFCToolBarsCustomizeDialog::RenameCategory Komutlar sekmesindeki kategori liste kutusunda bir kategoriyi yeniden adlandırır .
CMFCToolBarsCustomizeDialog::ReplaceButton Komutlar sekmesindeki komut listesindeki bir düğmeyi yeni bir araç çubuğu düğme nesnesiyle değiştirir.
CMFCToolBarsCustomizeDialog::SetUserCategory Komutlar sekmesinde görüntülenecek kategoriler listesine bir kategori ekler.

Korumalı Yöntemler

Adı Açıklama
CMFCToolBarsCustomizeDialog::CheckToolsValidity Kullanıcı tanımlı araçlar listesinin geçerli olup olmadığını belirlemek için çerçeve tarafından çağrılır.
CMFCToolBarsCustomizeDialog::OnAfterChangeTool Kullanıcı tanımlı bir aracın özellikleri değiştiğinde çerçeve tarafından çağrılır.
CMFCToolBarsCustomizeDialog::OnAssignKey Belirtilen klavye kısayollarının bir eyleme atanıp atanamayacağını belirler.
CMFCToolBarsCustomizeDialog::OnBeforeChangeTool Kullanıcı tanımlı bir aracın değiştirilip değiştirilemeyeceğini belirler.
CMFCToolBarsCustomizeDialog::OnInitToolsPage Kullanıcı Araçlar sekmesini seçtiğinde çerçeve tarafından çağrılır.

Açıklamalar

Özelleştir iletişim kutusunu görüntülemek için bir CMFCToolBarsCustomizeDialog nesne oluşturun ve CMFCToolBarsCustomizeDialog::Create yöntemini çağırın.

Özelleştir iletişim kutusu etkinken, uygulama kullanıcıyı özelleştirme görevleriyle sınırlayan özel bir modda çalışır.

Örnek

Aşağıdaki örnekte, sınıftaki çeşitli yöntemlerin nasıl kullanılacağı gösterilmektedir CMFCToolBarsCustomizeDialog . Örnekte, Komutlar sayfasındaki komutların liste kutusunda bir araç çubuğu düğmesinin nasıl değiştirileceği, Özelleştir iletişim kutusunu kullanarak yeni araç çubukları oluşturmayı etkinleştirme ve Özelleştirme iletişim kutusunu görüntüleme gösterilmektedir. Bu kod parçacığı, IE Tanıtım örneğinin bir parçasıdır.

pDlgCust->ReplaceButton(ID_FAVORITS_DUMMY,
                        CMFCToolBarMenuButton((UINT)-1, menuFavorites, -1, strFavorites));
pDlgCust->EnableUserDefinedToolbars();
pDlgCust->Create();

Devralma Hiyerarşisi

Cobject

Ccmdtarget

Cwnd

Cpropertysheet

CMFCToolBarsCustomizeDialog

Gereksinimler

Üst bilgi: afxToolBarsCustomizeDialog.h

CMFCToolBarsCustomizeDialog::AddButton

Komutlar sayfasındaki komut listesine bir araç çubuğu düğmesi ekler.

void AddButton(
    UINT uiCategoryId,
    const CMFCToolBarButton& button,
    int iInsertBefore=-1);

void AddButton(
    LPCTSTR lpszCategory,
    const CMFCToolBarButton& button,
    int iInsertBefore=-1);

Parametreler

uiCategoryId
[in] Düğmenin eklendiği kategori kimliğini belirtir.

Düğme
[in] Eklenecek düğmeyi belirtir.

iInsertBefore
[in] Düğmenin eklendiği araç çubuğu düğmesinin sıfır tabanlı dizinini belirtir.

lpszCategory
[in] Düğme eklenecek kategori dizesini belirtir.

Açıklamalar

yöntemi standart AddButton komut kimlikleri (ID_FILE_MRU_FILE1 gibi), izin verilmeyen komutlara (bkz. CMFCToolBar::IsCommandPermitted) ve sahte düğmelere sahip düğmeleri yoksayar.

Bu yöntem, düğmenin çalışma zamanı sınıfını kullanarak ile aynı türde button (genellikle CMFCToolBarButton Sınıfı) yeni bir nesne oluşturur. Ardından, düğmenin veri üyelerini kopyalamak için CMFCToolBarButton::CopyFrom öğesini çağırır ve kopyayı belirtilen kategoriye ekler.

Yeni düğme eklendiğinde bildirimi alır OnAddToCustomizePage .

-1 ise iInsertBefore , düğme kategoriler listesine eklenir; aksi takdirde belirtilen dizine sahip öğenin önüne eklenir.

Örnek

Aşağıdaki örnekte sınıfının yönteminin AddButton nasıl kullanılacağı gösterilmektedir CMFCToolBarsCustomizeDialog . Bu kod parçacığı Slider örneğinin bir parçasıdır.

CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this,
                                                                        TRUE /* Automatic menus scaning */);

CSliderButton btnSlider(ID_SLIDER);
btnSlider.SetRange(0, 100);

pDlgCust->AddButton(_T("Edit"), btnSlider);

CMFCToolBarsCustomizeDialog::AddMenu

Kaynaklardan bir menü yükler ve CMFCToolBarsCustomizeDialog::AddMenuCommands öğesini çağırarak bu menüyü Komutlar sayfasındaki komut listesine ekler.

BOOL AddMenu(UINT uiMenuResId);

Parametreler

uiMenuResId
[in] Yüklenecek menünün kaynak kimliğini belirtir.

İade Değeri

Bir menü başarıyla eklendiyse TRUE; aksi takdirde YANLIŞ.

Açıklamalar

çağrısında AddMenuCommandsbPopup YANLIŞ'tır. Sonuç olarak, bu yöntem komut listesine alt menüler içeren menü öğeleri eklemez. Bu yöntem, alt menülerdeki menü öğelerini komut listesine ekler.

CMFCToolBarsCustomizeDialog::AddMenuCommands

Belirtilen menüdeki tüm öğeleri temsil etmek için Komutlar sayfasındaki komut listesine öğeler ekler.

void AddMenuCommands(
    const CMenu* pMenu,
    BOOL bPopup,
    LPCTSTR lpszCategory=NULL,
    LPCTSTR lpszMenuPath=NULL);

Parametreler

pMenu
[in] Eklenecek CMenu nesnesinin işaretçisi.

bPopup
[in] Açılır menü öğelerinin komut listesine eklenip eklenmeyeceğini belirtir.

lpszCategory
[in] Menü eklenecek kategorinin adı.

lpszMenuPath
[in] Komut Tüm Kategoriler listesinde gösterildiğinde ada eklenen bir ön ek.

Açıklamalar

AddMenuCommands yöntemi, pMenu'nun tüm menü öğeleri üzerinde döngü oluşturur. Alt menü içermeyen her menü öğesi için, bu yöntem bir CMFCToolBarButton Sınıfı nesnesi oluşturur ve CMFCToolBarsCustomizeDialog::AddButton yöntemini çağırarak menü öğesini Komutlar sayfasındaki komut listesine araç çubuğu düğmesi olarak ekler. Ayırıcılar bu işlemde yoksayılır.

bPopup TRUE ise, alt menü içeren her menü öğesi için bu yöntem bir CMFCToolBarMenuButton Sınıfı nesnesi oluşturur ve çağırarak AddButtonkomut listesine ekler. Aksi takdirde, alt menü içeren menü öğeleri komut listesinde görüntülenmez. Her iki durumda da, AddMenuCommands alt menü içeren bir menü öğesiyle karşılaştığında, kendisini özyinelemeli olarak çağırır, pMenu parametresi olarak alt menüye bir işaretçi geçirir ve alt menünün etiketini lpszMenuPath'e ekler.

CMFCToolBarsCustomizeDialog::AddToolBar

Kaynaklardan bir araç çubuğu yükler. Ardından, menüdeki her komut için CMFCToolBarsCustomizeDialog::AddButton yöntemini çağırarak Komutlar sayfasındaki komutlar listesinde belirtilen kategorinin altında bir düğme ekleyin.

BOOL AddToolBar(
    UINT uiCategoryId,
    UINT uiToolbarResId);

BOOL AddToolBar(
    LPCTSTR lpszCategory,
    UINT uiToolbarResId);

Parametreler

uiCategoryId
[in] Araç çubuğunun ekleneceği kategorinin kaynak kimliğini belirtir.

uiToolbarResId
[in] Komutları komut listesine eklenen bir araç çubuğunun kaynak kimliğini belirtir.

lpszCategory
[in] Araç çubuğunun ekleneceği kategorinin adını belirtir.

İade Değeri

Yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.

Örnek

Aşağıdaki örnekte sınıfında yönteminin AddToolBar nasıl kullanılacağı gösterilmektedir CMFCToolBarsCustomizeDialog . Bu kod parçacığı Word Pad örneğinin bir parçasıdır.

CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this,
                                                                        TRUE /* Automatic menus scaning */,
                                                                        AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS |
                                                                            AFX_CUSTOMIZE_MENU_ANIMATIONS);

pDlgCust->AddToolBar(_T("Format"), IDR_FORMATBAR);

Açıklamalar

Her komutu temsil etmek için kullanılan denetim bir CMFCToolBarButton Sınıfı nesnesidir. Araç çubuğunu ekledikten sonra, CMFCToolBarsCustomizeDialog::ReplaceButton çağrısı yaparak düğmeyi türetilmiş bir türün denetimiyle değiştirebilirsiniz.

CMFCToolBarsCustomizeDialog::CheckToolsValidity

Kullanıcı araçları listesinin geçerliliğini doğrular.

virtual BOOL CheckToolsValidity(const CObList& lstTools);

Parametreler

lstTools
[in] Denetlenecek kullanıcı tanımlı araçların listesi.

İade Değeri

Kullanıcı tanımlı araçların listesi geçerliyse TRUE döndürür; aksi takdirde YANLIŞ. Varsayılan uygulama her zaman TRUE döndürür.

Açıklamalar

Çerçeve, CMFCToolBarsCustomizeDialog::CheckToolsValidity tarafından döndürülen kullanıcı tanımlı araçları temsil eden nesnelerin geçerliliğini doğrulamak için bu yöntemi çağırır.

CheckToolsValidity Kullanıcı iletişim kutusunu kapatmadan önce kullanıcı araçlarını doğrulamak istiyorsanız, öğesinden CMFCToolBarsCustomizeDialog türetilen bir sınıfta yöntemini geçersiz kılın. Bu yöntem, kullanıcı iletişim kutusunun sağ üst köşesindeki Kapat düğmesine veya iletişim kutusunun sağ alt köşesinde Kapat etiketli düğmeye tıkladığında YANLIŞ döndürürse, iletişim kutusu kapatmak yerine Araçlar sekmesini görüntüler. Kullanıcı Araçlar sekmesinden uzaklaşmak için bir sekmeye tıkladığında bu yöntem YANLIŞ döndürürse gezinti gerçekleşmez. Kullanıcıyı doğrulamanın başarısız olmasına neden olan sorun hakkında bilgilendirmek için uygun bir ileti kutusu görüntülemeniz gerekir.

CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog

Bir CMFCToolBarsCustomizeDialog nesne oluşturur.

CMFCToolBarsCustomizeDialog(
    CFrameWnd* pWndParentFrame,
    BOOL bAutoSetFromMenus = FALSE,
    UINT uiFlags = (AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS | AFX_CUSTOMIZE_MENU_ANIMATIONS | AFX_CUSTOMIZE_NOHELP),
    CList <CRuntimeClass*, CRuntimeClass*>* p listCustomPages = NULL);

Parametreler

pWndParentFrame
[in] Üst çerçevenin işaretçisi. Bu parametre NULL olmamalıdır.

bAutoSetFromMenus
[in] Tüm menülerdeki menü komutlarının Komutlar sayfasındaki komut listesine eklenip eklenmeyeceğini belirten boole değeri. Bu parametre TRUE ise menü komutları eklenir. Aksi takdirde menü komutları eklenmez.

uiFlags
[in] İletişim kutusunun davranışını etkileyen bayrakların birleşimi. Bu parametre aşağıdaki değerlerden biri veya daha fazlası olabilir:

  • AFX_CUSTOMIZE_MENU_SHADOWS

  • AFX_CUSTOMIZE_TEXT_LABELS

  • AFX_CUSTOMIZE_MENU_ANIMATIONS

  • AFX_CUSTOMIZE_NOHELP

  • AFX_CUSTOMIZE_CONTEXT_HELP

  • AFX_CUSTOMIZE_NOTOOLS

  • AFX_CUSTOMIZE_MENUAMPERS

  • AFX_CUSTOMIZE_NO_LARGE_ICONS

plistCustomPages
[in] Ek özel sayfalar belirten nesne listesinin CRuntimeClass işaretçisi.

Açıklamalar

plistCustomPages parametresi, ek özel sayfalar belirten nesnelerin listesine CRuntimeClass başvurur. Oluşturucu, CRuntimeClass::CreateObject yöntemini kullanarak iletişim kutusuna daha fazla sayfa ekler. Özelleştir iletişim kutusuna daha fazla sayfa ekleyen bir örnek için CustomPages örneğine bakın.

uiFlags parametresinde geçirebileceğiniz değerler hakkında daha fazla bilgi için bkz. CMFCToolBarsCustomizeDialog::GetFlags.

Örnek

Aşağıdaki örnek, sınıfının bir nesnesinin nasıl oluşturduğunu CMFCToolBarsCustomizeDialog gösterir. Bu kod parçacığı Özel Sayfalar örneğinin bir parçasıdır.

CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this,
                                                                        TRUE /* Automatic menus scaning */,
                                                                        AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS |
                                                                            AFX_CUSTOMIZE_MENU_ANIMATIONS, // default parameters
                                                                        &lstCustomPages);                  // pointer to the list of runtime classes of the custom property pages

CMFCToolBarsCustomizeDialog::Create

Özelleştirme iletişim kutusunu görüntüler.

virtual BOOL Create();

İade Değeri

Özelleştirme özellik sayfası başarıyla oluşturulursa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Create yalnızca sınıfı tamamen başlatıldıktan sonra yöntemini çağırın.

CMFCToolBarsCustomizeDialog::EnableUserDefinedToolbars

Özelleştir iletişim kutusunu kullanarak yeni araç çubukları oluşturmayı etkinleştirir veya devre dışı bırakır.

void EnableUserDefinedToolbars(BOOL bEnable=TRUE);

Parametreler

bEnable
[in] Kullanıcı tanımlı araç çubuklarını etkinleştirmek için TRUE; Araç çubuklarını devre dışı bırakmak için YANLIŞ.

Açıklamalar

bEnable TRUE ise, Araç Çubukları sayfasında Yeni, Yeniden Adlandır ve Sil düğmeleri görüntülenir.

Varsayılan olarak veya bEnable YANLIŞ ise, bu düğmeler görüntülenmez ve kullanıcı yeni araç çubukları tanımlayamaz.

CMFCToolBarsCustomizeDialog::FillAllCommandsList

Sağlanan CListBox nesneyi Tüm Komutlar kategorisindeki komutlarla doldurur.

virtual void FillAllCommandsList(CListBox& wndListOfCommands) const;

Parametreler

wndListOfCommands
[out] Doldurulacak nesneye başvuru CListBox .

Açıklamalar

Tüm Komutlar kategorisi tüm kategorilerin komutlarını içerir. CMFCToolBarsCustomizeDialog::AddButton yöntemi, sağlanan düğmeyle ilişkili komutu sizin için Tüm Komutlar kategorisine ekler.

Bu yöntem, sağlanan CListBox nesneyi Tüm Komutlar kategorisindeki komutlarla doldurmadan önce içeriğini temizler.

sınıfı, CMFCMousePropertyPage çift tıklama olay listesi kutusunu doldurmak için bu yöntemi kullanır.

CMFCToolBarsCustomizeDialog::FillCategoriesComboBox

Sağlanan CComboBox nesneyi Özelleştir iletişim kutusundaki her komut kategorisinin adıyla doldurur.

void FillCategoriesComboBox(
    CComboBox& wndCategory,
    BOOL bAddEmpty = TRUE) const;

Parametreler

wndCategory
[out] Doldurulacak nesneye başvuru CComboBox .

bAddEmpty
[in] Komutları olmayan birleşik giriş kutusuna kategori eklenip eklenmeyeceğini belirten Boole değeri. Bu parametre TRUE ise, birleşik giriş kutusuna boş kategoriler eklenir. Aksi takdirde, boş kategoriler eklenmez.

Açıklamalar

Bu yöntem, CMFCToolBarsCustomizeDialog::FillCategoriesListBox yöntemine benzer, ancak bu yöntem bir CComboBox nesneyle çalışır.

Bu yöntem, doldurmadan önce nesnenin CComboBox içeriğini temizlemez. Tüm Komutlar kategorisinin birleşik giriş kutusundaki son öğe olduğunu garanti eder.

CMFCToolBarsCustomizeDialog::AddButton yöntemini kullanarak yeni komut kategorileri ekleyebilirsiniz. CMFCToolBarsCustomizeDialog::RenameCategory yöntemini kullanarak var olan bir kategorinin adını değiştirebilirsiniz.

CMFCToolBarsKeyboardPropertyPage ve CMFCKeyMapDialog sınıfları, klavye eşlemelerini kategorilere ayırmak için bu yöntemi kullanır.

CMFCToolBarsCustomizeDialog::FillCategoriesListBox

Sağlanan CListBox nesneyi Özelleştir iletişim kutusundaki her komut kategorisinin adıyla doldurur.

void FillCategoriesListBox(
    CListBox& wndCategory,
    BOOL bAddEmpty = TRUE) const;

Parametreler

wndCategory
[out] Doldurulacak nesneye başvuru CListBox .

bAddEmpty
[in] Liste kutusuna komutları olmayan kategorilerin eklenip eklenmeyeceğini belirten Boole değeri. Bu parametre TRUE ise, liste kutusuna boş kategoriler eklenir. Aksi takdirde, boş kategoriler eklenmez.

Açıklamalar

Bu yöntem CMFCToolBarsCustomizeDialog::FillCategoriesComboBox yöntemine benzer, ancak bu yöntem bir CListBox nesneyle çalışır.

Bu yöntem, doldurmadan önce nesnenin CListBox içeriğini temizlemez. Tüm Komutlar kategorisinin liste kutusundaki son öğe olduğunu garanti eder.

CMFCToolBarsCustomizeDialog::AddButton yöntemini kullanarak yeni komut kategorileri ekleyebilirsiniz. CMFCToolBarsCustomizeDialog::RenameCategory yöntemini kullanarak var olan bir kategorinin adını değiştirebilirsiniz.

sınıfı, CMFCToolBarsCommandsPropertyPage her komut kategorisiyle ilişkili komutların listesini göstermek için bu yöntemi kullanır.

CMFCToolBarsCustomizeDialog::GetCommandName

Verilen komut kimliğiyle ilişkili adı alır.

LPCTSTR GetCommandName(UINT uiCmd) const;

Parametreler

uiCmd
[in] Alınacak komutun kimliği.

İade Değeri

Verilen komut kimliğiyle ilişkili ad veya komut yoksa NULL.

CMFCToolBarsCustomizeDialog::GetCountInCategory

Sağlanan listede verilen metin etiketine sahip öğelerin sayısını alır.

int GetCountInCategory(
    LPCTSTR lpszItemName,
    const CObList& lstCommands) const;

Parametreler

lpszItemName
[in] Eşleştirecek metin etiketi.

lstCommands
[in] Nesneleri içeren CMFCToolBarButton bir listeye başvuru.

İade Değeri

Sağlanan listede metin etiketi lpszItemName olan öğelerin sayısı.

Açıklamalar

Sağlanan nesne listesindeki her öğe türünde CMFCToolBarButtonolmalıdır. Bu yöntem lpszItemName değerini CMFCToolBarButton::m_strText veri üyesiyle karşılaştırır.

CMFCToolBarsCustomizeDialog::GetFlags

İletişim kutusunun davranışını etkileyen bayrak kümesini alır.

UINT GetFlags() const;

İade Değeri

İletişim kutusunun davranışını etkileyen bayrak kümesi.

Açıklamalar

Bu yöntem oluşturucuya geçirilen uiFlags parametresinin değerini alır. Dönüş değeri aşağıdaki değerlerden biri veya daha fazlası olabilir:

Adı Açıklama
AFX_CUSTOMIZE_MENU_SHADOWS Kullanıcının menünün gölge görünümünü belirtmesine izin verir.
AFX_CUSTOMIZE_TEXT_LABELS Kullanıcının araç çubuğu düğme görüntülerinin altında metin etiketlerinin gösterilip gösterilmeyeceğini belirtmesine izin verir.
AFX_CUSTOMIZE_MENU_ANIMATIONS Kullanıcının menü animasyon stilini belirtmesine izin verir.
AFX_CUSTOMIZE_NOHELP Özelleştirme iletişim kutusundan yardım düğmesini kaldırır.
AFX_CUSTOMIZE_CONTEXT_HELP WS_EX_CONTEXTHELP görsel stilini etkinleştirir.
AFX_CUSTOMIZE_NOTOOLS Özelleştirme iletişim kutusundan Araçlar sayfasını kaldırır. Uygulamanız sınıfını CUserToolsManager kullanıyorsa bu bayrak geçerlidir.
AFX_CUSTOMIZE_MENUAMPERS Düğme başlık ve işareti ( &) karakterini içermesine izin verir.
AFX_CUSTOMIZE_NO_LARGE_ICONS Özelleştirme iletişim kutusundan Büyük Simgeler seçeneğini kaldırır.

WS_EX_CONTEXTHELP görsel stili hakkında daha fazla bilgi için bkz . Genişletilmiş Pencere Stilleri.

CMFCToolBarsCustomizeDialog::OnAfterChangeTool

Kullanıcı aracı oluştuktan hemen sonra bir değişikliğe yanıt verir.

virtual void OnAfterChangeTool(CUserTool* pSelTool);

Parametreler

pSelTool
[in, out] Değiştirilen kullanıcı aracı nesnesinin işaretçisi.

Açıklamalar

Bu yöntem, kullanıcı tanımlı bir aracın özelliklerini değiştirdiğinde çerçeve tarafından çağrılır. Varsayılan uygulama hiçbir şey yapmaz. Bir kullanıcı aracında değişiklik gerçekleştikten sonra işlem gerçekleştirmek için öğesinden CMFCToolBarsCustomizeDialog türetilen bir sınıfta bu yöntemi geçersiz kılın.

CMFCToolBarsCustomizeDialog::OnAssignKey

Bir kullanıcı bunları tanımlarken klavye kısayollarını doğrular.

virtual BOOL OnAssignKey(ACCEL* pAccel);

Parametreler

pAccel
[in, out] BIR ACCEL yapısı olarak ifade edilen önerilen klavye atamasının işaretçisi.

İade Değeri

Anahtar atanabiliyorsa TRUE veya anahtar atanamıyorsa YANLIŞ. Varsayılan uygulama her zaman TRUE döndürür.

Açıklamalar

Bir kullanıcı yeni bir klavye kısayolu atadığında ek işlem gerçekleştirmek veya kullanıcı tarafından tanımlanan klavye kısayollarını doğrulamak için türetilmiş bir sınıfta bu yöntemi geçersiz kılın. Bir kısayol atanmasını önlemek için YANLIŞ döndür. Ayrıca bir ileti kutusu görüntülemeli veya klavye kısayolunun neden reddedildiğini kullanıcıya bildirmelisiniz.

CMFCToolBarsCustomizeDialog::OnBeforeChangeTool

Kullanıcı bir değişiklik uygulamak üzereyken bir kullanıcı aracında değişiklik yapıldığında özel işlem gerçekleştirir.

virtual void OnBeforeChangeTool(CUserTool* pSelTool);

Parametreler

pSelTool
[in, out] Değiştirilmek üzere olan kullanıcı aracı nesnesinin işaretçisi.

Açıklamalar

Bu yöntem, kullanıcı tanımlı bir aracın özellikleri değişmek üzereyken çerçeve tarafından çağrılır. Varsayılan uygulama hiçbir şey yapmaz. OnBeforeChangeTool pSelTool'un kullandığı kaynakları serbest bırakma gibi bir kullanıcı aracında değişiklik gerçekleşmeden önce işlem gerçekleştirmek istiyorsanız, öğesinden CMFCToolBarsCustomizeDialog türetilen bir sınıfta yöntemini geçersiz kılın.

CMFCToolBarsCustomizeDialog::OnEditToolbarMenuImage

Kullanıcının araç çubuğu düğmesini veya menü öğesi simgesini özelleştirebilmesi için bir görüntü düzenleyicisi başlatır.

virtual BOOL OnEditToolbarMenuImage(
    CWnd* pWndParent,
    CBitmap& bitmap,
    int nBitsPerPixel);

Parametreler

pWndParent
[in] Üst pencere işaretçisi.

Bitmap
[in] Düzenlenecek bit eşlem nesnesine başvuru.

nBitsPerPixel
[in] Bit/piksel cinsinden bit rengi çözünürlüğü.

İade Değeri

Bir değişiklik işleniyorsa TRUE; aksi takdirde YANLIŞ. Varsayılan uygulama bir iletişim kutusu görüntüler ve kullanıcı Tamam'a tıklarsa TRUE, İptal'e veya Kapat düğmesine tıklarsa YANLIŞ döndürür.

Açıklamalar

Bu yöntem, kullanıcı görüntü düzenleyicisini çalıştırdığında çerçeve tarafından çağrılır. Varsayılan uygulama CMFCImageEditorDialog Sınıfı iletişim kutusunu görüntüler. Özel görüntü düzenleyicisi kullanmak için türetilmiş bir sınıfta geçersiz kılın OnEditToolbarMenuImage .

CMFCToolBarsCustomizeDialog::OnInitDialog

Özellik sayfası başlatmayı artırmak için geçersiz kılar.

virtual BOOL OnInitDialog();

İade Değeri

CPropertySheet::OnInitDialog yöntemini çağırmanın sonucu.

Açıklamalar

Bu yöntem, kapat düğmesini görüntüleyerek, iletişim kutusunun geçerli ekran boyutuna uyduğundan emin olarak ve Yardım düğmesini iletişim kutusunun sol alt köşesine taşıyarak CPropertySheet::OnInitDialog temel sınıf uygulamasını genişletir.

CMFCToolBarsCustomizeDialog::OnInitToolsPage

Çerçeveden Araçlar sayfasının başlatılmak üzere olduğuna ilişkin bildirimi işler.

virtual void OnInitToolsPage();

Açıklamalar

Varsayılan uygulama hiçbir şey yapmaz. Bu bildirimi işlemek için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCToolBarsCustomizeDialog::P ostNcDestroy

Pencere yok edildikten sonra çerçeve tarafından çağrılır.

virtual void PostNcDestroy();

Açıklamalar

Bu yöntem, CPropertySheet::PostNcDestroyuygulamayı önceki moda geri yükleyerek temel sınıf uygulamasını genişletir.

CMFCToolBarsCustomizeDialog::Create yöntemi, uygulamayı kullanıcıyı özelleştirme görevleriyle sınırlayan özel bir moda geçirir.

CMFCToolBarsCustomizeDialog::RemoveButton

Belirtilen komut kimliğine sahip düğmeyi belirtilen kategoriden veya tüm kategorilerden kaldırır.

int RemoveButton(
    UINT uiCategoryId,
    UINT uiCmdId);

int RemoveButton(
    LPCTSTR lpszCategory,
    UINT uiCmdId);

Parametreler

uiCategoryId
[in] Düğmenin kaldırılacağı kategori kimliğini belirtir.

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

lpszCategory
[in] Düğmenin kaldırılacağı kategorinin adını belirtir.

İade Değeri

Kaldırılan düğmenin sıfır tabanlı dizini veya belirtilen komut kimliği belirtilen kategoride bulunamadıysa -1. uiCategoryId değeri -1 ise, dönüş değeri 0 olur.

Açıklamalar

Bir düğmeyi tüm kategorilerden kaldırmak için bu yöntemin ilk aşırı yüklemesini çağırın ve uiCategoryId değerini -1 olarak ayarlayın.

CMFCToolBarsCustomizeDialog::RenameCategory

Komutlar sayfasındaki kategori liste kutusunda bir kategoriyi yeniden adlandırır .

BOOL RenameCategory(
    LPCTSTR lpszCategoryOld,
    LPCTSTR lpszCategoryNew);

Parametreler

lpszCategoryOld
[in] Değiştirecek kategori adı.

lpszCategoryNew
[in] Yeni kategori adı.

İade Değeri

Yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Kategori adı benzersiz olmalıdır.

CMFCToolBarsCustomizeDialog::ReplaceButton

Komutlar sayfasındaki komutların liste kutusundaki araç çubuğu düğmesinin yerini alır.

void ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button);

Parametreler

uiCmd
[in] Değiştirilecek düğmenin komutunu belirtir.

Düğme
[in] const Eski düğmenin yerini alan araç çubuğu düğmesi nesnesine başvuru.

Açıklamalar

CMFCToolBarsCustomizeDialog::AddMenu, CMFCToolBarsCustomizeDialog::AddMenuCommands veya CMFCToolBarsCustomizeDialog::AddToolBar Komutları sayfasına bir komut eklediğinde, bu komut CMFCToolBarButton Sınıf nesnesi (veya tarafından AddMenuCommandseklenen bir alt menü içeren menü öğesi için CMFCToolBarMenuButton Sınıfı nesnesi) biçimindedir. Çerçeve, komutları otomatik olarak eklemek için bu üç yöntemi de çağırır. Bunun yerine bir komutun türetilmiş bir türle gösterilmesini istiyorsanız, komutunu çağırın ReplaceButton ve türetilmiş türün bir düğmesini geçirin.

Örnek

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

// CMFCToolBarsCustomizeDialog* pDlgCust
     // CMFCToolBarComboBoxButton comboButtonConfig
     pDlgCust->ReplaceButton(ID_DUMMY_SELECT_ACTIVE_CONFIGURATION, comboButtonConfig);

CMFCToolBarsCustomizeDialog::SetUserCategory

Komutlar sayfasındaki kategori listesinde hangi kategorinin kullanıcı kategorisi olduğunu belirtir. CMFCToolBarsCustomizeDialog::Create öğesini çağırmadan önce bu işlevi çağırmalısınız.

BOOL SetUserCategory(LPCTSTR lpszCategory);

Parametreler

lpszCategory
[in] Kategorinin adı.

İade Değeri

Yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.

Açıklamalar

Kullanıcı kategorisi ayarı şu anda çerçeve tarafından kullanılmamakta.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CPropertySheet Sınıfı