CMFCEditBrowseCtrl – třída

Třída CMFCEditBrowseCtrl podporuje ovládací prvek pro procházení úprav, což je upravitelné textové pole, které volitelně obsahuje tlačítko procházet. Když uživatel klikne na tlačítko procházet, ovládací prvek provede vlastní akci nebo zobrazí standardní dialogové okno, které obsahuje prohlížeč souborů nebo prohlížeč složek.

Syntaxe

class CMFCEditBrowseCtrl : public CEdit

Členové

Veřejné konstruktory

Název	Popis
CMFCEditBrowseCtrl::CMFCEditBrowseCtrl	Výchozí konstruktor.
CMFCEditBrowseCtrl::~CMFCEditBrowseCtrl	Destruktor.

Veřejné metody

Název	Popis
CMFCEditBrowseCtrl::EnableBrowseButton	Povolí nebo zakáže (skryje) tlačítko procházet.
CMFCEditBrowseCtrl::EnableFileBrowseButton	Povolí tlačítko procházet a umístí ovládací prvek pro procházení úprav do režimu procházení souborů.
CMFCEditBrowseCtrl::EnableFolderBrowseButton	Povolí tlačítko procházet a umístí ovládací prvek pro procházení úprav do režimu procházení složek.
CMFCEditBrowseCtrl::GetMode	Vrátí aktuální režim procházení.
CMFCEditBrowseCtrl::OnAfterUpdate	Volá se rozhraním po aktualizaci ovládacího prvku pro procházení s výsledkem akce procházení.
CMFCEditBrowseCtrl::OnBrowse	Volá se rozhraním poté, co uživatel klikne na tlačítko procházet.
CMFCEditBrowseCtrl::OnChangeLayout	Překreslí aktuální ovládací prvek pro procházení úprav.
CMFCEditBrowseCtrl::OnDrawBrowseButton	Volá se rozhraním, které nakreslete tlačítko procházet.
CMFCEditBrowseCtrl::OnIllegalFileName	Volá se rozhraním, když byl v ovládacím prvku pro úpravy zadán neplatný název souboru.
CMFCEditBrowseCtrl::PreTranslateMessage	Překládá zprávy okna před odesláním do funkcí TranslateMessage a DispatchMessage systému Windows. Syntaxe a další informace naleznete v tématu CWnd::P reTranslateMessage.
CMFCEditBrowseCtrl::SetBrowseButtonImage	Nastaví vlastní obrázek pro tlačítko procházet.

Poznámky

Pomocí ovládacího prvku pro procházení úprav vyberte název souboru nebo složky. Volitelně můžete ovládací prvek použít k provedení vlastní akce, například k zobrazení dialogového okna. Můžete zobrazit nebo nezobrazovat tlačítko procházet a na tlačítko můžete použít vlastní popisek nebo obrázek.

Režim procházení ovládacího prvku pro procházení úprav určuje, jestli se zobrazí tlačítko procházet a jaká akce se provede po kliknutí na tlačítko. Další informace naleznete v GetMode metoda.

Třída CMFCEditBrowseCtrl podporuje následující režimy.

• vlastní režim

  Vlastní akce se provede, když uživatel klikne na tlačítko Procházet. Můžete například zobrazit dialogové okno specifické pro aplikaci.

• režim souboru

  Když uživatel klikne na tlačítko Procházet, zobrazí se standardní dialogové okno pro výběr souboru.

• režim složky

  Když uživatel klikne na tlačítko Procházet, zobrazí se standardní dialogové okno pro výběr složky.

Postupy: Určení ovládacího prvku Pro úpravy procházení

Provedením následujících kroků začleníte ovládací prvek pro procházení úprav do aplikace:

1. Pokud chcete implementovat vlastní režim procházení, odvodit vlastní třídu z CMFCEditBrowseCtrl třídy a pak přepsat CMFCEditBrowseCtrl::OnBrowse metoda. V přepsáné metodě spusťte vlastní akci procházení a aktualizujte ovládací prvek pro procházení úprav s výsledkem.

2. CMFCEditBrowseCtrl Vložte objekt nebo odvozený objekt pro procházení ovládacích prvků do nadřazeného objektu okna.

3. Pokud k vytvoření dialogového okna použijete Průvodce třídou, přidejte do formuláře dialogového okna ovládací prvek pro úpravy ( CEdit). Přidejte také proměnnou pro přístup k ovládacímu prvku v souboru záhlaví. V souboru záhlaví změňte typ proměnné z CEdit na CMFCEditBrowseCtrl. Ovládací prvek pro úpravy procházení se vytvoří automaticky. Pokud průvodce třídou nepoužíváte, přidejte do souboru záhlaví proměnnou CMFCEditBrowseCtrl a pak volejte její Create metodu.

4. Pokud do dialogového okna přidáte ovládací prvek pro procházení úprav, nastavte výměnu dat pomocí nástroje ClassWizard .

5. Volání EnableFolderBrowseButton, EnableFileBrowseButton nebo EnableBrowseButton metoda nastavit režim procházení a zobrazit tlačítko procházet. Volání GetMode metoda získat aktuální režim procházení.

6. Chcete-li poskytnout vlastní image pro tlačítko procházet, zavolejte SetBrowseButtonImage metoda nebo přepsat OnDrawBrowseButton metoda.

7. Chcete-li odebrat tlačítko procházet z ovládacího prvku pro procházení úprav, zavolejte EnableBrowseButton metoda s parametrem bEnable nastaveným na FALSE.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

Cwnd

CEdit

CMFCEditBrowseCtrl

Příklad

Následující příklad ukazuje, jak použít dvě metody ve CMFCEditBrowseCtrl třídě: EnableFolderBrowseButton a EnableFileBrowseButton. Tento příklad je součástí ukázky Nové ovládací prvky.

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

Požadavky

Hlavička: afxeditbrowsectrl.h

CMFCEditBrowseCtrl::EnableBrowseButton

Zobrazí nebo nezobrazuje tlačítko procházet v aktuálním ovládacím prvku pro procházení úprav.

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

Parametry

bEnable
TRUE pro zobrazení tlačítka procházet; NEPRAVDA, aby se nezobrazovat tlačítko procházet. Výchozí hodnota je PRAVDA.

szLabel
Popisek, který se zobrazí na tlačítku procházet Výchozí hodnota je ....

Poznámky

Pokud je parametr bEnable TRUE, implementujte vlastní akci, která se má provést při kliknutí na tlačítko procházet. Chcete-li implementovat vlastní akci, odvodit třídu z CMFCEditBrowseCtrl třídy a pak přepsat jeho OnBrowse metoda.

Pokud má parametr bEnable hodnotu TRUE, je režim procházení ovládacího prvku BrowseMode_Default; v opačném případě je BrowseMode_Nonerežim procházení . Další informace o režimech procházení naleznete v GetMode metoda.

CMFCEditBrowseCtrl::EnableFileBrowseButton

Zobrazí tlačítko procházet v aktuálním ovládacím prvku pro procházení úprav a umístí ovládací prvek do režimu procházení souborů.

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

Parametry

lpszDefExt
Určuje výchozí příponu názvu souboru, která se používá v dialogovém okně pro výběr souboru. Výchozí hodnota je NULL.

lpszFilter
Určuje výchozí řetězec filtru, který se používá v dialogovém okně pro výběr souboru. Výchozí hodnota je NULL.

dwFlags
Příznaky dialogového okna Výchozí hodnota je bitové kombinace (OR) OFN_HIDEREADONLY a OFN_OVERWRITEPROMPT.

Poznámky

Když je ovládací prvek pro procházení úprav v režimu procházení souborů a uživatel klikne na tlačítko Procházet, zobrazí se standardní dialogové okno pro výběr souboru.

Úplný seznam dostupných příznaků naleznete ve struktuře OPENFILENAME.

CMFCEditBrowseCtrl::EnableFolderBrowseButton

Zobrazí tlačítko procházet v aktuálním ovládacím prvku pro procházení úprav a umístí ovládací prvek do režimu procházení složek.

void EnableFolderBrowseButton();

Poznámky

Když je ovládací prvek pro procházení úprav v režimu procházení složek a uživatel klikne na tlačítko procházet, zobrazí se standardní dialogové okno pro výběr složky.

CMFCEditBrowseCtrl::GetMode

Načte režim procházení aktuálního ovládacího prvku pro procházení.

CMFCEditBrowseCtrl::BrowseMode GetMode() const;

Vrácená hodnota

Jedna z hodnot výčtu, která určuje aktuální režim ovládacího prvku pro procházení úprav. Režim procházení určuje, jestli rozhraní zobrazí tlačítko procházet a jaká akce se stane, když uživatel klikne na toto tlačítko.

Následující tabulka uvádí možné návratové hodnoty.

Hodnota	Popis
BrowseMode_Default	vlastní režim. Provede se akce definovaná programátorem.
BrowseMode_File	režim souboru. Zobrazí se standardní dialogové okno prohlížeče souborů.
BrowseMode_Folder	režim složky. Zobrazí se standardní dialogové okno prohlížeče složek.
BrowseMode_None	Tlačítko procházet se nezobrazuje.

Poznámky

Ve výchozím nastavení CMFCEditBrowseCtrl je objekt inicializován do BrowseMode_None režimu. Upravte režim procházení pomocí CMFCEditBrowseCtrl::EnableBrowseButton, CMFCEditBrowseCtrl::EnableFileBrowseButton a CMFCEditBrowseCtrl::EnableFolderBrowseButton metody.

CMFCEditBrowseCtrl::OnAfterUpdate

Volá se rozhraním po aktualizaci ovládacího prvku pro procházení s výsledkem akce procházení.

virtual void OnAfterUpdate();

Poznámky

Přepsat tuto metodu v odvozené třídě implementovat vlastní akci.

CMFCEditBrowseCtrl::OnBrowse

Volá se rozhraním poté, co uživatel klikne na tlačítko procházet v ovládacím prvku pro procházení úprav.

virtual void OnBrowse();

Poznámky

Tuto metodu použijte ke spuštění vlastního kódu, když uživatel klikne na tlačítko procházet v ovládacím prvku pro procházení úprav. Odvozujte vlastní třídu z CMFCEditBrowseCtrl třídy a přepište její OnBrowse metodu. V této metodě implementujte vlastní akci procházení a volitelně aktualizujte textové pole ovládacího prvku pro procházení úprav. V aplikaci použijte EnableBrowseButton metoda vložit ovládací prvek pro úpravy procházení do vlastního režimu procházení .

CMFCEditBrowseCtrl::OnChangeLayout

Překreslí aktuální ovládací prvek pro procházení úprav.

virtual void OnChangeLayout();

Poznámky

Architektura volá tuto metodu, když se změní režim procházení ovládacího prvku pro procházení. Další informace naleznete v tématu CMFCEditBrowseCtrl::GetMode.

CMFCEditBrowseCtrl::OnDrawBrowseButton

Volá se rozhraním pro kreslení tlačítka procházet v ovládacím prvku pro procházení úprav.

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

Parametry

Pdc
Ukazatel na kontext zařízení.

Rect
Ohraničující obdélník tlačítka procházet

bIsButtonPressed
TRUE, pokud je tlačítko stisknuto; jinak NEPRAVDA.

bIsButtonHot
TRUE, pokud je tlačítko zvýrazněno; jinak NEPRAVDA.

Poznámky

Přepsat tuto funkci v odvozené třídě přizpůsobit vzhled tlačítka procházet.

CMFCEditBrowseCtrl::SetBrowseButtonImage

Nastaví vlastní obrázek na tlačítku procházet ovládací prvek pro procházení.

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

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

void SetBrowseButtonImage(UINT uiBmpResId);

Parametry

hIcon
Úchyt ikony.

hBitmap
Úchyt rastrového obrázku.

uiBmpResId
ID prostředku rastrového obrázku.

bAutoDestroy
TRUE pro odstranění zadané ikony nebo rastrového obrázku při ukončení této metody; jinak NEPRAVDA. Výchozí hodnota je PRAVDA.

Poznámky

Tuto metodu použijte k použití vlastního obrázku na tlačítko procházet. Ve výchozím nastavení rozhraní získá standardní obrázek, když je ovládací prvek pro procházení úprav v režimu procházení souborů nebo složky .

CMFCEditBrowseCtrl::OnIllegalFileName

Volá se rozhraním, když byl v ovládacím prvku pro úpravy zadán neplatný název souboru.

virtual BOOL OnIllegalFileName(CString& strFileName);

Parametry

Strfilename
Určuje neplatný název souboru.

Vrácená hodnota

Pokud tento název souboru nelze předat dál do dialogového okna souboru, měla by se vrátit nePRAVDA. V tomto případě je fokus nastavený zpět na ovládací prvek pro úpravy a uživatel by měl pokračovat v úpravách. Výchozí implementace zobrazí okno se zprávou s informací o neplatném názvu souboru a vrátí hodnotu FALSE. Tuto metodu můžete přepsat, opravit název souboru a vrátit hodnotu TRUE pro další zpracování.

Poznámky

Viz také

Graf hierarchie
Třídy