UDF > GUI > GuiRichEdit >


_GUICtrlRichEdit_Create

Crée un contrôle d'édition RichEdit

#include <GuiRichEdit.au3>
_GUICtrlRichEdit_Create ( $hWnd, $sText, $iLeft, $iTop [, $iWidth = 150 [, $iHeight = 150 [, $iStyle = -1 [, $iExStyle = -1]]]] )

Paramètres

$hWnd Handle du parent ou de la fenêtre propriétaire
$sText Texte à afficher dans le contrôle
$iLeft Position horizontale du contrôle
$iTop Position verticale du contrôle
$iWidth [optionnel] Largeur du contrôle
$iHeight [optionnel] Hauteur du contrôle
$iStyle [optionnel] Style du contrôle:
    $ES_AUTOHSCROLL - Fait défiler automatiquement le texte vers la droite de 10 caractères lorsque l'utilisateur tape un caractère à la fin de la ligne.
    $ES_AUTOVSCROLL - Fait défiler automatiquement le texte d'une page vers le haut lorsque l'utilisateur appuie sur la touche ENTER sur la dernière ligne.
    $WS_HSCROLL - Le contrôle a une barre de défilement horizontale
    $WS_VSCROLL - Le contrôle a une barre de défilement verticale
    $ES_CENTER - Centre le texte dans le contrôle d'édition.
    $ES_LEFT - Aligne le texte sur la marge gauche.
    $ES_MULTILINE - Génère un contrôle multiligne (par défaut)
    $ES_NOHIDESEL - Le texte sélectionné est inversé, même si le contrôle n'a pas le focus.
    $ES_NUMBER - Permet uniquement la saisie de chiffres dans le contrôle d'édition.
    $ES_READONLY - Empêche l'utilisateur de taper ou de modifier du texte dans le contrôle d'édition.
    $ES_RIGHT - Aligne à droite le texte du contrôle d'édition.
    $ES_WANTRETURN - Spécifie qu'un retour chariot est inséré lorsque l'utilisateur appuie sur la touche ENTER. (Par défaut)
    $ES_PASSWORD - Affiche un astérisque (*) pour chaque caractère tapé dans le contrôle d'édition
Default: 0
Forced: WS_CHILD, $WS_VISIBLE, $$WS_TABSTOP sans ES_READONLY
$iExStyle [optionnel] Styles étendus de contrôle. Ils correspondent aux constantes standards $WS_EX_*. Voir Table des Styles Etendus.

Valeur de retour

Succès: Retourne le handle du contrôle RichEdit.
Échec: Retourne 0 et définit @error <> 0.
@error: 105 - $iWidth n'est ni un nombre positif ni -1
106 - $iHeight n'est ni un nombre positif ni -1
107 - $iStyle n'est ni un nombre positif ni zéro ni -1
108 - $iExStyle n'est ni un nombre positif ni zéro ni -1

En relation

_GUICtrlRichEdit_Destroy

Exemple

#include <GUIConstantsEx.au3>
#include <GuiRichEdit.au3>
#include <WindowsConstants.au3>

Example()

Func Example()
    Local $hGui, $hRichEdit
    $hGui = GUICreate("Exemple (" & StringTrimRight(@ScriptName, StringLen(".exe")) & ")", 320, 350, -1, -1)
    $hRichEdit = _GUICtrlRichEdit_Create($hGui, "Ceci est un test.", 10, 10, 300, 220, _
            BitOR($ES_MULTILINE, $WS_VSCROLL, $ES_AUTOVSCROLL))
    _GUICtrlRichEdit_AppendText($hRichEdit, @CRLF & "Ceci est du texte en plus")
    GUISetState(@SW_SHOW)

    While GUIGetMsg() <> $GUI_EVENT_CLOSE
    WEnd

    _GUICtrlRichEdit_Destroy($hRichEdit) ; Nécessaire à moins que le script se bloque
    ; GUIDelete()   ; est OK aussi
EndFunc   ;==>Example