TEXTBOX

Voir également Exemple

Accès aux propriétés du contrôle de formulaire Zone de texte.

Support WebVue - Non. Renvoie un code d'erreur si exécuté dans ce contexte.

Mode	Mnémonique	Syntaxe
1	GETTEXT	1
2	SETTEXT	2
3	APPENDTEXT	3
4	GETSELECTEDTEXT	1
5	GETLINETEXT	4
6	GETLINECOUNT	5
7	CLEAR	5
8	COPY	5
9	CUT	5
10	PASTE	5
11	SETREADONLY	6
12	SETBACKCOLOR	7
13	SETTEXTCOLOR	7
14	GETTEXTLENGTH	5
15	SELECTTEXT	8
16	INDEXOF	9
17	ENABLEEVENTS	6
18	REPLACE	10

Toutes Syntaxes

Argument	Définition
Window	Nom de la fenêtre contenant le contrôle. Type STR.
Branch	Branche (si elle existe) de la fenêtre. Utiliser "*" pour indiquer la branche courante du programme. Type STR.
Identity	Identifiant du contrôle dans la fenêtre spécifiée. Type STR.
Text	Chaîne de caractères. Type STR.

Syntaxe 1

StrVal = TEXTBOX(Mode, Window, Branch, Identity);

Type de retour : STR.

Exécution

Mode	Mnémonique	Action
1	GETTEXT	Retourne tout le texte affiché dans la Zone de texte. Retour : Texte si OK, vide sinon.
4	GETSELECTEDTEXT	Renvoie tout le texte sélectionné dans la Zone de texte. Retour : Texte si OK, vide sinon.

Syntaxe 2

LongVal = TEXTBOX(Mode, Window, Branch, Identity, Text);

Type de retour : LONG.

Exécution

Mode	Mnémonique	Action
2	SETTEXT	Définit le texte dans la Zone de texte. Retour : 1 si OK, - 1 sinon.

Syntaxe 3

LongVal = TEXTBOX(Mode, Window, Branch, Identity, Text [, NewLine])

Type de retour : LONG.

Argument	Définition
Newline	Indicateur d'ajout du texte. Optionnel. Par défaut = 0. 1 = Texte ajouté comme une nouvelle ligne. 0 = Texte ajouté immédiatement après un texte existant (pas de nouvelle ligne).

Exécution

Mode	Mnémonique	Action
3	APPEND	Ajoute le texte fourni Retour : 1 si OK, -1 sinon.

Syntaxe 4

StrVal = TEXTBOX(Mode, Window, Branch, Identity, Line)

Type de retour : STR.

Argument	Définition
Line	Index basé sur 1 d'une ligne dans la Zone de texte. Type INTEGER.

Exécution

Mode	Mnémonique	Action
5	GETLINETEXT	Renvoie le texte de la ligne donnée. Retour : Texte si OK, une chaîne vide sinon.

Syntaxe 5

LongVal = TEXTBOX(Mode, Window, Branch, Identity)

Type de retour : LONG.

Exécution

Mode	Mnémonique	Action
6	GETLINECOUNT	Renvoie le nombre de lignes dans la Zone de texte. Retour : Le nombre de lignes si OK, -1 sinon.
7	CLEAR	Efface tout le texte dans la Zone de texte. Retour : 1 si OK, -1 sinon.
8	COPY	Copie le texte sélectionné de la Zone de texte dans le presse-papiers. Retour : 1 si OK, -1 sinon.
9	CUT	Coupe le texte sélectionné de la Zone de texte et le colle dans le presse-papiers. Retour : 1 si OK, -1 sinon.
10	PASTE	Remplace le texte sélectionné dans la Zone de texte par le contenu du presse-papiers. Retour : 1 si OK, -1 sinon.
14	GETTEXTLENGTH	Renvoie la longueur du texte dans la Zone de texte. Retour : Le nombre de caractères si OK, -1 sinon.

Syntaxe 6

LongVal = TEXTBOX(Mode, Window, Branch, Identity, Flag)

Type de retour : LONG.

Argument	Définition
Flag	Indicateur spécifiant l'opération. Soit 0 ou 1. 1 = Lecture seule. 0 = Lecture et écriture.

Exécution

Mode	Mnémonique	Action
11	SETREADONLY	Définit le mode de lecture/écriture de la Zone de texte en fonction de l'indicateur fourni. 1 = Lecture seule. 0 = Lecture et écriture.
17	ENABLEEVENTS	Active ou désactive les événements de la Zone de texte (changements de texte, touche enfoncée) en fonction de l'indicateur fourni. 1 = Evénements activés. 0 = Evénements désactivés.
		Retour : 1 si OK, -1 sinon.

Syntaxe 7

LongVal = TEXTBOX(Mode, Window, Branch, Identity, Red, Green, Blue)

Type de retour : LONG.

Argument	Définition
Red, Green, Blue	Composants de couleur compris entre 0 et 255. Par exemple, 0, 0, 255 est bleu. Type : INTEGER.

Exécution

Mode	Mnémonique	Action
12	SETBACKCOLOR	Définit la couleur d'arrière-plan de la Zone de texte.
13	SETTEXTCOLOR	Définit la couleur du texte de la Zone de texte.
		Retour : 1 si OK, -1 sinon.

Syntaxe 8

LongVal = TEXTBOX(Mode, Window, Branch, Identity[, Start [, Length]])

Type de retour : LONG.

Argument	Définition
Start	Position du caractère avec le texte de la Zone de texte. Type INTEGER.
Length	Nombre de caractères. Type INTEGER.

Exécution

Mode	Mnémonique	Action
15	SELECTTEXT	Sélectionne du texte de la zone de text en utilisant les critères suivants. Si Start est omis, tout le texte est sélectionné. Si Start est donné et Length est omis, le texte est sélectionné de la position Start à la fin. Si Start et Length sont donnés, le texte est sélectionné à partir de Start et jusqu'à Start + Length. Retour : 1 si OK, -1 sinon.

Syntaxe 9

LongVal = TEXTBOX(Mode, Window, Branch, Identity, Substring [, Start])

Type de retour : LONG.

Argument	Définition
SubString	Chaîne de caractères. Type STR.
Start	Position du caractère avec le texte de la Zone de texte. Type INTEGER

Exécution

Mode	Mnémonique	Action
16	INDEXOF	Renvoie l'index basé sur zéro de la première occurrence de SubString dans la zone de texte. La recherche commence à la position Start. Si Start est omis, la recherche commence au début du texte. Retour : Position de la première occurrence de la sous-chaîne en cas de succès, - 1 sinon.

Syntaxe 10

LongVal = TEXTBOX(Mode, Window, Branch, Identity, OldString, NewString [, Start[, Length]])

Type de retour : LONG.

Argument	Définition
OldString	Chaîne de caractères. Type STR.
NewString	Chaîne de caractères. Type STR.
Start	Position du caractère avec le texte de la Zone de texte. Type INTEGER.
Length	Longueur du texte dans lequel la recherche a lieu. Type INTEGER.

Exécution

Mode	Mnémonique	Action
18	REPLACE	Recherche le texte des occurrences de OldString et le remplace par NewString. La recherche commence à la position Start et continue jusqu'à ce que Start + length soit atteint. Si Start est omis, la recherche commence à la position 0. Si Length est omis, la recherche continue jusqu'à la fin du texte. Retour : 1 si OK, -1 sinon.

Exemple

Pour un exemple, sélectionnez le lien Exemple ci-dessus.