Compartir a través de


CMFCEditBrowseCtrl Class

La clase de CMFCEditBrowseCtrl admite el control de examen de edición, que es un cuadro de texto modificable que contiene opcionalmente un botón examinar. Cuando el usuario hace clic en el botón examinar, el control realiza una acción personalizada o muestra un cuadro de diálogo estándar que contiene un explorador de archivos o un explorador en la carpeta.

class CMFCEditBrowseCtrl : public CEdit

Members

Constructores públicos

Name

Descripción

CMFCEditBrowseCtrl::CMFCEditBrowseCtrl

Constructor predeterminado.

CMFCEditBrowseCtrl::~CMFCEditBrowseCtrl

Un destructor.

Métodos públicos

Name

Descripción

CMFCEditBrowseCtrl::EnableBrowseButton

Habilita o deshabilita (oculta) el botón examinar.

CMFCEditBrowseCtrl::EnableFileBrowseButton

Habilita el botón examinar y coloca el control de examen de edición en el modo de exploración del archivo .

CMFCEditBrowseCtrl::EnableFolderBrowseButton

Habilita el botón examinar y coloca el control de examen de edición en el modo de exploración de la carpeta .

CMFCEditBrowseCtrl::GetMode

Devuelve el modo de exploración actual.

CMFCEditBrowseCtrl::OnAfterUpdate

Llamado por el marco después de que el control de examen de edición se actualice con el resultado de una acción de exploración.

CMFCEditBrowseCtrl::OnBrowse

Llamado por el marco después de que el usuario haga clic en el botón examinar.

CMFCEditBrowseCtrl::OnChangeLayout

Dibuja de nuevo el control actual de examen de edición.

CMFCEditBrowseCtrl::OnDrawBrowseButton

Llamado por el marco para dibujar el botón examinar.

CMFCEditBrowseCtrl::OnIllegalFileName

Llamado por el marco cuando un nombre de archivo no válido se escribió en el control de edición.

CMFCEditBrowseCtrl::PreTranslateMessage

Traduce mensajes de ventana antes de que se envíen a las funciones de TranslateMessage y de DispatchMessage Windows. Para la sintaxis y más información, vea CWnd::PreTranslateMessage.

CMFCEditBrowseCtrl::SetBrowseButtonImage

Establece una imagen personalizada para el botón examinar.

Comentarios

Utilice un control de examen de edición para seleccionar un archivo o la carpeta. Opcionalmente, utilice el control para realizar una acción personalizada como para mostrar un cuadro de diálogo. Puede mostrar o no mostrar el botón examinar, y se puede aplicar una etiqueta o una imagen personalizada en el botón.

El modo de exploración del control de examen de edición determina si muestra un botón examinar y qué acción se produce cuando se hace clic en el botón. Para obtener más información, vea el método de GetMode .

La clase de CMFCEditBrowseCtrl admite los modos siguientes.

  • custom mode
    Se realiza una acción personalizada cuando el usuario hace clic en el botón examinar. Por ejemplo, puede mostrar un cuadro de diálogo específico de la aplicación.

  • file mode
    Se muestra un cuadro de diálogo estándar de selección de archivos cuando el usuario hace clic en el botón examinar.

  • folder mode
    Se muestra un cuadro de diálogo estándar de selección de la carpeta cuando el usuario hace clic en el botón examinar.

práctico: Especifique una Control de examen de edición

Siga estos pasos para proteger un control de examen de edición en la aplicación:

  1. Si desea implementar un modo de exploración personalizado, derive poseen la clase de la clase de CMFCEditBrowseCtrl y después reemplazan el método de CMFCEditBrowseCtrl::OnBrowse . En el método invalidado, ejecute una acción personalizada de examen y actualiza el control de examen de edición con el resultado.

  2. Inserte el objeto de CMFCEditBrowseCtrl o el objeto derivado de control de examen de edición en el objeto de la ventana primaria.

  3. Si utiliza Asistente para clases para crear un cuadro de diálogo, agregue un control de edición (CEdit) al formulario de cuadro de diálogo. Además, agregue una variable para tener acceso al control en el archivo de encabezado. en el archivo de encabezado, cambie el tipo de la variable de CEdit a CMFCEditBrowseCtrl. El control de examen de edición se creará automáticamente. Si no utiliza Asistente para clases, agregue una variable de CMFCEditBrowseCtrl al archivo de encabezado y llame al método de Create .

  4. Si agrega un control de examen de edición a un cuadro de diálogo, utilice la herramienta de ClassWizard para configurar intercambio de datos.

  5. Llame al método de EnableFolderBrowseButton, de EnableFileBrowseButton, o de EnableBrowseButton para establecer el modo de exploración y mostrar el botón examinar. Llame al método de GetMode para obtener el modo de exploración actual.

  6. Para proporcionar una imagen personalizada para el botón examinar, llame al método de SetBrowseButtonImage o invalide el método de OnDrawBrowseButton .

  7. Para quitar el botón examinar del control de examen de edición, llame al método de EnableBrowseButton con el parámetro de bEnable establecido en FALSE.

Jerarquía de herencia

CObject

   CCmdTarget

      CWnd

         CEdit

            CMFCEditBrowseCtrl

Ejemplo

El ejemplo siguiente se muestra cómo utilizar dos métodos en la clase de CMFCEditBrowseCtrl : EnableFolderBrowseButton y EnableFileBrowseButton. Este ejemplo forma parte de nuevo ejemplo de Controles.

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

Requisitos

encabezado: afxeditbrowsectrl.h

Vea también

Referencia

Gráfico de jerarquías

Otros recursos

Clases de MFC