Steuerelementformatvorlagen bearbeiten

Um ein Bearbeitungssteuerelement mithilfe der Funktion CreateWindow oder CreateWindowEx zu erstellen, geben Sie die EDIT-Klasse, die entsprechenden Fensterstilkonstanten und eine Kombination der folgenden Bearbeitungssteuerelementformate an. Nachdem das Steuerelement erstellt wurde, können diese Formatvorlagen nicht geändert werden, außer wie erwähnt.

Beispiel

LRESULT MsgCreate(HWND hwnd, UINT uMessage, WPARAM wparam, LPARAM lparam)
{
    lparam;
    wparam;
    uMessage;

    // Create Edit control for typing to be sent to server
    if (NULL == (hOutWnd = CreateWindow("EDIT",
                           NULL,
                           WS_BORDER | WS_CHILD | WS_VISIBLE | WS_VSCROLL | ES_LEFT | 
                           ES_MULTILINE | ES_AUTOVSCROLL,
                           0,0,0,0,
                           hwnd,
                           (HMENU) ID_OUTBOX,
                           (HINSTANCE) GetWindowLongPtr(hwnd, GWLP_HINSTANCE),
                           NULL)))
        return FALSE;
    return TRUE;
}

Beispiel aus Windows klassischen Beispielen für GitHub.

Konstanten

Konstante BESCHREIBUNG
ES_AUTOHSCROLL
Scrollt text automatisch nach rechts um 10 Zeichen, wenn der Benutzer am Ende der Zeile ein Zeichen eingibt. Wenn der Benutzer die EINGABETASTE drückt, scrollt das Steuerelement zurück zu Position Null.
ES_AUTOVSCROLL
Scrollt Text automatisch auf einer Seite nach oben, wenn der Benutzer die EINGABETASTE in der letzten Zeile drückt.
ES_CENTER
Zentriert Text in einem Einzelzeilen- oder mehrzeiligen Bearbeitungssteuerelement.
ES_LEFT
Richtet Text am linken Rand aus.
ES_LOWERCASE
Konvertiert alle Zeichen in Kleinbuchstaben, während sie in das Bearbeitungssteuerelement eingegeben werden.
Verwenden Sie "SetWindowLong", um diese Formatvorlage nach dem Erstellen des Steuerelements zu ändern.
ES_MULTILINE
Gibt ein Mehrlinienbearbeitungssteuerelement an. Der Standardwert ist ein Einzeil-Bearbeitungssteuerelement.
Wenn sich das Mehrlinienbearbeitungssteuerelement in einem Dialogfeld befindet, besteht die Standardantwort zum Drücken der EINGABETASTE darin, die Standardschaltfläche zu aktivieren. Um die EINGABETASTE als Wagenrücklauf zu verwenden, verwenden Sie die ES_WANTRETURN Formatvorlage.
Wenn sich das Mehrlinienbearbeitungssteuerelement nicht in einem Dialogfeld befindet und die ES_AUTOVSCROLL Formatvorlage angegeben wird, zeigt das Bearbeitungssteuerelement so viele Zeilen wie möglich an und scrollt vertikal, wenn der Benutzer die EINGABETASTE drückt. Wenn Sie ES_AUTOVSCROLL nicht angeben, zeigt das Bearbeitungssteuerelement so viele Zeilen wie möglich an und beeps, wenn der Benutzer die EINGABETASTE drückt, wenn keine weiteren Zeilen angezeigt werden können.
Wenn Sie die ES_AUTOHSCROLL Formatvorlage angeben, scrollt das Mehrlinienbearbeitungssteuerelement automatisch horizontal, wenn das Caret über den rechten Rand des Steuerelements geht. Um eine neue Zeile zu starten, muss der Benutzer die EINGABETASTE drücken. Wenn Sie ES_AUTOHSCROLL nicht angeben, werden wörter automatisch am Anfang der nächsten Zeile umgebrochen. Eine neue Zeile wird auch gestartet, wenn der Benutzer die EINGABETASTE drückt. Die Fenstergröße bestimmt die Position des Wordwrap. Wenn sich die Fenstergröße ändert, ändert sich die Wordwrapping-Position, und der Text wird erneut angezeigt.
Multiline-Bearbeitungssteuerelemente können Bildlaufleisten aufweisen. Ein Bearbeitungssteuerelement mit Bildlaufleisten verarbeitet eigene Bildlaufleistennachrichten. Beachten Sie, dass Bearbeitungssteuerelemente ohne Bildlaufleisten scrollen, wie in den vorherigen Absätzen beschrieben, und alle Bildlaufnachrichten verarbeiten, die vom übergeordneten Fenster gesendet werden.
ES_NOHIDESEL
Hebt das Standardverhalten für ein Bearbeitungssteuerelement ab. Das Standardverhalten blendet die Auswahl aus, wenn das Steuerelement den Eingabefokus verliert und die Auswahl umkehrt, wenn das Steuerelement den Eingabefokus empfängt. Wenn Sie ES_NOHIDESEL angeben, wird der markierte Text umgekehrt, auch wenn das Steuerelement nicht über den Fokus verfügt.
ES_NUMBER
Ermöglicht nur die Eingabe von Ziffern in das Bearbeitungssteuerelement. Beachten Sie, dass es auch bei diesem Satz weiterhin möglich ist, Nicht-Ziffern in das Bearbeitungssteuerelement einzufügen.
Verwenden Sie "SetWindowLong", um diese Formatvorlage nach dem Erstellen des Steuerelements zu ändern.
Um Text zu übersetzen, der in das Bearbeitungssteuerelement eingegeben wurde, in einen ganzzahligen Wert, verwenden Sie die GetDlgItemInt-Funktion . Verwenden Sie die SetDlgItemInt-Funktion , um den Text des Bearbeitungssteuerelements auf die Zeichenfolgendarstellung einer angegebenen Ganzzahl festzulegen.
ES_OEMCONVERT
Konvertiert text, der im Bearbeitungssteuerelement eingegeben wurde. Der Text wird aus dem Windows Zeichensatz in den OEM-Zeichensatz und dann zurück in den Windows Zeichensatz konvertiert. Dadurch wird eine ordnungsgemäße Zeichenkonvertierung sichergestellt, wenn die Anwendung die CharToOem-Funktion aufruft, um eine Windows Zeichenfolge im Bearbeitungssteuerelement in OEM-Zeichen zu konvertieren. Diese Formatvorlage eignet sich am besten für Bearbeitungssteuerelemente, die Dateinamen enthalten, die auf Dateisystemen verwendet werden, die Unicode nicht unterstützen.
Verwenden Sie "SetWindowLong", um diese Formatvorlage nach dem Erstellen des Steuerelements zu ändern.
ES_PASSWORD
Zeigt ein Sternchen (*) für jedes in das Bearbeitungssteuerelement eingegebene Zeichen an. Diese Formatvorlage ist nur für Einzelzeilenbearbeitungssteuerelemente gültig.
Wenn Sie die angezeigten Zeichen ändern oder diese Formatvorlage festlegen oder deaktivieren möchten, verwenden Sie die EM_SETPASSWORDCHAR Nachricht.
[! Hinweis]
Um Comctl32.dll Version 6 zu verwenden, geben Sie sie in einem Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

ES_READONLY
Verhindert, dass der Benutzer Text im Bearbeitungssteuerelement ein- oder bearbeitet.
Um diese Formatvorlage nach dem Erstellen des Steuerelements zu ändern, verwenden Sie die EM_SETREADONLY Nachricht.
ES_RIGHT
Rechtsbündig ausgerichteter Text in einem einzelzeiligen oder mehrzeiligen Bearbeitungssteuerelement.
ES_UPPERCASE
Wandelt alle Zeichen in Großbuchstaben um, während sie in das Bearbeitungssteuerelement eingegeben werden.
Verwenden Sie "SetWindowLong", um diese Formatvorlage nach dem Erstellen des Steuerelements zu ändern.
ES_WANTRETURN
Gibt an, dass ein Wagenrücklauf eingefügt wird, wenn der Benutzer die EINGABETASTE drückt, während er Text in ein Mehrlinienbearbeitungssteuerelement in ein Dialogfeld eingibt. Wenn Sie diese Formatvorlage nicht angeben, hat das Drücken der EINGABETASTE denselben Effekt wie das Drücken der Standardschaltfläche des Dialogfelds. Diese Formatvorlage hat keine Auswirkung auf ein einzelnes Bearbeitungssteuerelement.
Verwenden Sie "SetWindowLong", um diese Formatvorlage nach dem Erstellen des Steuerelements zu ändern.

Anforderungen

Anforderung Wert
Header
Winuser.h