Date de parution : 06/11/2001
- Cette fiche API a été lue 1221 fois
Description
GetNumberFormat formate un nombre pour l'affichage. Par défaut, la fonction formate le nombre en accord avec le paramétrage local. Cependant, des préférences de formatage personalisées peuvent être utilisées. En cas d'erreur, la fonction returne 0 (utiliser GetLastError pour obtenir un code d'erreur). Si la fonction réussit, elle retourne le nombre de caractères copiés dans la chaîne lpNumberStr sans inclure le caractère à terminateur nul.
Identifiant local pour le formatage du nombre. Alternativement, cela peut être un des sémaphores suivants :
LOCALE_SYSTEM_DEFAULT = 0x400
paramètre système.
LOCALE_USER_DEFAULT = 0x800
paramètre utilisateur.
dwFlags
Si aucune structure n'est passée dans lpFormat, ce paramètre détermine le format du nombre à utiliser. S'il est mis à 0, le paramètrage local sera pris.
lpValue
Chaîne contenant le nombre à formater. Les seules caractères permis sont des numériques de 0-9 et le seul point du séparateur décimal(.). Si le nombre est négatif, le premier caractère doit être un tiret (-). Tout autre caractère est invalide.
lpFormat
Pour surclasser le paramètrage local, il faut passer par la structure NUMBERFMT qui contient l'information de formatage appropriée. Pour le formatage local, laisser ce paramètre à 0.
lpNumberStr
Chaîne à terminateur nul qui reçoit le nombre formaté.
cchNumber
Nombre de caractères pour lpNumberStr.
Compatibilité
Windows 95 :
supporté.
Windows 98 :
supporté.
Windows NT :
réclame Windows NT 3.5 ou plus.
Windows 2000 :
supporté.
Windows CE :
réclame Windows CE 1.0 ou plus.
Remarque
Aucune
Exemple 1
// Affiche le nombre -1.234.567,89 avec deux règles de formatage :
// 1. le format spécifié en local
// 2. un format personnalisé passé par une structure à la fonction
nft
est un
NUMBERFMT
formatage est une chaîne asciiz sur 255 // reçoit le nombre à formater
longch est un entier long
// Maintenant avec un format décrit ci-dessous
// Code offert par Beaussier en ligne...
// Afficher avec trois chiffres après la virgule
nft:NumDigits = 3
// Afficher des zéros après la virgule
nft:LeadingZero = 1
// Grouper par trois chiffres pour les décimales.
nft:Grouping = 3
// Utiliser un point en séparateur (comme chez les anglo-saxons)
nft:lpDecimalSep = "."
// Utiliser une virgule pour la séparation des milliers
nft:lpThousandSep = ","
// Mettre le signe négatif à la fin du nombre
nft:NegativeOrder = 3