Dela via

CMFCEditBrowseCtrl-klass

Klassen CMFCEditBrowseCtrl har stöd för kontrollen redigera b bläddra, vilket är en redigerbar textruta som eventuellt innehåller en b bläddra-knapp. När användaren klickar på blädderingsknappen utför kontrollen en anpassad åtgärd eller visar en standarddialogruta som innehåller en filwebbläsare eller en mappwebbläsare.

Syntax

class CMFCEditBrowseCtrl : public CEdit

Medlemmar

Offentliga konstruktorer

Namn Beskrivning
CMFCEditBrowseCtrl::CMFCEditBrowseCtrl Standardkonstruktor.
CMFCEditBrowseCtrl::~CMFCEditBrowseCtrl Destructor.

Offentliga metoder

Namn Beskrivning
CMFCEditBrowseCtrl::EnableBrowseButton Aktiverar eller inaktiverar (döljer) b bläddra-knappen.
CMFCEditBrowseCtrl::EnableFileBrowseButton Aktiverar bläddra-knappen och placerar kontrollen redigera bläddra i fil bläddra läge.
CMFCEditBrowseCtrl::EnableFolderBrowseButton Aktiverar bläddra-knappen och placerar kontrollen redigera bläddra i mapp bläddra läge.
CMFCEditBrowseCtrl::GetMode Returnerar det aktuella bläddra-läget.
CMFCEditBrowseCtrl::OnAfterUpdate Anropas av ramverket när kontrollen för att redigera bläddra har uppdaterats med resultatet av en bläddra-åtgärd.
CMFCEditBrowseCtrl::OnBrowse Anropas av ramverket när användaren klickar på bläddra-knappen.
CMFCEditBrowseCtrl::OnChangeLayout Ritar om den aktuella redigeringskontrollen.
CMFCEditBrowseCtrl::OnDrawBrowseButton Anropas av ramverket för att rita bläddra-knappen.
CMFCEditBrowseCtrl::OnIllegalFileName Anropas av ramverket när ett ogiltigt filnamn angavs i redigeringskontrollen.
CMFCEditBrowseCtrl::PreTranslateMessage Översätter fönstermeddelanden innan de skickas till funktionerna TranslateMessage och DispatchMessage Windows. Syntax och mer information finns i CWnd::P reTranslateMessage.
CMFCEditBrowseCtrl::SetBrowseButtonImage Anger en anpassad avbildning för b bläddra-knappen.

Anmärkningar

Använd en redigeringskontroll för att välja ett fil- eller mappnamn. Du kan också använda kontrollen för att utföra en anpassad åtgärd, till exempel för att visa en dialogruta. Du kan visa eller inte visa b bläddra-knappen och du kan använda en anpassad etikett eller bild på knappen.

Bläddra-läget för kontrollen redigera bläddra avgör om den visar en bläddra-knapp och vilken åtgärd som inträffar när knappen klickas. Mer information finns i metoden GetMode .

Klassen CMFCEditBrowseCtrl stöder följande lägen.

  • anpassat läge

    En anpassad åtgärd utförs när användaren klickar på bläddra-knappen. Du kan till exempel visa en programspecifik dialogruta.

  • filläge

    En standarddialogruta för filval visas när användaren klickar på bläddra-knappen.

  • mappläge

    En standarddialogruta för mappval visas när användaren klickar på bläddra-knappen.

Instruktioner: Ange en Redigera bläddra-kontroll

Utför följande steg för att införliva en redigeringskontroll i ditt program:

  1. Om du vill implementera ett anpassat bläddringsläge härleder du din egen klass från CMFCEditBrowseCtrl klassen och åsidosätter sedan metoden CMFCEditBrowseCtrl::OnBrowse . I den åsidosatta metoden kör du en anpassad sökåtgärd och uppdaterar kontrollen för att redigera bläddra med resultatet.

  2. Bädda in antingen CMFCEditBrowseCtrl objektet eller det härledda redigeringskontrollobjektet i det överordnade fönsterobjektet.

  3. Om du använder klassguiden för att skapa en dialogruta lägger du till en redigeringskontroll (CEdit) i dialogruteformuläret. Lägg också till en variabel för att komma åt kontrollen i huvudfilen. I rubrikfilen ändrar du variabeltypen från CEdit till CMFCEditBrowseCtrl. Kontrollen redigera bläddra skapas automatiskt. Om du inte använder klassguiden lägger du till en CMFCEditBrowseCtrl variabel i rubrikfilen och anropar sedan dess Create metod.

  4. Om du lägger till en redigeringskontroll i en dialogruta använder du verktyget ClassWizard för att konfigurera datautbyte.

  5. Anropa metoden EnableFolderBrowseButton, EnableFileBrowseButton eller EnableBrowseButton för att ange bläddringsläget och visa bläddringsknappen. Anropa GetMode-metoden för att hämta det aktuella blyssningsläget.

  6. Om du vill ange en anpassad avbildning för bläddringsknappen anropar du metoden SetBrowseButtonImage eller åsidosätter metoden OnDrawBrowseButton .

  7. Om du vill ta bort bläddringsknappen från kontrollen redigera bläddra anropar du metoden EnableBrowseButton med parametern bEnable inställd på FALSE.

Arvshierarki

CObject

CCmdTarget

CWnd

CEdit

CMFCEditBrowseCtrl

Exempel

I följande exempel visas hur du använder två metoder i CMFCEditBrowseCtrl klassen: EnableFolderBrowseButton och EnableFileBrowseButton. Det här exemplet är en del av exemplet Nya kontroller.

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

Kravspecifikation

Rubrik: afxeditbrowsectrl.h

CMFCEditBrowseCtrl::EnableBrowseButton

Visar eller visar inte bläddra-knappen i den aktuella redigeringskontrollen.

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

Parameterar

bEnable
TRUE för att visa bläddra-knappen; FALSE för att inte visa bläddra-knappen. Standardvärdet är TRUE.

szLabel
Etiketten som visas på bläddra-knappen. Standardvärdet är " ...".

Anmärkningar

Om parametern bEnable är TRUE implementerar du en anpassad åtgärd som ska utföras när bbädningsknappen klickas. Om du vill implementera en anpassad åtgärd härleder du en klass från CMFCEditBrowseCtrl klassen och åsidosätter sedan dess OnBrowse-metod .

Om parametern bEnable är TRUE är BrowseMode_Defaultkontrollens bbädningsläge . Annars är BrowseMode_Nonebäddningsläget . Mer information om söklägen finns i metoden GetMode .

CMFCEditBrowseCtrl::EnableFileBrowseButton

Visar bläddra-knappen i den aktuella redigeringskontrollen och placerar kontrollen i filsökläge .

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

Parameterar

lpszDefExt
Anger standardfilnamnstillägget som används i dialogrutan för filval. Standardvärdet är NULL.

lpszFilter
Anger standardfiltersträngen som används i dialogrutan för filval. Standardvärdet är NULL.

dwFlags
Dialogruteflaggor. Standardvärdet är en bitvis kombination (OR) av OFN_HIDEREADONLY och OFN_OVERWRITEPROMPT.

Anmärkningar

När kontrollen för att redigera bläddra är i filsökläge och användaren klickar på bläddra-knappen, visar kontrollen dialogrutan standardfilval.

En fullständig lista över tillgängliga flaggor finns i OPENFILENAME-strukturen.

CMFCEditBrowseCtrl::EnableFolderBrowseButton

Visar bläddra-knappen i den aktuella redigeringskontrollen och placerar kontrollen i mappningsläge .

void EnableFolderBrowseButton();

Anmärkningar

När kontrollen för att redigera bläddra är i mappläge och användaren klickar på bläddra-knappen, visar kontrollen dialogrutan standardmappval.

CMFCEditBrowseCtrl::GetMode

Hämtar bläddra-läget för den aktuella redigeringskontrollen.

CMFCEditBrowseCtrl::BrowseMode GetMode() const;

Returvärde

Ett av uppräkningsvärdena som anger det aktuella läget för kontrollen redigera bläddra. Bläddra-läget avgör om ramverket visar bläddra-knappen och vilken åtgärd som inträffar när en användare klickar på den knappen.

I följande tabell visas möjliga returvärden.

Värde Beskrivning
BrowseMode_Default anpassat läge. En programmerdefinierad åtgärd utförs.
BrowseMode_File filläge. Dialogrutan standardfilwebbläsare visas.
BrowseMode_Folder mappläge. Dialogrutan standardmappwebbläsare visas.
BrowseMode_None Knappen Bläddra visas inte.

Anmärkningar

Som standard initieras ett CMFCEditBrowseCtrl objekt till BrowseMode_None läge. Ändra bläddringsläget med metoderna CMFCEditBrowseCtrl::EnableBrowseButton, CMFCEditBrowseCtrl::EnableFileBrowseButton och CMFCEditBrowseCtrl::EnableFolderBrowseButton .

CMFCEditBrowseCtrl::OnAfterUpdate

Anropas av ramverket när kontrollen för att redigera bläddra har uppdaterats med resultatet av en bläddra-åtgärd.

virtual void OnAfterUpdate();

Anmärkningar

Åsidosätt den här metoden i en härledd klass för att implementera en anpassad åtgärd.

CMFCEditBrowseCtrl::OnBrowse

Anropas av ramverket när användaren klickar på bläddra-knappen i kontrollen redigera bläddra.

virtual void OnBrowse();

Anmärkningar

Använd den här metoden för att köra anpassad kod när användaren klickar på bläddra-knappen i kontrollen redigera bläddra. Härled din egen klass från CMFCEditBrowseCtrl klassen och åsidosätt dess OnBrowse metod. I den metoden implementerar du en anpassad bläddra-åtgärd och uppdaterar textrutan i kontrollen redigera bläddra. I ditt program använder du metoden EnableBrowseButton för att placera kontrollen för redigeringsbläddering i anpassat bläddreringsläge .

CMFCEditBrowseCtrl::OnChangeLayout

Ritar om den aktuella redigeringskontrollen.

virtual void OnChangeLayout();

Anmärkningar

Ramverket anropar den här metoden när bläddra-läget för redigeringskontrollen ändras. Mer information finns i CMFCEditBrowseCtrl::GetMode.

CMFCEditBrowseCtrl::OnDrawBrowseButton

Anropas av ramverket för att rita bläddra-knappen i kontrollen redigera bläddra.

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

Parameterar

pDC-
En pekare till en enhetskontext.

Rect
Avgränsningsrektangeln för bältknappen.

bIsButtonPressed
SANT om knappen trycks på; annars FALSKT.

bIsButtonHot
SANT om knappen är markerad; annars FALSKT.

Anmärkningar

Åsidosätt den här funktionen i en härledd klass för att anpassa utseendet på b bläddra-knappen.

CMFCEditBrowseCtrl::SetBrowseButtonImage

Anger en anpassad bild på b bläddra-knappen i kontrollen redigera bläddra.

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

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

void SetBrowseButtonImage(UINT uiBmpResId);

Parameterar

hIcon
Handtaget för en ikon.

hBitmap
Handtaget för en bitmapp.

uiBmpResId
Resurs-ID för en bitmapp.

bAutoDestroy
TRUE för att ta bort den angivna ikonen eller bitmappen när den här metoden avslutas. annars FALSKT. Standardvärdet är TRUE.

Anmärkningar

Använd den här metoden för att tillämpa en anpassad avbildning på b bläddra-knappen. Som standard hämtar ramverket en standardbild när kontrollen för att redigera bläddra är i filsöknings - eller mappsökningsläge .

CMFCEditBrowseCtrl::OnIllegalFileName

Anropas av ramverket när ett ogiltigt filnamn angavs i redigeringskontrollen.

virtual BOOL OnIllegalFileName(CString& strFileName);

Parameterar

strFileName
Anger det ogiltiga filnamnet.

Returvärde

Ska returnera FALSE om det här filnamnet inte kan skickas vidare till fildialogrutan. I det här fallet är fokus inställt på redigeringskontrollen och användaren bör fortsätta redigera. Standardimplementeringen visar en meddelanderuta som talar om för användaren om det ogiltiga filnamnet och returnerar FALSE. Du kan åsidosätta den här metoden, korrigera filnamnet och returnera TRUE för vidare bearbetning.

Anmärkningar

Se även

hierarkidiagram
klasser

  • Last updated on