CEdit-Klasse

Artikel
02/26/2013

Stellt die Funktionalität eines Windows-Bearbeitungssteuerelements bereit.

class CEdit : public CWnd

Mitglieder

Öffentliche Konstruktoren

Name	Description
CEdit::CEdit	Erstellt ein CEdit-Steuerelementobjekt.

Öffentliche Methoden

Name	Description
CEdit::CanUndo	Bestimmt, ob ein Edit-Steuerelement-Vorgang rückgängig gemacht werden kann.
CEdit::CharFromPos	Ruft die Zeilen- und die Zeichenindizes für das Zeichen, das zu einer angegebenen Position am nächsten ist.
CEdit::Clear	Löscht die (Leerzeichen) die aktuelle Auswahl (falls vorhanden) im Bearbeitungssteuerelement.
CEdit::Copy	Kopiert die aktuelle Auswahl (falls vorhanden) im Bearbeitungssteuerelement in die Zwischenablage in CF_TEXT Format.
CEdit::Create	Erstellt das Windows-Bearbeitungssteuerelement und fügt es dem CEdit-Objekt.
CEdit::Cut	Löscht (Schnitte) die aktuelle Auswahl (falls vorhanden) im Bearbeitungssteuerelement sowie in den Kopien der gelöschte Text in die Zwischenablage in CF_TEXT Format.
CEdit::EmptyUndoBuffer	Setzt die (Leerzeichen) das Rückgängigflag eines Bearbeitungssteuerelements zurück.
CEdit::FmtLines	Legt die Aufnahme von den weichgezeichneten Unterstreichung fest, die in einem mehrzeiligen Bearbeitungssteuerelements oder deaktiviert sind.
CEdit::GetCueBanner	Ruft den Text ab, der während der Text-Hinweis oder Tipp, in einem Bearbeitungssteuerelement angezeigt wird, wenn das Steuerelement leer ist und nicht den Fokus.
CEdit::GetFirstVisibleLine	Bestimmt die oberste sichtbare Zeile in einem Bearbeitungssteuerelement.
CEdit::GetHandle	Ruft ein Handle für den Arbeitsspeicher ab, der gerade für ein mehrzeiliges Bearbeitungssteuerelement zugeordnet ist.
CEdit::GetHighlight	Ruft die Indizes des Starten und der abschließendes Zeichen in einem Bereich des Texts ab, der im aktuellen Bearbeitungssteuerelement hervorgehoben wird.
CEdit::GetLimitText	Ruft die maximale Größe des Texts ab, den dieses CEdit enthalten kann.
CEdit::GetLine	Ruft eine Textzeile aus einem Bearbeitungssteuerelement ab.
CEdit::GetLineCount	Ruft die Anzahl der Zeilen in einem mehrzeiligen Bearbeitungssteuerelement ab.
CEdit::GetMargins	Ruft die linken und rechten Rand für dieses CEdit ab.
CEdit::GetModify	Bestimmt, ob der Inhalt eines Bearbeitungssteuerelements geändert wurde.
CEdit::GetPasswordChar	Ruft das Kennwortzeichen ab, das in einem Bearbeitungssteuerelement angezeigt wird, wenn der Benutzer Text ein.
CEdit::GetRect	Ruft das Formatierungsrechteck eines Bearbeitungssteuerelements ab.
CEdit::GetSel	Ruft das erste und Positionen des letzten Zeichens der aktuellen Auswahl in einem Bearbeitungssteuerelement ab.
CEdit::HideBalloonTip	Blendet alle QuickInfo-Sprechblase aus, die dem aktuellen Bearbeitungssteuerelement zugeordnet ist.
CEdit::LimitText	Beschränkt die Länge des Texts ein, den der Benutzer in ein Bearbeitungssteuerelement eingeben kann.
CEdit::LineFromChar	Ruft die Zeilennummer der Zeile ab, die den angegebenen Zeichenindex enthält.
CEdit::LineIndex	Ruft den Zeichenindex einer Zeile innerhalb eines mehrzeiligen Bearbeitungssteuerelements ab.
CEdit::LineLength	Ruft die Länge einer Zeile in einem Bearbeitungssteuerelement ab.
CEdit::LineScroll	Führt den Text eines mehrzeiligen Bearbeitungssteuerelements aus.
CEdit::Paste	Fügt die Daten aus der Zwischenablage in das Bearbeitungssteuerelement in der aktuellen Cursorposition ein.Daten eingefügt werden, wenn die Zwischenablage Daten in CF_TEXT Format enthält.
CEdit::PosFromChar	Ruft die Koordinaten der linken oberen Ecke eines angegebenen Zeichenindexes ab.
CEdit::ReplaceSel	Ersetzt die aktuelle Auswahl in einem Bearbeitungssteuerelement durch den angegebenen Text.
CEdit::SetCueBanner	Legt den Text fest, der während der Text-Hinweis oder Tipp, in einem Bearbeitungssteuerelement angezeigt wird, wenn das Steuerelement leer ist und nicht den Fokus.
CEdit::SetHandle	Legt das Handle für den lokalen Arbeitsspeicher fest, der durch ein mehrzeiliges Bearbeitungssteuerelement verwendet wird.
CEdit::SetHighlight	Hebt einen Textbereich hervor, die im aktuellen Bearbeitungssteuerelement angezeigt wird.
CEdit::SetLimitText	Legt die maximale Menge Text fest, den dieses CEdit enthalten kann.
CEdit::SetMargins	Legt die linken und rechten Rand für dieses CEdit fest.
CEdit::SetModify	Setzt oder freie Räume das Änderungsflag für ein Bearbeitungssteuerelement.
CEdit::SetPasswordChar	Legt fest oder entfernt ein Kennwortzeichen, das in einem Bearbeitungssteuerelement angezeigt wird, wenn der Benutzer Text ein.
CEdit::SetReadOnly	Legt den schreibgeschützten Status eines Bearbeitungssteuerelements fest.
CEdit::SetRect	Legt das Formatierungsrechteck eines mehrzeiligen Bearbeitungssteuerelements fest und aktualisiert das Steuerelement.
CEdit::SetRectNP	Legt das Formatierungsrechteck eines mehrzeiligen Bearbeitungssteuerelements fest, ohne das Steuerelementfenster neu zu zeichnen.
CEdit::SetSel	Wählt einen Bereich von Zeichen in einem Bearbeitungssteuerelement aus.
CEdit::SetTabStops	Legt die Tabstopps in einem mehrzeiligen Bearbeitungssteuerelement fest.
CEdit::ShowBalloonTip	Zeigt eine QuickInfo-Sprechblase an, die dem aktuellen Bearbeitungssteuerelement zugeordnet ist.
CEdit::Undo	Gibt den letzten Edit-Steuerelement-Vorgang um.

Hinweise

Ein Bearbeitungssteuerelement ist ein rechteckiges untergeordnetes Fenster, in dem der Benutzer Text eingeben kann.

Sie können ein Bearbeitungssteuerelement entweder einer Dialogfeldvorlage oder direkt im Code erstellen.In beiden Fällen zunächst der Konstruktor CEdit, um CEdit des Objekts zu erstellen, dann der Erstellen Sie-Memberfunktion aufzurufen, um das Windows-Bearbeitungssteuerelement zu erstellen und diese dem CEdit-Objekt anzufügen.

Konstruktion kann ein nur einen Schritt umfassender Prozess in einer Klasse sein, die von CEdit abgeleitet wird.Schreiben Sie einen Konstruktor für die abgeleitete Klasse und rufen Sie Create aus dem Konstruktor auf.

CEdit erbt signifikante Funktionalität von CWnd.Um Text aus einem CEdit-Objekt festzulegen und abzurufen, verwenden Sie die CWnd-Memberfunktionen SetWindowText und GetWindowText, die festlegen oder den gesamten Inhalt eines Bearbeitungssteuerelements abrufen, selbst wenn ein mehrzeiliges - Steuerelement ist.Textzeilen in einem mehrzeiligen Steuerelement werden durch "\ r \ n" Zeichensequenzen getrennt.Wenn ein Bearbeitungssteuerelement mehrzeilig ist, rufen Sie und Textteil des Steuerelements ab, indem Sie die CEdit-Memberfunktionen GetLine, SetSel, GetSel und ReplaceSel aufrufen.

Wenn Sie Windows-Benachrichtigungsmeldungen bearbeiten möchten, die durch ein Bearbeitungssteuerelement zu seinem übergeordneten Element gesendet werden (normalerweise eine Klasse wird von abgeleitet CDialog), fügen Sie eine Meldungszuordnungseintrags- und Meldungshandlermemberfunktion der übergeordneten Klasse für jede Meldung hinzu.

Jeder Eintrag in der Meldungszuordnung weist folgende Form auf:

ON_Notification(id, memberFxn)

wobei id die ID des untergeordneten Fensters des Bearbeitungssteuerelements sendenden angibt, ist die Benachrichtigungen und memberFxn der Name der übergeordneten Memberfunktion, die Sie geschrieben haben, um die Benachrichtigung zu bearbeiten.

Der Funktionsprototyp des übergeordneten Elements ist, wie folgt:

memberFxn ( );afx_msg void

Im Folgenden finden Sie eine Liste der möglichen Meldungszuordnungseinträgen und von Beschreibung der Fälle, in denen es zum übergeordneten gesendet werden:

ON_EN_CHANGE hat der Benutzer Aktionen ausgeführt, die möglicherweise Text in einem Bearbeitungssteuerelement geändert.Im Gegensatz zur EN_UPDATE Benachrichtigung wird diese Benachrichtigung gesendet, nachdem Windows die Anzeige aktualisiert.
ON_EN_ERRSPACE das Bearbeitungssteuerelement kann nicht genügend Arbeitsspeicher zuordnen, um eine bestimmte Anforderung zu erfüllen.
ON_EN_HSCROLL der Benutzer klickt auf die horizontale Bildlaufleiste eines Bearbeitungssteuerelements.Das übergeordnete Fenster wird benachrichtigt, bevor der Bildschirm aktualisiert wird.
ON_EN_KILLFOCUS das Bearbeitungssteuerelement verliert den Eingabefokus.
ON_EN_MAXTEXT die aktuelle Einfügung hat die angegebene Anzahl von Zeichen für das Bearbeitungssteuerelement überschritten und ist abgeschnitten wurde.Außerdem gesendet, wenn ein Bearbeitungssteuerelement nicht verfügt, dem ES_AUTOHSCROLL Format und der Anzahl der einzufügenden Zeichen würde die Breite des Bearbeitungssteuerelements überschreiten.Außerdem gesendet, wenn ein Bearbeitungssteuerelement nicht verfügt, dem ES_AUTOVSCROLL Format und der Gesamtanzahl der Zeilen würde Zurückhalten von einer Texteinfügung die Höhe des Bearbeitungssteuerelements überschreiten.
ON_EN_SETFOCUS gesendet hat, wann ein Bearbeitungssteuerelement den Eingabefokus erhält.
ON_EN_UPDATE das Bearbeitungssteuerelement ist ungefähr zur Anzeige geändertem Text.Gesendet, nachdem das Steuerelement den Text formatiert hat, aber bevor der Text rastert, damit die Fenstergröße geändert werden kann, ggf.
ON_EN_VSCROLL der Benutzer klickt auf der vertikalen Bildlaufleiste eines Bearbeitungssteuerelements.Das übergeordnete Fenster wird benachrichtigt, bevor der Bildschirm aktualisiert wird.

Wenn Sie ein CEdit-Objekt innerhalb eines Dialogfelds erstellen, wird das Objekt CEdit automatisch zerstört, wenn der Benutzer das Dialogfeld geschlossen wird.

Wenn Sie ein CEdit-Objekt aus einer Dialogfeldressource mithilfe des Dialog-Editors erstellen, wird das Objekt CEdit automatisch zerstört, wenn der Benutzer das Dialogfeld geschlossen wird.

Wenn Sie ein CEdit-Objekt innerhalb eines Fensters erstellen, müssen Sie möglicherweise auch es zerstören.Wenn Sie das CEdit-Objekt auf dem Stapel erstellen, wird er automatisch zerstört.Wenn Sie das CEdit-Objekt auf dem Heap erstellen, indem Sie die new-Funktion verwenden, müssen Sie delete für das Objekt aufrufen, um es zu zerstören, wenn der Benutzer das Windows-Bearbeitungssteuerelement beendet.Wenn Sie einen Arbeitsspeicher im CEdit-Objekt zuordnen, überschreiben Sie den CEdit Destruktor, um die Zuordnungen freizugeben.

Um bestimmte Formate in einem Bearbeitungssteuerelement zu ändern (z ES_READONLY) müssen Sie bestimmte Meldungen an das Steuerelement senden anstatt ModifyStyle zu verwenden.Siehe Bearbeitungssteuerelement-Formate in Windows SDK.

Weitere Informationen zu CEdit, finden Sie unter: