Freigeben über


CEdit-Klasse

Stellt die Funktionalität eines Windows-Bearbeitungssteuerelements bereit.

class CEdit : public CWnd

Mitglieder

f7yhsd2b.collapse_all(de-de,VS.110).gifÖffentliche Konstruktoren

Name

Description

CEdit::CEdit

Erstellt ein CEdit-Steuerelementobjekt.

f7yhsd2b.collapse_all(de-de,VS.110).gifÖ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:

  • Steuerelemente

  • Knowledge Base-Artikel Q259949: INFO: SetCaretPos() ist nicht mit CEdit oder CRichEditCtrl-Steuerelementen geeignet

Vererbungshierarchie

CObject

CCmdTarget

CWnd

CEdit

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CWnd-Klasse

Hierarchien-Diagramm

CWnd-Klasse

CButton-Klasse

CComboBox-Klasse

CListBox-Klasse

CScrollBar-Klasse

CStatic-Klasse

CDialog-Klasse

Konzepte

MFC-Beispiel CALCDRIV

Das MFC-Beispiel