DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Propriétés WLangage / Propriétés des fenêtres, des pages et de leurs champs
  • Définition
  • Cas particulier : Champ RTF
  • Limite : Modification de la position du curseur de saisie
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées

Définition

Le curseur de souris permet de visualiser facilement l'endroit où l'action va se dérouler. Dans le cas d'un champ en saisie, le curseur se transforme en trait vertical clignotant et permet d'identifier rapidement la position du prochain caractère saisi.

Si une sélection est effectuée dans le champ, les caractères sélectionnés sont mis en surbrillance. La position du curseur correspond au début de la zone affichée en surbrillance.
Quelques exemples :
Image avec curseur de saisie placé au début de la zone
Le curseur de saisie est placé au début de la zone de saisie. Sa position est 1.
Image avec curseur de saisie placé à la fin de la zone
Le curseur de saisie est placé à la fin de la zone de saisie. Sa position est 7 dans cet exemple.
Image avec curseur de saisie placé au début de la zone en inverse vidéo
Le curseur de saisie est placé au début de la zone en en surbrillance (position 3 dans cet exemple). La propriété FinCurseur permet de connaître et de modifier la fin de la zone sélectionnée.
La propriété Curseur permet de connaître et de modifier la position du curseur de la souris dans un des champs suivants :
  • Champ de saisie.
  • Champ Combo avec saisie.
  • Colonne d'un champ Table de type "Champ de saisie" et colonne d'un champ Table de type "Combo avec saisie".
  • WINDEV Champ Traitement de texte.
  • WINDEV Champ Editeur HTML.
  • WINDEV Champ Editeur de code.
  • Nouveauté SaaS
    WEBDEV - Code Navigateur Champ Editeur de code.
Remarque : Pour connaître le texte sélectionné dans un champ de saisie, un champ Combo avec saisie ou une colonne d'un champ Table, il est possible d'utiliser la propriété TexteSélectionné.
Nouveauté SaaS
WEBDEV - Code Navigateur Cette propriété est désormais disponible en code navigateur pour le champ Editeur de code.
Astuce : Pour sélectionner une partie d'un texte d'un champ de saisie à partir d'un champ Bouton :
  1. Le champ de saisie ne doit pas avoir l'option "Effacement automatique" cochée (sauf si tout le contenu du champ doit être supprimé).
  2. Le bouton doit être de type "Interruption" et contenir par exemple le code suivant :
    // -- Clic du bouton BTN_Sélection (bouton de type Interruption)
    // Sélectionner tout le texte
    SAI_Saisie1.Curseur = 1
    SAI_Saisie1.FinCurseur = Taille(SAI_Saisie1) + 1
    EcranPremier(SAI_Saisie1)
Exemple
// Insérer une chaîne de caractères à la position du curseur
SAI_ChampNom = Gauche(SAI_ChampNom, SAI_ChampNom.Curseur) + ...
" est appelé " + Droite(SAI_ChampNom, SAI_ChampNom.Curseur)
Syntaxe

Connaître la position du curseur de saisie Masquer les détails

<Valeur actuelle> = <Champ manipulé>.Curseur
<Valeur actuelle> : Entier
Position actuelle du curseur de saisie dans le champ. Cette position peut varier entre :
  • 0 (le champ n'est pas en saisie et il n'y a pas de curseur de saisie).
  • Le nombre de caractères affichés dans le champ + 1 (le curseur de saisie se trouve à la fin de la zone de saisie).
<Champ manipulé> : Nom de champ
Nom du champ dans lequel le curseur de saisie est affiché :
  • Champ de saisie.
  • Champ Combo avec saisie.
  • Colonne d'un champ Table de type "Champ de saisie" et colonne d'un champ Table de type "Combo avec saisie".
  • WINDEV Champ Traitement de texte.
  • WINDEV Champ Editeur HTML.
  • WINDEVWEBDEV - Code Navigateur Champ Editeur de code.

Modifier la position du curseur de saisie Masquer les détails

<Champ manipulé>.Curseur = <Nouvelle valeur>
<Champ manipulé> : Nom de champ
Nom du champ dans lequel la position du curseur de saisie doit être modifiée :
  • Champ de saisie.
  • Champ Combo avec saisie.
  • Colonne d'un champ Table de type "Champ de saisie" et colonne d'un champ Table de type "Combo avec saisie".
  • WINDEV Champ Traitement de texte.
  • WINDEV Champ Editeur HTML.
  • WINDEVWEBDEV - Code Navigateur Champ Editeur de code.
<Nouvelle valeur> : Entier
Nouvelle position du curseur de saisie, comprise entre 1 et le nombre de caractères actuellement affichés dans le champ + 1.
Remarques
WINDEVWindowsCode Utilisateur (MCU)

Cas particulier : Champ RTF

Le nombre de caractères d'un champ RTF peut être différent si ce champ contient des Retours Chariots (RC).
En effet, dans un champ non RTF, le caractère RC correspond à 2 caractères, et dans un champ RTF, le caractère RC correspond à un caractère.

Limite : Modification de la position du curseur de saisie

La modification de la position du curseur de saisie n'est possible que si le champ est en cours de saisie. Si le champ n'est pas en cours de saisie, la propriété Curseur renvoie 0.
Rappel : Il est possible de forcer la saisie dans un champ en utilisant les fonctions EcranPremier ou DonneFocusEtRetourUtilisateur.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale