SilTextBox

30/11/03

Traducción al frances de la documentación, provisionalmente las propiedades, metodos y eventos estan sin traducir, para indicar esto aparecen en esta página los nombres que tendrán en color azul (Alignement)

20/11/02

Deux nouvelles propriétés s'ajoutent, ErrorFormato (ErreurFormat) et OcultarMensajes (CacherMessages).

La méthode Validerdate change légèrement en vérifiant si la date est correcte (voir méthode ValidarFecha (ValiderFichier)).

La méthode ValidarHora (ValiderHeure) est rendue publique.

31/01/02

Une nouvelle propriété, CaptionError (CaptionErreur), s'ajoute. Nous avions oublié le titre de la fenêtre d'erreur de format, de dates et heures, et lorsque l'on introduit moins de caractères que ceux spécifiés dans MinLen.

Les méthodes PonerMascara (MettreMascara), QuitarMascara (QuitterMascara) et ValidarFecha (ValiderDate) sont rendues publique.

Le SilTextBox est une extension de contrôle TextBox, nous allons énumérer en quoi s'étend le TextBox tout en décrivant ses propriétés.

Propiét

Descriptión

Alineacion (Alignement)

Equivaut à la propriété alignement de TextBox

Valeur	Signification
0 - Izquierda (Gauche)	Texte aligné à gauche
1 - Derecha (Droite)	Texte aligné à droite
2 - Centro (Centre)	Texte centré sur le contrôle

BackOnFocus

Couleur de fond de SilTextBox lorsqu'il prend le focus, en changeant le focus, le fond initial est restauré.

Caja (Casse)

Valeur	Signification
0 - Inactivo (Inactif)	Aucune modification ne se fait sur le texte introduit.
1 - Mayusculas (Majuscules)	Convertit toutes les lettres en majuscules.
2 - Minusculas (Minuscules)	Convertit toutes les lettres en minuscules.
3 - Iniciales (Initiales)	Met toutes les lettres en minuscules sauf la première de chaque mot qui la met en majuscules. Cela peut s'utiliser pour les champs oú il faut introduire un nom.

CaptionError (CaptionErreur)

Titre de la fenêtre qui informe de l'erreur de format en introduisant une date ou une heure, ou lorsque l'on introduit moins de caractères que ceux indiqués dans MinLen.

DBDato (BDDonnée)

Nom d'une donnée appartenant au tableau indiqué dans BDTableau.

Par ces trois données (BDDonnée, BDNom, BDTableau), nous faisons référence à une donnée concrète d un tableau appartenant à une base de donnée. Nous cherchons à ce que, selon ce que l´on va taper dans le SilTextBox, celui-çi va faire une recherche dans le tableau en localisant la valeur de la donnée qui contient les caractères précedement tapés, et en visualisant le reste de la donnée.

DBNombre (BDNom)

Relie le SilTextBox à une base de données de Microsoft Access, à laquelle on accède grâce à ADO et Recordset; pour cela il vous faudra installer Microsoft.Jet.OleDB.4.0 et Microsoft Data ActiveX Data Object 2.0 library ou superieur. Cela n'a rien à voir avec la propiété DataSource. Vous devez introduire le nom de la base de donées avec le path complet.

DBTabla (BDTabla)

Nom d'un tableau à l interieur de la base de donées indiquée dans la propriété BDNom

Decimales

Nombre de chiffres décimaux admis, on l'utilise aussi pour formater le nombre. On pourra mettre jusqu'à six décimales. Même si l'on introduit plus de décimales que celles indiquées, celles-çi se couperont et se perdront en formatant le nombre, si on ne tape pas suffisament de chiffres, des zéros s'afficheront. En aucun cas le nombre tapé s'arrondira.

ErrorFormato (ErreurFormat)

Champ booleano qui est renvoyé s' il s'est produit une erreur en validant les formats de date et heure.

MinLen

Nombre de caractères minimaux que doit avoir la donnée

OcultarMensajes (CacherMessages)

Champ booleano qui sert à cacher les messages d'erreur. Si la valeur est vrai, les messages d'erreur ne se présenteront pas et si la valeur est fausse, ils apparaîtront.

Personalizado (Personnalise)

Si le type personnalisé est selectionné, on pourra seulement taper les données indiquées ici, en distinguant les majuscules des minuscules. Par exemple, s'il s'agit d'un téléphone et que nous voulons séparer les numéros avec des points en personnalisé, nous mettrons 0123456789., ainsi on peut mettre le téléphone de la forme 981.25.26.27 si on le mettrait en numérique, le numéro se formaterait de la forme suivante 981.252.627,comme si c'était un numéro normal.

Tipo (Type)

Valor	Significado
0 - Texto (Texte)	Indique que la valeur à introduire dans le SilTextBox est un string, il ne se fait aucun type de contrôle sur la donnée introduite.
1 - Letras (Lettres)	Permet seulement d'introduire des lettres, on ne peut introduire ni nombres ni caractères spéciaux ou ponctuations.
2 - Numérico (Numérique)	Seules des nombres peuvent être introduits, le point, la virgule et le signe moins. De plus en sortant de SilTextBox, le nombre se formatera en mettant des points et des virgules tout en séparant les milliers et les décimales (ex: 1.748.950,00. En entrant dans le SilTextBox (GotFocus) la mascara s'enlève. Aussi, en le selectionnant, la propriété alinéation se met automatiquement en 1 - Droite
3 - Fecha (Date)	La donnée introduite est une date. Il contrôle que la donnée soit une date valide. La date peut s'introduire de différentes manières, et toutes sont correctes. Les formats possibles sont jjmmaa - jjmmaaaa - jj.mm.aa - jj.mm.aaaa - jj/mm/aa - jj/mm/aaaa. Si jour, mois et année sont séparés et/ou si le premier chiffre de chaque nombre est un zéro, cela n'est pas considéré comme une faute.
4 - Hora (Heure)	La donnée introduite est une heure. Il contrôle que la donnée soit une heure correcte. L'heure peut síntroduire en séparant les heures des minutes avec les signes . , - : et il renverra toujours l'heure en utilisant : , c'est-à-dire qu'il convertit 12.30 en 12:30
5 - Configurable	En sélectionnant cette propriété, on pourra seulement taper les caractères indiqués dans la propriété Personnalisé.

Lorsqu'il se produit une erreur dans le format de la date, de l'heure ou de la longueur minimale même si le contrôle perd le focus, il revient à le récupérer. Dans certains cas, il peut arriver qu'en plaçant le contrôle SilTextBox dans la formulaire ou en le selectionnant avec la souris, la barre de titre de Vbasic vacille.

Méthode

Descriptión

PonerMascara (MettreMascara)

Mettre la variable type =2-Numérique et en executant la méthode mettre mascara, il renvoie la valeur formatée comme numéro. Il est aussi possible d'indiquer le nombre de décimales souhaitées dans le format. Ceci fonctionne seulement avec las cadenas de type numérique. Il n'est pas vérifié que la valeur introduite soit réellement un nombre.

          Dim Valor as String
          STextBox.Tipo=2>
          STextBox.Decimales=2
          Valor=STextBox.PonerMascara("123456,5")
          ' Valeur=STextBox.MettreMascara("123456,5")

En exécutant ce code Valeur = "123.456,50"

QuitarMascara (QuitterMascara)

Enlève les caractères "." et "," d'un champ type string à la cadena et convertit le caractère décimal à celui utilisé par le système dans les champs numériques.

          Dim Valor as String
          Valor=STextBox.QuitarMascara("123.456,5")
          ' Valor=STextBox.QQitterascara("123.456,5")

En exécutant ce code Valeur = "123456.50"

ValidarFecha (ValiderDate)

En exécutant la méthode ValiderDate, il renvoie la date formatée selon la date du système. On peut vérifier si la date est correcte en consultant la propriété ErreurFormat.

          Dim Valor as String

          Valor=STextBox.ValidarFecha("250205")
          Valor=STextBox.ValidarFecha("25/02/05")
          Valor=STextBox.ValidarFecha("25.02.05")
          Valor=STextBox.ValidarFecha("25.02-05")
          Valor=STextBox.ValidarFecha("25-2-05")
          Valor=STextBox.ValidarFecha("25022005")
          Valor=STextBox.ValidarFecha("25.02.2005")
          

          Dim Valeur as String
          Valeur=STextBox.ValiderDate("250205")
          Valeur=STextBox.ValiderDate("25/02/05")
          Valeur=STextBox.ValiderDate("25.02.05")
          Valeur=STextBox.ValiderDate("25.02-05")
          Valeur=STextBox.ValiderDate("25-2-05")
          Valeur=STextBox.ValiderDate("25022005")
          Valeur=STextBox.ValiderDate("25.02.2005")

En exécutant ce code, l résultat sera toujours le même, Valeur = "25/02/2005"

ValidarHora (ValiderHeure)

En exécutant la méthode ValiderHeure, il renvoie l´heure formatée. On peut vérifier que l'heure soit correcte en consultant la propriété ErreurFormat.

          Dim Valor as String

          Valor=STextBox.ValidarFecha("1202")
          Valor=STextBox.ValidarFecha("12.02")
          Valor=STextBox.ValidarFecha("12-02")
          Valor=STextBox.ValidarFecha("12/02")


          Dim Valeur as String
          Valeur=STextBox.ValiderDate("1202")
          Valeur=STextBox.ValiderDate("12.02")
          Valeur=STextBox.ValiderDate("12-02")
          Valeur=STextBox.ValiderDate("12/02")

En exécutant ce code, le résultat sera toujours le même, Valeur = "12:02"

Evènement

Descriptión

Resultado (Resultat)

Se produit en sortant du contrôle et renvoie le resultatdu même.

Ce Contrôle ActiveX est en libre distribution, pour pouvoir le reçevoir vous devrez envoyer un e-mail à informatica @ silared . com en indiquant dans l' objet SilTextBox, vous reçeverez automatiquement un nom d'utilisateur et un mot de passe pour accéder à la page de téléchargement. Vous pourrez utiliser ce contrôle dans autant d'applications que vous le désirez et pour un temps indéfini. En échange, j'espère qu'après l'avoir utilisé, vous m'enverrez un autre courrier éléctronique en me commentant si vous voyez une possible amélioration et si vous le jugez inutile, pourquoi ça l'est.