Clase de CEdit

Artículo
04/10/2013

proporciona la funcionalidad de un control de edición de Windows.

class CEdit : public CWnd

Members

Constructores públicos

Name	Descripción
CEdit::CEdit	Construye un objeto de control de CEdit .

Métodos públicos

Name	Descripción
CEdit::CanUndo	Determina si una operación de control de edición se puede deshacer.
CEdit::CharFromPos	Recupera los índices de la línea y de carácter a carácter más próximo a una posición especificada.
CEdit::Clear	Elimina (desactivada) la selección actual (si existe) al control de edición.
CEdit::Copy	Copia la selección actual (si existe) al control de edición al portapapeles en el formato de CF_TEXT .
CEdit::Create	Hace que el control de edición de Windows y lo asocia al objeto de CEdit .
CEdit::Cut	Elimina (cortes) la selección actual (si existe) al control de edición y copia el texto eliminado en el portapapeles en el formato de CF_TEXT .
CEdit::EmptyUndoBuffer	Restaura (desactivada) el indicador de deshacer de un control de edición.
CEdit::FmtLines	Establece la inclusión de los caracteres de salto de línea suaves con. o dentro de un control de edición de varias líneas.
CEdit::GetCueBanner	Recupera el texto que se muestra como la señal de texto, o sugerencias, en un control de edición cuando el control está vacío y no tiene el foco.
CEdit::GetFirstVisibleLine	determina la línea visible superior en un control de edición.
CEdit::GetHandle	Recupera un identificador de memoria asignado actualmente para un control de edición de varias líneas.
CEdit::GetHighlight	Obtiene los índices de los caracteres inicial y final de un intervalo de texto que se muestra resaltado en el control de edición actual.
CEdit::GetLimitText	Obtiene la cantidad máxima de texto que este CEdit puede contener.
CEdit::GetLine	recupera una línea de texto de un control de edición.
CEdit::GetLineCount	recupera el número de líneas en un control de edición de varias líneas.
CEdit::GetMargins	Obtiene los márgenes izquierdo y derecho para este CEdit.
CEdit::GetModify	Determina si el contenido de un control de edición se han modificado.
CEdit::GetPasswordChar	Recupera el carácter de contraseña mostrado en un control de edición cuando el usuario escribe texto.
CEdit::GetRect	Obtiene el rectángulo de formato de un control de edición.
CEdit::GetSel	Obtiene la primera y la última posición de caracteres de la selección actual en un control de edición.
CEdit::HideBalloonTip	Oculta el globo de sugerencias asociado al control de edición actual.
CEdit::LimitText	Restringe la longitud de texto que el usuario escriba en un control de edición.
CEdit::LineFromChar	Recupera el número de línea que contiene el índice de caracteres especificado.
CEdit::LineIndex	Recupera el índice del carácter de una línea dentro de un control de edición de varias líneas.
CEdit::LineLength	recupera la longitud de una línea en un control de edición.
CEdit::LineScroll	desplaza el texto de un control de edición de varias líneas.
CEdit::Paste	Inserta los datos del portapapeles en el control de edición en la posición del cursor actual.Se inserta los datos sólo si el portapapeles contiene datos en el formato de CF_TEXT .
CEdit::PosFromChar	Recupera las coordenadas de la esquina superior izquierda de un índice de caracteres especificado.
CEdit::ReplaceSel	reemplaza la selección actual en un control de edición con el texto especificado.
CEdit::SetCueBanner	Establece el texto que se mostrará como la señal de texto, o sugerencias, en un control de edición cuando el control está vacío y no tiene el foco.
CEdit::SetHandle	Establece el identificador a la memoria local que se utiliza en un control de edición de varias líneas.
CEdit::SetHighlight	Resalta un intervalo de texto que se muestra en el control de edición actual.
CEdit::SetLimitText	Establece la cantidad máxima de texto que este CEdit puede contener.
CEdit::SetMargins	Establece los márgenes izquierdo y derecho para este CEdit.
CEdit::SetModify	Establece o desactive el indicador de modificación para un control de edición.
CEdit::SetPasswordChar	Establece o quita un carácter de contraseña mostrado en un control de edición cuando el usuario escribe texto.
CEdit::SetReadOnly	Establece el estado de sólo lectura de un control de edición.
CEdit::SetRect	Establece el rectángulo de formato de un control de edición de varias líneas y actualiza el control.
CEdit::SetRectNP	Establece el rectángulo de formato de un control de edición de varias líneas sin optimizar la ventana de control.
CEdit::SetSel	Seleccione un intervalo de caracteres en un control de edición.
CEdit::SetTabStops	Establecen tabulaciones en un control de edición de varias líneas.
CEdit::ShowBalloonTip	Muestra un globo de sugerencias que está asociado al control de edición actual.
CEdit::Undo	Anula la operación de control de última edición.

Comentarios

Un control de edición es una ventana secundaria rectangular en la que el usuario puede escribir texto.

Puede crear un control de edición de una plantilla de cuadro de diálogo o directamente en el código.En ambos casos, llame primero al constructor CEdit para construir el objeto de CEdit , después llamar a la función miembro de Crear para crear el control de edición y adjuntar de Windows en el objeto de CEdit .

la construcción puede ser un proceso de un solo paso en una clase derivada de CEdit.Escriba un constructor para la clase derivada y llame a Crear dentro del constructor.

CEdit hereda la funcionalidad significativa de CWnd.Para establecer y recuperar texto de un objeto de CEdit , utilice las funciones SetWindowText y GetWindowTextmiembro de CWnd , que establecen u obtiene todo el contenido de un control de edición, aunque es un control de varias líneas.Las líneas de texto en un control de múltiples líneas están separadas por “\ secuencias de caracteres de r \ n”.Además, si un control de edición es multilínea, obtener y establecer la parte del texto del control a las funciones GetLine, SetSel, GetSel, y ReplaceSelmiembro de CEdit .

Si desea controlar los mensajes de notificación de Windows enviados por un control de edición al elemento primario (normalmente una clase derivada de CDialog), agregue una función miembro de entrada y controlador de mensajes de mapa de mensajes a la clase primaria para cada mensaje.

Cada entrada de mapa de mensajes tiene el formato siguiente:

Id.de(de notificación deON_***, memberFxn *)

donde id especifica el identificador de ventana secundaria del control de edición que envía la notificación, y memberFxn es el nombre de la función principal del miembro que ha escrito para controlar la notificación.

El prototipo de función del elemento primario es el siguiente:

memberFxn ();void deafx_msg

A continuación se muestra una lista de entradas posibles de mapa de mensajes y una descripción de los casos en que se enviaron al elemento primario:

El usuario deON_EN_CHANGE The ha realizado una acción que podrían haber modificado el texto en un control de edición.A diferencia del mensaje de notificación de EN_UPDATE , se envía este mensaje de notificación cuando Windows actualizar la presentación.
El control de ediciónON_EN_ERRSPACE no puede asignar memoria suficiente para satisfacer una solicitud concreta.
El usuario deON_EN_HSCROLL The haga clic en la barra de desplazamiento horizontal de un control de edición.Se notifica a la ventana primaria antes de que se actualicen a la pantalla.
El control de ediciónON_EN_KILLFOCUS The pierde el foco de entrada.
la inserción actual deON_EN_MAXTEXT The ha superado el número de caracteres especificado para el control de edición y se ha truncado.También enviado cuando un control de edición no tiene el estilo de ES_AUTOHSCROLL y el número de caracteres que se inserten supera el ancho del control de edición.También enviado cuando un control de edición no tiene el estilo de ES_AUTOVSCROLL y el número total de líneas el resultante de una inserción de texto supera el alto del control de edición.
ON_EN_SETFOCUS Sent cuando un control de edición recibe el foco de entrada.
El control de ediciónON_EN_UPDATE The trata sobre el texto modificado pantalla.Enviado después de que el control ha dado formato al texto pero antes de que se muestra el texto para poder modificar el tamaño de la ventana, si es necesario.
El usuario deON_EN_VSCROLL The haga clic en la barra de desplazamiento vertical de un control de edición.Se notifica a la ventana primaria antes de que se actualicen a la pantalla.

Si crea un objeto de CEdit dentro de un cuadro de diálogo, el objeto de CEdit automáticamente se destruye cuando el usuario cierra el cuadro de diálogo.

Si crea un objeto de CEdit de un recurso de cuadro de diálogo mediante el editor de cuadros de diálogo, el objeto de CEdit automáticamente se destruye cuando el usuario cierra el cuadro de diálogo.

Si crea un objeto de CEdit dentro de una ventana, puede necesitar también destruirla.Si crea el objeto de CEdit en la pila, se destruye automáticamente.Si crea el objeto de CEdit en la pila mediante la función de nuevo , debe llamar a cancelación en el objeto para destruirlo cuando el usuario finaliza el control de edición de Windows.Si asigna cualquier memoria en el objeto de CEdit , reemplace CEdit destructor para destruyen las asignaciones.

Para modificar ciertos estilos de un control de edición (como ES_READONLY) debe enviar mensajes específicos al control en lugar de utilizar ModifyStyle.Vea Estilos del control de edición en Windows SDK.

Para obtener más información sobre CEdit, vea: