CMFCEditBrowseCtrl Sınıfı

sınıfı CMFCEditBrowseCtrl , isteğe bağlı olarak göz atma düğmesi içeren düzenlenebilir bir metin kutusu olan düzenleme göz atma denetimini destekler. Kullanıcı gözat düğmesine tıkladığında, denetim özel bir eylem gerçekleştirir veya dosya tarayıcısı veya klasör tarayıcısı içeren standart bir iletişim kutusu görüntüler.

Sözdizimi

class CMFCEditBrowseCtrl : public CEdit

Üyeler

Ortak Oluşturucular

Adı	Açıklama
CMFCEditBrowseCtrl::CMFCEditBrowseCtrl	Varsayılan oluşturucu.
CMFCEditBrowseCtrl::~CMFCEditBrowseCtrl	Yıkıcı.

Genel Yöntemler

Adı	Açıklama
CMFCEditBrowseCtrl::EnableBrowseButton	Gözat düğmesini etkinleştirir veya devre dışı bırakır (gizler).
CMFCEditBrowseCtrl::EnableFileBrowseButton	Gözat düğmesini etkinleştirir ve düzenleme gözatma denetimini dosya gözatma moduna alır.
CMFCEditBrowseCtrl::EnableFolderBrowseButton	Gözat düğmesini etkinleştirir ve düzenleme göz atma denetimini klasör göz atma moduna alır.
CMFCEditBrowseCtrl::GetMode	Geçerli göz atma modunu döndürür.
CMFCEditBrowseCtrl::OnAfterUpdate	Düzenleme gözatma denetimi bir göz atma eyleminin sonucuyla güncelleştirildikten sonra çerçeve tarafından çağrılır.
CMFCEditBrowseCtrl::OnBrowse	Kullanıcı gözat düğmesine tıkladıktan sonra çerçeve tarafından çağrılır.
CMFCEditBrowseCtrl::OnChangeLayout	Geçerli düzenleme gözatma denetimini yeniden çizer.
CMFCEditBrowseCtrl::OnDrawBrowseButton	Gözat düğmesini çizmek için çerçeve tarafından çağrılır.
CMFCEditBrowseCtrl::OnIllegalFileName	Düzenleme denetimine geçersiz bir dosya adı girildiğinde çerçeve tarafından çağrılır.
CMFCEditBrowseCtrl::PreTranslateMessage	Pencere iletilerini TranslateMessage ve DispatchMessage Windows işlevlerine göndermeden önce çevirir. Söz dizimi ve daha fazla bilgi için bkz . CWnd::P reTranslateMessage.
CMFCEditBrowseCtrl::SetBrowseButtonImage	Gözat düğmesi için özel bir görüntü ayarlar.

Açıklamalar

Bir dosya veya klasör adı seçmek için düzenleme gözatma denetimi kullanın. İsteğe bağlı olarak, iletişim kutusunu görüntüleme gibi özel bir eylem gerçekleştirmek için denetimi kullanın. Gözat düğmesini görüntüleyebilir veya görüntülemeyebilirsiniz ve düğmeye özel bir etiket veya resim uygulayabilirsiniz.

Düzenleme gözatma denetiminin gözatma modu, gözatma düğmesinin görüntülenip görüntülenmeyeceğini ve düğmeye tıklandığında hangi eylemin gerçekleşeceğini belirler. Daha fazla bilgi için bkz . GetMode yöntemi.

CMFCEditBrowseCtrl sınıfı aşağıdaki modları destekler.

• özel mod

  Kullanıcı gözat düğmesine tıkladığında özel bir eylem gerçekleştirilir. Örneğin, uygulamaya özgü bir iletişim kutusunu görüntüleyebilirsiniz.

• dosya modu

  Kullanıcı gözat düğmesine tıkladığında standart bir dosya seçimi iletişim kutusu görüntülenir.

• klasör modu

  Kullanıcı gözat düğmesine tıkladığında standart klasör seçimi iletişim kutusu görüntülenir.

Nasıl Yapılır: Düzenleme Gözatma Denetimi Belirtme

Uygulamanıza bir düzenleme göz atma denetimi eklemek için aşağıdaki adımları gerçekleştirin:

1. Özel bir gözatma modu uygulamak istiyorsanız, sınıfından CMFCEditBrowseCtrl kendi sınıfınızı türetin ve ardından CMFCEditBrowseCtrl::OnBrowse yöntemini geçersiz kılın. Geçersiz kılınan yöntemde özel bir gözatma eylemi yürütür ve düzenleme göz atma denetimini sonuçla güncelleştirir.

2. CMFCEditBrowseCtrl Nesneyi veya türetilmiş düzenleme gözatma denetim nesnesini üst pencere nesnesine ekleyin.

3. Bir iletişim kutusu oluşturmak için Sınıf Sihirbazı'nı kullanırsanız, iletişim kutusu formuna bir düzenleme denetimi ( CEdit) ekleyin. Ayrıca, üst bilgi dosyanızdaki denetime erişmek için bir değişken ekleyin. Üst bilgi dosyanızda değişkeninin CEdit CMFCEditBrowseCtrltürünü olarak değiştirin. Düzenleme gözatma denetimi otomatik olarak oluşturulur. Sınıf Sihirbazı'nı kullanmıyorsanız, üst bilgi dosyanıza bir CMFCEditBrowseCtrl değişken ekleyin ve yöntemini çağırınCreate.

4. bir iletişim kutusuna düzenleme gözatma denetimi eklerseniz, veri değişimini ayarlamak için ClassWizard aracını kullanın.

5. Gözatma modunu ayarlamak ve göz atma düğmesini görüntülemek için EnableFolderBrowseButton, EnableFileBrowseButton veya EnableBrowseButton yöntemini çağırın. Geçerli göz atma modunu almak için GetMode yöntemini çağırın.

6. Gözat düğmesi için özel bir görüntü sağlamak için SetBrowseButtonImage yöntemini çağırın veya OnDrawBrowseButton yöntemini geçersiz kılın.

7. Gözat düğmesini düzenleme göz atma denetiminden kaldırmak için, bEnable parametresi YANLIŞ olarak ayarlanmış EnableBrowseButton yöntemini çağırın.

Devralma Hiyerarşisi

Cobject

Ccmdtarget

Cwnd

Cedit

Cmfceditbrowsectrl

Örnek

Aşağıdaki örnekte, sınıfında iki yöntemin CMFCEditBrowseCtrl nasıl kullanılacağı gösterilmektedir: EnableFolderBrowseButton ve EnableFileBrowseButton. Bu örnek, Yeni Denetimler örneğinin bir parçasıdır.

CMFCEditBrowseCtrl m_wndFolderEdit;
CMFCEditBrowseCtrl m_wndFileEdit;

// enable the browse button and put the control in file browse mode
m_wndFolderEdit.EnableFolderBrowseButton();
// enable the browse button and put the control in the folder browse mode
m_wndFileEdit.EnableFileBrowseButton();

Gereksinimler

Üst bilgi: afxeditbrowsectrl.h

CMFCEditBrowseCtrl::EnableBrowseButton

Geçerli düzenleme gözatma denetiminde gözat düğmesini görüntüler veya görüntülemez.

void EnableBrowseButton(
    BOOL bEnable=TRUE,
    LPCTSTR szLabel=_T("..."));

Parametreler

bEnable
Gözat düğmesini görüntülemek için DOĞRU; Gözat düğmesini görüntülememek için YANLIŞ. Varsayılan değer DOĞRU'dur.

szLabel
Gözat düğmesinde görüntülenen etiket. Varsayılan değer " ..." şeklindedir.

Açıklamalar

bEnable parametresi TRUE ise, gözat düğmesine tıklandığında gerçekleştirilecek özel bir eylem uygulayın. Özel bir eylem uygulamak için sınıfından CMFCEditBrowseCtrl bir sınıf türetin ve ardından OnBrowse yöntemini geçersiz kılın.

bEnable parametresi TRUE ise, denetimin göz atma modu olurBrowseMode_Default; aksi takdirde göz atma modu olurBrowseMode_None. Göz atma modları hakkında daha fazla bilgi için bkz . GetMode yöntemi.

CMFCEditBrowseCtrl::EnableFileBrowseButton

Geçerli düzenleme gözatma denetimindeki gözat düğmesini görüntüler ve denetimi dosya gözatma moduna alır.

void EnableFileBrowseButton(
    LPCTSTR lpszDefExt=NULL,
    LPCTSTR lpszFilter=NULL,
    DWORD dwFlags = OFN_HIDEREADONLY | OFN_OVERWRITEPROMPT);

Parametreler

lpszDefExt
Dosya seçimi iletişim kutusunda kullanılan varsayılan dosya adı uzantısını belirtir. Varsayılan değer NULL'dir.

lpszFilter
Dosya seçimi iletişim kutusunda kullanılan varsayılan filtre dizesini belirtir. Varsayılan değer NULL'dir.

Dwflags
İletişim kutusu bayrakları. Varsayılan değer, OFN_HIDEREADONLY ve OFN_OVERWRITEPROMPT bit düzeyinde bir bileşimdir (OR).

Açıklamalar

Gözatma düzenleme denetimi dosya gözatma modundayken kullanıcı gözat düğmesine tıkladığında, denetim standart dosya seçimi iletişim kutusunu görüntüler.

Kullanılabilir bayrakların tam listesi için bkz . OPENFILENAME yapısı.

CMFCEditBrowseCtrl::EnableFolderBrowseButton

Geçerli düzenleme gözatma denetimindeki gözat düğmesini görüntüler ve denetimi klasör göz atma moduna alır.

void EnableFolderBrowseButton();

Açıklamalar

Gözatma düzenleme denetimi klasör göz atma modundayken kullanıcı gözat düğmesine tıkladığında, denetim standart klasör seçimi iletişim kutusunu görüntüler.

CMFCEditBrowseCtrl::GetMode

Geçerli düzenleme gözatma denetiminin göz atma modunu alır.

CMFCEditBrowseCtrl::BrowseMode GetMode() const;

İade Değeri

Düzenleme gözatma denetiminin geçerli modunu belirten numaralandırma değerlerinden biri. Gözatma modu, çerçevenin gözat düğmesini görüntüleyip görüntülemediğini ve kullanıcı bu düğmeye tıkladığında hangi eylemin gerçekleşeceğini belirler.

Aşağıdaki tabloda olası dönüş değerleri listelemektedir.

Değer	Açıklama
BrowseMode_Default	özel mod. Programcı tanımlı bir eylem gerçekleştirilir.
BrowseMode_File	dosya modu. Standart dosya tarayıcısı iletişim kutusu görüntülenir.
BrowseMode_Folder	klasör modu. Standart klasör tarayıcısı iletişim kutusu görüntülenir.
BrowseMode_None	Gözat düğmesi görüntülenmez.

Açıklamalar

Varsayılan olarak, bir CMFCEditBrowseCtrl nesne moda başlatılır BrowseMode_None . Göz atma modunu CMFCEditBrowseCtrl::EnableBrowseButton, CMFCEditBrowseCtrl::EnableFileBrowseButton ve CMFCEditBrowseCtrl::EnableFolderBrowseButton yöntemleriyle değiştirin.

CMFCEditBrowseCtrl::OnAfterUpdate

Düzenleme gözatma denetimi bir göz atma eyleminin sonucuyla güncelleştirildikten sonra çerçeve tarafından çağrılır.

virtual void OnAfterUpdate();

Açıklamalar

Özel bir eylem uygulamak için türetilmiş bir sınıfta bu yöntemi geçersiz kılın.

CMFCEditBrowseCtrl::OnBrowse

Kullanıcı düzenleme gözatma denetiminin gözat düğmesine tıkladıktan sonra çerçeve tarafından çağrılır.

virtual void OnBrowse();

Açıklamalar

Kullanıcı düzenleme gözatma denetiminin gözat düğmesine tıkladığında özel kod yürütmek için bu yöntemi kullanın. sınıfından CMFCEditBrowseCtrl kendi sınıfınızı türetin ve yöntemini geçersiz kılın OnBrowse . Bu yöntemde, özel bir göz atma eylemi uygulayın ve isteğe bağlı olarak düzenleme göz atma denetiminin metin kutusunu güncelleştirin. Uygulamanızda EnableBrowseButton yöntemini kullanarak düzenleme göz atma denetimini özel göz atma moduna geçirin.

CMFCEditBrowseCtrl::OnChangeLayout

Geçerli düzenleme gözatma denetimini yeniden çizer.

virtual void OnChangeLayout();

Açıklamalar

Düzenleme gözatma denetiminin gözatma modu değiştiğinde çerçeve bu yöntemi çağırır. Daha fazla bilgi için bkz . CMFCEditBrowseCtrl::GetMode.

CMFCEditBrowseCtrl::OnDrawBrowseButton

Düzenleme gözatma denetiminde gözat düğmesini çizmek için çerçeve tarafından çağrılır.

virtual void OnDrawBrowseButton(
    CDC* pDC,
    CRect rect,
    BOOL bIsButtonPressed,
    BOOL bIsButtonHot);

Parametreler

Pdc
Cihaz bağlamı işaretçisi.

Rect
Gözat düğmesinin sınırlayıcı dikdörtgeni.

bIsButtonPressed
Düğmeye basıldığında TRUE; aksi takdirde YANLIŞ.

bIsButtonHot
Düğme vurgulanmışsa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Gözat düğmesinin görünümünü özelleştirmek için türetilmiş bir sınıfta bu işlevi geçersiz kılın.

CMFCEditBrowseCtrl::SetBrowseButtonImage

Düzenleme gözatma denetiminin gözat düğmesinde özel bir görüntü ayarlar.

void SetBrowseButtonImage(
    HICON hIcon,
    BOOL bAutoDestroy= TRUE);

void SetBrowseButtonImage(
    HBITMAP hBitmap,
    BOOL bAutoDestroy= TRUE);

void SetBrowseButtonImage(UINT uiBmpResId);

Parametreler

Hıcon
Simgenin tutamacı.

Hbıtmap
Bit eşlem tutamacı.

uiBmpResId
Bit eşlem kaynak kimliği.

bAutoDestroy
Bu yöntemden çıkıldığında belirtilen simgeyi veya bit eşlemi silmek için TRUE; aksi takdirde YANLIŞ. Varsayılan değer DOĞRU'dur.

Açıklamalar

Gözat düğmesine özel görüntü uygulamak için bu yöntemi kullanın. Varsayılan olarak, düzenleme gözatma denetimi dosya gözatma veya klasör göz atma modundayken çerçeve standart bir görüntü alır.

CMFCEditBrowseCtrl::OnIllegalFileName

Düzenleme denetimine geçersiz bir dosya adı girildiğinde çerçeve tarafından çağrılır.

virtual BOOL OnIllegalFileName(CString& strFileName);

Parametreler

strFileName
Geçersiz dosya adını belirtir.

İade Değeri

Bu dosya adı dosya iletişim kutusuna daha fazla geçirilemiyorsa FALSE döndürmelidir. Bu durumda, odak yeniden düzenleme denetimine ayarlanır ve kullanıcının düzenlemeye devam etmesi gerekir. Varsayılan uygulama, kullanıcıya geçersiz dosya adını söyleyen bir ileti kutusu görüntüler ve YANLIŞ döndürür. Bu yöntemi geçersiz kılabilir, dosya adını düzeltebilir ve daha fazla işlem için TRUE döndürebilirsiniz.

Açıklamalar

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar