Classe CEdit

Articolo
06/10/2015

Fornisce la funzionalità di un controllo di modifica di Windows.

class CEdit : public CWnd

Membri

Costruttori pubblici

Nome	Descrizione
CEdit::CEdit	Costruisce un oggetto controllo CEdit.

Metodi pubblici

Nome	Descrizione
CEdit::CanUndo	Determina se un'operazione di controllo di modifica può essere annullata.
CEdit::CharFromPos	Recupera la riga e indici di caratteri per il carattere più vicino a una posizione specificata.
CEdit::Clear	Elimina (definito) la selezione corrente (se presenti) nel controllo di modifica.
CEdit::Copy	Copiare la selezione corrente (se presenti) nel controllo di modifica agli Appunti nel formato CF_TEXT.
CEdit::Create	Crea il controllo di modifica di Windows e lo aggiunge all'oggetto CEdit.
CEdit::Cut	Elimina (ridurre) la selezione corrente (se presenti) nel controllo di modifica in e copia il testo estratto negli Appunti nel formato CF_TEXT.
CEdit::EmptyUndoBuffer	Reimposta (definito) il flag di annullamento di un controllo di modifica.
CEdit::FmtLines	Imposta includere i caratteri di interruzione di riga softkey o all'interno di un controllo di modifica a più righe.
CEdit::GetCueBanner	Recupera il testo visualizzato come un'indicazione testuale, o suggerimento, in un controllo di modifica quando il controllo è vuoto e non ha lo stato attivo.
CEdit::GetFirstVisibleLine	Determina la riga visibile in primo piano in un controllo di modifica.
CEdit::GetHandle	Recupera l'handle alla memoria di cui è allocata per un controllo di modifica a più righe.
CEdit::GetHighlight	Ottiene gli indici dei caratteri iniziale e finale di un intervallo di testo che sia evidenziato nel controllo di modifica corrente.
CEdit::GetLimitText	Ottiene la quantità massima di testo questo CEdit può contenere.
CEdit::GetLine	Recupera una riga di testo di un controllo di modifica.
CEdit::GetLineCount	Recupera il numero di righe in un controllo di modifica a più righe.
CEdit::GetMargins	Ottiene i margini sinistro e destro per questo CEdit.
CEdit::GetModify	Determina se il contenuto di un controllo di modifica è stato modificato.
CEdit::GetPasswordChar	Recupera il carattere di password verranno visualizzati in un controllo di modifica quando l'utente immette il testo.
CEdit::GetRect	Ottiene il rettangolo di formattazione di un controllo di modifica.
CEdit::GetSel	Ottiene la prima e l'ultima posizioni dei caratteri della selezione corrente in un controllo di modifica.
CEdit::HideBalloonTip	Nasconde tutto il suggerimento associato al controllo di modifica corrente.
CEdit::LimitText	Limita la lunghezza del testo che l'utente può immettere in un controllo di modifica.
CEdit::LineFromChar	Recupera il numero di riga contenente l'indice di caratteri specificato.
CEdit::LineIndex	Recupera l'indice di una riga in un controllo di modifica a più righe.
CEdit::LineLength	Recupera la lunghezza di una riga in un controllo di modifica.
CEdit::LineScroll	Scorre il testo di un controllo di modifica a più righe.
CEdit::Paste	Inserisce i dati dagli Appunti nel controllo di modifica nella posizione corrente del cursore. I dati vengono immessi solo se gli Appunti contengono dati nel formato CF_TEXT.
CEdit::PosFromChar	Recupera le coordinate dell'angolo superiore sinistro di un indice di caratteri specificato.
CEdit::ReplaceSel	Sostituisce la selezione corrente in un controllo di modifica con il testo specificato.
CEdit::SetCueBanner	Imposta il testo da visualizzare come un'indicazione testuale, o suggerimento, in un controllo di modifica quando il controllo è vuoto e non ha lo stato attivo.
CEdit::SetHandle	Imposta un handle alla memoria locale che verrà utilizzata da un controllo di modifica a più righe.
CEdit::SetHighlight	Evidenzia un intervallo di testo visualizzato nel controllo di modifica corrente.
CEdit::SetLimitText	Imposta la quantità massima di testo questo CEdit può contenere.
CEdit::SetMargins	Impostare i margini sinistro e destro per questo CEdit.
CEdit::SetModify	Imposta o cancella il flag di modifica per un controllo di modifica.
CEdit::SetPasswordChar	Imposta o rimuovere un carattere di password verranno visualizzati in un controllo di modifica quando l'utente immette il testo.
CEdit::SetReadOnly	Imposta lo stato di sola lettura di un controllo di modifica.
CEdit::SetRect	Imposta il rettangolo di formattazione di un controllo di modifica a più righe e aggiorna il controllo.
CEdit::SetRectNP	Imposta il rettangolo di formattazione di un controllo di modifica a più righe senza ridisegnare la finestra di controllo.
CEdit::SetSel	Selezionare un intervallo di caratteri in un controllo di modifica.
CEdit::SetTabStops	Imposta le tabulazioni in un controllo di modifica a più righe.
CEdit::ShowBalloonTip	Visualizza un suggerimento associato al controllo di modifica corrente.
CEdit::Undo	Consente di annullare l'ultima operazione di controllo di modifica.

Note

Un controllo di modifica è una finestra figlio rettangolare in cui l'utente può immettere il testo.

È possibile creare un controllo di modifica da un modello di finestra di dialogo o direttamente nel codice. In entrambi i casi, chiamare prima il costruttore CEdit per costruire l'oggetto CEdit, quindi chiamare la funzione membro Crea per creare il controllo di modifica di Windows e per associarlo all'oggetto CEdit.

La costruzione può essere un processo una fase in una classe derivata da CEdit. Scrivere un costruttore per la classe derivata e chiamare Crea dal costruttore.

CEdit eredita la presenza CWnd. Per impostare e recuperare il testo di un oggetto CEdit, utilizzare le funzioni membro SetWindowText e GetWindowTextdi CWnd, che imposta o ottiene tutto il contenuto di un controllo di modifica, anche se è un controllo multilinea. Le righe di testo in un controllo multilinea sono separate sequenze di caratteri "\ r \ n". Inoltre, se un controllo di modifica è su più righe, ottenere e impostare la parte del testo del controllo chiamando le funzioni membro GetLine, SetSel, GetSele ReplaceSeldi CEdit.

Se si desidera gestire i messaggi di notifica di Windows inviati da un controllo di modifica al controllo padre (in genere una classe derivata da CDialog), aggiungere una voce della mappa messaggi e una funzione membro per la gestione dei messaggi nella classe padre per ogni messaggio.

Ogni voce della mappa messaggi accetta il formato seguente:

ON_Notifica(id, memberFxn)

dove specifica id la finestra figlio ID del controllo di modifica che invia una notifica e memberFxn è il nome della funzione membro che padre è stato scritto per gestire la notifica.

Il prototipo del padre è la seguente:

memberFxn**( );void diafx_msg**

Segue un elenco di voci della mappa messaggi potenziali e una descrizione dei casi in cui verrà inviata al padre:

ON_EN_CHANGE l'utente ha intraprendere le azioni che possono modificare il testo in un controllo di modifica. A differenza del messaggio di notifica EN_UPDATE, il messaggio di notifica viene inviato agli aggiornamenti di Windows la visualizzazione.
ON_EN_ERRSPACE il controllo di modifica impossibile allocare memoria sufficiente per soddisfare una richiesta specifica.
ON_EN_HSCROLL l'utente fa clic sulla barra di scorrimento orizzontale di un controllo di modifica. La finestra padre viene trasmessa prima che lo schermo venga aggiornato.
ON_EN_KILLFOCUS il controllo di modifica perde lo stato attivo per l'input.
ON_EN_MAXTEXT l'inserimento corrente superi il numero di caratteri specificato per il controllo di modifica ed è stato troncato. Inoltre inviato a un controllo di modifica non presenta lo stile ES_AUTOHSCROLL e il numero di caratteri da inserire in quello la larghezza del controllo di modifica. Inoltre inviato a un controllo di modifica non presenta lo stile ES_AUTOVSCROLL e il numero complessivo di righe derivare da un inserimento di testo in quello l'altezza del controllo di modifica.
ON_EN_SETFOCUS inviati a un controllo di modifica riceve lo stato attivo per l'input.
ON_EN_UPDATE il controllo di modifica sta il testo modificato visualizzazione. Inviato dopo che il controllo ha il testo formattato ma prima di schermate il testo in modo che comporta la dimensione della finestra, se necessario.
ON_EN_VSCROLL l'utente fa clic sulla barra di scorrimento verticale di un controllo di modifica. La finestra padre viene trasmessa prima che lo schermo venga aggiornato.

Se si crea un oggetto CEdit di una finestra di dialogo, l'oggetto CEdit automaticamente eliminato quando l'utente chiude la finestra di dialogo.

Se si crea un oggetto CEdit da una risorsa finestra di dialogo utilizzando l'editor finestre di dialogo, l'oggetto CEdit automaticamente eliminato quando l'utente chiude la finestra di dialogo.

Se si crea un oggetto CEdit interno di una finestra, è inoltre necessario distruggerla. Se si crea l'oggetto CEdit nello stack, verrà automaticamente eliminato. Se si crea l'oggetto CEdit nell'heap mediante la funzione new, è necessario chiamare delete sull'oggetto per distruggerlo quando l'utente termina il controllo di modifica di Windows. Se allocare memoria in qualsiasi oggetto CEdit, eseguire l'override del distruttore CEdit per disporre le allocazioni.

Per modificare determinati stili in un controllo di modifica (come ES_READONLY) è necessario inviare messaggi specifici del controllo anziché ModifyStyle. Vedere Stili del controllo di modifica in Windows SDK.

Per ulteriori informazioni su CEdit, vedere: