CMFCEditBrowseCtrl osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az CMFCEditBrowseCtrl osztály támogatja a szerkesztési tallózás vezérlőt, amely egy szerkeszthető szövegdoboz, amely opcionálisan tartalmaz egy tallózás gombot. Amikor a felhasználó a tallózás gombra kattint, a vezérlő egyéni műveletet hajt végre, vagy egy szabványos párbeszédpanelt jelenít meg, amely egy fájlböngészőt vagy egy mappaböngészőt tartalmaz.

Szemantika

class CMFCEditBrowseCtrl : public CEdit

Tagok

Nyilvános konstruktorok

Név	Leírás
`CMFCEditBrowseCtrl::CMFCEditBrowseCtrl`	Alapértelmezett konstruktor.
`CMFCEditBrowseCtrl::~CMFCEditBrowseCtrl`	Destruktor.

Nyilvános metódusok

Név	Leírás
CMFCEditBrowseCtrl::EnableBrowseButton	Engedélyezi vagy letiltja (elrejti) a tallózás gombot.
CMFCEditBrowseCtrl::EnableFileBrowseButton	Engedélyezi a tallózás gombot, és fájlböngészés módban helyezi el a szerkesztési tallózás vezérlőt.
CMFCEditBrowseCtrl::EnableFolderBrowseButton	Engedélyezi a tallózás gombot, és a szerkesztési tallózás vezérlőt mappa tallózási módban helyezi el.
CMFCEditBrowseCtrl::GetMode	Az aktuális tallózási módot adja vissza.
CMFCEditBrowseCtrl::OnAfterUpdate	A keretrendszer meghívta, miután a szerkesztési tallózás vezérlő egy tallózási művelet eredményével frissült.
CMFCEditBrowseCtrl::OnBrowse	A keretrendszer meghívta, miután a felhasználó a tallózás gombra kattintott.
CMFCEditBrowseCtrl::OnChangeLayout	Újrarajzolva az aktuális szerkesztési tallózás vezérlőt.
CMFCEditBrowseCtrl::OnDrawBrowseButton	A keretrendszer meghívta, hogy megrajzolja a tallózás gombot.
CMFCEditBrowseCtrl::OnIllegalFileName	A keretrendszer meghívta, amikor egy illegális fájlnevet adott meg a szerkesztési vezérlőben.
`CMFCEditBrowseCtrl::PreTranslateMessage`	Lefordítja az ablaküzeneteket, mielőtt elküldené őket a TranslateMessage és a DispatchMessage Windows függvénybe. Szintaxist és további információt a CWnd::P reTranslateMessage című témakörben talál.
CMFCEditBrowseCtrl::SetBrowseButtonImage	Egyéni rendszerkép beállítása a tallózás gombhoz.

Megjegyzések

Fájl vagy mappanév kiválasztásához használjon szerkesztési tallózási vezérlőt. Ha szeretné, a vezérlővel egyéni műveletet hajthat végre, például megjeleníthet egy párbeszédpanelt. Megjelenítheti vagy nem jelenítheti meg a tallózás gombot, és alkalmazhat egyéni címkét vagy képet a gombra.

A szerkesztési tallózás vezérlő tallózási módja határozza meg, hogy megjelenik-e a tallózás gomb, és hogy milyen művelet történik a gombra kattintáskor. További információ: GetMode metódus.

Az CMFCEditBrowseCtrl osztály a következő módokat támogatja.

egyéni mód

A rendszer egyéni műveletet hajt végre, amikor a felhasználó a tallózás gombra kattint. Megjeleníthet például egy alkalmazásspecifikus párbeszédpanelt.
fájl mód

Egy szabványos fájlkijelölési párbeszédpanel jelenik meg, amikor a felhasználó a tallózás gombra kattint.
mappa mód

Egy szabványos mappakijelölési párbeszédpanel jelenik meg, amikor a felhasználó a tallózás gombra kattint.

Útmutató: Tallózás szerkesztése vezérlő megadása

A szerkesztési tallózás vezérlő alkalmazásba való beépítéséhez hajtsa végre az alábbi lépéseket:

Ha egyéni tallózási módot szeretne implementálni, a saját osztályát származtathatja az CMFCEditBrowseCtrl osztályból, majd felülbírálhatja a CMFCEditBrowseCtrl::OnBrowse metódust . A felülírt metódusban hajtsa végre az egyéni tallózási műveletet, és frissítse a szerkesztési tallózás vezérlőt az eredménnyel.
Ágyazza be az CMFCEditBrowseCtrl objektumot vagy a származtatott szerkesztési tallózásvezérlő objektumot a szülőablak-objektumba.
Ha az Osztály varázslóval hoz létre párbeszédpanelt, adjon hozzá egy szerkesztési vezérlőt (CEdit) a párbeszédpanel űrlaphoz. Emellett adjon hozzá egy változót a vezérlő eléréséhez a fejlécfájlban. A fejlécfájlban módosítsa a változó CEdit típusát a következőre CMFCEditBrowseCtrl: . A szerkesztési tallózás vezérlő automatikusan létrejön. Ha nem használja az Osztály varázslót, adjon hozzá egy változót CMFCEditBrowseCtrl a fejlécfájlhoz, majd hívja meg annak metódusát Create .
Ha szerkesztési tallózási vezérlőt ad hozzá egy párbeszédpanelhez, a ClassWizard eszközzel állíthatja be az adatcserét.
Hívja meg az EnableFolderBrowseButton, az EnableFileBrowseButton vagy az EnableBrowseButton metódust a tallózási mód beállításához és a tallózási gomb megjelenítéséhez. Az aktuális tallózási mód beszerzéséhez hívja meg a GetMode metódust.
Ha egyéni képet szeretne megadni a tallózás gombhoz, hívja meg a SetBrowseButtonImage metódust, vagy írja felül az OnDrawBrowseButton metódust .
Ha el szeretné távolítani a tallózás gombot a szerkesztési tallózás vezérlőből, hívja meg az EnableBrowseButton metódust a bEnable paraméter false (HAMIS) értékre állításával.

Öröklési hierarchia

példa

Az alábbi példa két metódus használatát mutatja be az CMFCEditBrowseCtrl osztályban: EnableFolderBrowseButton és EnableFileBrowseButton. Ez a példa az Új vezérlők mintarésze.

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();

Követelmények

Fejléc: afxeditbrowsectrl.h

CMFCEditBrowseCtrl::EnableBrowseButton

Megjeleníti vagy nem jeleníti meg a tallózás gombot az aktuális szerkesztési tallózás vezérlőn.

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

Paraméterek

bEnable
IGAZ a tallózás gomb megjelenítéséhez; HAMIS, ha nem jelenik meg a tallózás gomb. Az alapértelmezett érték IGAZ.

szLabel
A tallózás gombon megjelenő címke. Az alapértelmezett érték a következő: " ...".

Megjegyzések

Ha a bEnable paraméter IGAZ, implementáljon egy egyéni műveletet, amelyet a tallózás gombra kattintva hajthat végre. Egyéni művelet implementálásához származtatassunk egy osztályt az CMFCEditBrowseCtrl osztályból, majd felülbíráljuk az OnBrowse metódusát.

Ha a bEnable paraméter IGAZ, a vezérlőelem tallózási módja; BrowseMode_Defaultellenkező esetben a tallózási mód.BrowseMode_None A tallózási módokról további információt a GetMode metódusban talál.

CMFCEditBrowseCtrl::EnableFileBrowseButton

Megjeleníti a tallózás gombot az aktuális szerkesztési tallózási vezérlőn, és fájlböngésző módban helyezi el a vezérlőt.

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

Paraméterek

lpszDefExt
Megadja a fájlkijelölés párbeszédpanelen használt alapértelmezett fájlnévkiterjesztést. Az alapértelmezett érték NULL.

lpszFilter
Megadja a fájlkijelölési párbeszédpanelen használt alapértelmezett szűrősztringet. Az alapértelmezett érték NULL.

dwFlags
Párbeszédpanel-jelzők. Az alapértelmezett érték a OFN_HIDEREADONLY és OFN_OVERWRITEPROMPT bitenkénti (OR) kombinációja.

Megjegyzések

Ha a szerkesztési tallózás vezérlő fájlböngésző módban van, és a felhasználó a tallózás gombra kattint, a vezérlő megjeleníti a szokásos fájlkijelölési párbeszédpanelt.

Az elérhető jelölők teljes listáját lásd: OPENFILENAME struktúra.

CMFCEditBrowseCtrl::EnableFolderBrowseButton

Megjeleníti a tallózás gombot az aktuális szerkesztési tallózási vezérlőn, és a vezérlőt mappa tallózási módban helyezi el.

void EnableFolderBrowseButton();

Megjegyzések

Ha a szerkesztési tallózás vezérlő mappa tallózási módban van, és a felhasználó a tallózás gombra kattint, a vezérlő megjeleníti a szokásos mappakijelölési párbeszédpanelt.

CMFCEditBrowseCtrl::GetMode

Lekéri az aktuális szerkesztési tallózási vezérlő tallózási módját.

CMFCEditBrowseCtrl::BrowseMode GetMode() const;

Visszaadott érték

Az egyik számbavételi érték, amely a szerkesztési tallózás vezérlő aktuális módját adja meg. A tallózási mód határozza meg, hogy a keretrendszer megjeleníti-e a tallózás gombot, és hogy milyen művelet történik, amikor egy felhasználó erre a gombra kattint.

Az alábbi táblázat a lehetséges visszatérési értékeket sorolja fel.

Érték	Leírás
`BrowseMode_Default`	egyéni mód. Programozó által definiált művelet történik.
`BrowseMode_File`	fájlmódot. Megjelenik a standard fájlböngésző párbeszédpanel.
`BrowseMode_Folder`	mappamódot. Megjelenik a szokásos mappaböngésző párbeszédpanel.
`BrowseMode_None`	A tallózás gomb nem jelenik meg.

Megjegyzések

Alapértelmezés szerint egy CMFCEditBrowseCtrl objektum inicializálása módba BrowseMode_None történik. Módosítsa a tallózási módot a CMFCEditBrowseCtrl::EnableBrowseButton, CMFCEditBrowseCtrl::EnableFileBrowseButton és CMFCEditBrowseCtrl::EnableFolderBrowseButton metódusokkal.

CMFCEditBrowseCtrl::OnAfterUpdate

A keretrendszer meghívta, miután a szerkesztési tallózás vezérlő egy tallózási művelet eredményével frissült.

virtual void OnAfterUpdate();

Megjegyzések

Ezt a metódust felülbírálhatja egy származtatott osztályban egy egyéni művelet implementálásához.

CMFCEditBrowseCtrl::OnBrowse

A keretrendszer meghívta, miután a felhasználó a szerkesztési tallózás vezérlő tallózás gombjára kattintott.

virtual void OnBrowse();

Megjegyzések

Ezzel a módszerrel egyéni kódot hajthat végre, amikor a felhasználó a szerkesztési tallózás vezérlő tallózás gombjára kattint. Saját osztályt hozhat ki az CMFCEditBrowseCtrl osztályból, és felülbírálhatja annak metódusát OnBrowse . Ebben a metódusban implementáljon egy egyéni tallózási műveletet, és szükség esetén frissítse a szerkesztési tallózás vezérlő szövegdobozát. Az alkalmazásban az EnableBrowseButton metódussal egyéni tallózási módban helyezheti el a szerkesztési tallózás vezérlőt.

CMFCEditBrowseCtrl::OnChangeLayout

Újrarajzolva az aktuális szerkesztési tallózás vezérlőt.

virtual void OnChangeLayout();

Megjegyzések

A keretrendszer ezt a metódust hívja meg, amikor a szerkesztési tallózás vezérlőjének tallózási módja megváltozik. További információ: CMFCEditBrowseCtrl::GetMode.

CMFCEditBrowseCtrl::OnDrawBrowseButton

A keretrendszer meghívta, hogy megrajzolja a tallózás gombot a szerkesztési tallózás vezérlőn.

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

Paraméterek

pDC
Egy eszközkörnyezetre mutató mutató.

Süllyesztés
A tallózás gomb határoló téglalapja.

bIsButtonPressed
IGAZ, ha a gomb be van nyomva; egyéb esetben HAMIS.

bIsButtonHot
IGAZ, ha a gomb ki van emelve; egyéb esetben HAMIS.

Megjegyzések

Felülbírálja ezt a függvényt egy származtatott osztályban a tallózás gomb megjelenésének testreszabásához.

CMFCEditBrowseCtrl::SetBrowseButtonImage

Egyéni rendszerképet állít be a szerkesztési tallózás vezérlő tallózás gombjára.

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

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

void SetBrowseButtonImage(UINT uiBmpResId);

Paraméterek

hIcon
Egy ikon fogópontja.

hBitmap
Egy bitkép fogópontja.

uiBmpResId
Egy bitkép erőforrás-azonosítója.

bAutoDestroy
IGAZ, ha törli a megadott ikont vagy bitképet, amikor a metódus kilép; egyéb esetben HAMIS. Az alapértelmezett érték IGAZ.

Megjegyzések

Ezzel a módszerrel egyéni rendszerképet alkalmazhat a tallózás gombra. Alapértelmezés szerint a keretrendszer szabványos rendszerképet szerez be, ha a szerkesztési tallózás vezérlő fájlböngésző vagy mappa tallózási módban van.

CMFCEditBrowseCtrl::OnIllegalFileName

A keretrendszer meghívta, amikor egy illegális fájlnevet adott meg a szerkesztési vezérlőben.

virtual BOOL OnIllegalFileName(CString& strFileName);

Paraméterek

strFileName
Az illegális fájlnevet adja meg.

Visszaadott érték

HAMIS értéket kell visszaadnia, ha a fájlnév nem adható tovább a fájl párbeszédpaneljének. Ebben az esetben a fókusz vissza lesz állítva a szerkesztési vezérlőre, és a felhasználónak folytatnia kell a szerkesztést. Az alapértelmezett implementáció egy üzenetmezőt jelenít meg, amely közli a felhasználóval az illegális fájlnevet, és HAMIS értéket ad vissza. Felülbírálhatja ezt a metódust, kijavíthatja a fájlnevet, és true értéket adhat vissza a további feldolgozáshoz.

Megjegyzések

Lásd még

hierarchiadiagram
osztályok

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-11-07

Megosztás a következőn keresztül:

CMFCEditBrowseCtrl osztály

Szemantika

Tagok

Nyilvános konstruktorok

Nyilvános metódusok

Megjegyzések

Útmutató: Tallózás szerkesztése vezérlő megadása

Öröklési hierarchia

példa

Követelmények

CMFCEditBrowseCtrl::EnableBrowseButton

Paraméterek

Megjegyzések

CMFCEditBrowseCtrl::EnableFileBrowseButton

Paraméterek

Megjegyzések

CMFCEditBrowseCtrl::EnableFolderBrowseButton

Megjegyzések

CMFCEditBrowseCtrl::GetMode

Visszaadott érték

Megjegyzések

CMFCEditBrowseCtrl::OnAfterUpdate

Megjegyzések

CMFCEditBrowseCtrl::OnBrowse

Megjegyzések

CMFCEditBrowseCtrl::OnChangeLayout

Megjegyzések

CMFCEditBrowseCtrl::OnDrawBrowseButton

Paraméterek

Megjegyzések

CMFCEditBrowseCtrl::SetBrowseButtonImage

Paraméterek

Megjegyzések

CMFCEditBrowseCtrl::OnIllegalFileName

Paraméterek

Visszaadott érték

Megjegyzések

Lásd még

Visszajelzés

További források