Manuel - Aztec
Introduction
Le code Aztec fait partie de la famille des codes-barres en 2D. Il permet d'encoder une grande quantité d'information en un seul code-barres.
Tous les caractères ASCII de 0 à 255 sont supportés. La taille du code sera déterminée en fonction du nombre de données entrées ainsi que du niveau d'erreur choisi.
Il est possible de passer en mode ECI avec la fonction SetTilde().
Cette classe hérite de la classe BCGBarcode2D.
Exemple
Méthodes
Méthodes de BCGaztec
- GetErrorLevel() — Retourne le niveau d'erreur du code-barres
-
SetErrorLevel(int
level ) — Fixe le niveau d'erreur du code-barres - GetSize() — Retourne la taille du code-barres
-
SetSize(int
value ) — Fixe la taille du code-barres -
SetStructuredAppend(int
snum , intst , stringsname ) — Spécifie que les données seront dispersées sur plusieurs codes-barres - GetTilde() — Retourne si le comportement du caractère ~ est modifié
-
SetTilde(bool
accept ) — Modifie le fonctionnement du caractère tilde ~ - GetRune() — Retourne le numéro du Rune qui sera dessiné
-
SetRune(int
runeNumber ) — Spécifie de dessiner un Rune
Méthodes de BCGBarcode2D
-
SetScaleX(int
scaleX ) — Spécifie la résolution du codes-barres en X -
SetScaleY(int
scaleY ) — Spécifie la résolution du codes-barres en Y
Méthodes de BCGBarcode
-
Parse(string
text ) — Analyse un messagetext pour dessiner par la suite -
Draw(Graphics
image ) — Dessine le code-barres sur l'imageimage -
GetDimension(int
width , intheight ) — Retourne un tableau concernant la taille de l'image requise - GetScale() — Retourne la résolution du code-barres
-
SetScale(int
scale ) — Fixe la résolution du code-barres - GetForegroundColor() — Retourne la couleur des barres
-
SetForegroundColor(BCGColor
color ) — Fixe la couleur des barres - GetBackgroundColor() — Retourne la couleur des espaces
-
SetBackgroundColor(BCGColor
color ) — Fixe la couleur des espaces -
SetColor(BCGColor
foregroundColor , BCGColorbackgroundColor ) — Fixe la couleur des barres et des espaces - GetOffsetX() — Retourne le décalage en X
-
SetOffsetX(int
value ) — Spécifie le décalage en X - GetOffsetY() — Retourne le décalage en Y
-
SetOffsetY(int
value ) — Spécifie le décalage en Y -
AddLabel(BCGLabel
label ) — Ajoute un texte qui accompagne le dessin -
RemoveLabel(BCGLabel
label ) — Supprime un texte qui accompagne le dessin - ClearLabels() — Supprime les textes qui accompagnent le dessin
Exemple de Code
var colorBlack = new BCGColor(Color.Black);
var colorWhite = new BCGColor(Color.White);
// Barcode Part
var code = new BCGaztec();
code.SetScale(2);
code.SetForegroundColor(colorBlack);
code.SetBackgroundColor(colorWhite);
code.SetErrorLevel(23);
code.Parse("Aztec");
// Drawing Part
var drawing = new BCGDrawing(code, colorWhite);
var memoryStream = new MemoryStream();
await drawing
.FinishAsync(BCGDrawing.ImageFormat.Png, memoryStream);
Explications des Méthodes
-
GetErrorLevel()
—
Retourne le niveau d'erreur du code-barres
DescriptionLe pourcentage de correction d'erreur.Retourne
int - valeur entre 0 et 99 -
SetErrorLevel(int
level ) — Fixe le niveau d'erreur du code-barresDescriptionLe pourcentage de correction d'erreur défini avant de dessiner le code-barres.
Le niveau donné doit être entre 5 et 99.
La valeur par défaut est 23. -
GetSize()
—
Retourne la taille du code-barres
DescriptionRetourne le code pour la taille du code-barres final.
Voyez aussi SetSize() pour plus de détails.Retourneint - constante définie àSetSize() -
SetSize(int
value ) — Fixe la taille du code-barresDescriptionLa taille du code-barres finale sera décidée automatiquement dépendamment du nombre de données que vous avez spécifié ainsi que le pourcentage de correction d'erreur.
Cependant, vous pouvez spécifier une valeur afin d'obtenir un code différent. Voici les valeurs possibles :
-BCGaztec.Size.Smallest : Le code sera le plus petit possible
-BCGaztec.Size.Compact : Le code essaiera d'être compact s'il le peut
-BCGaztec.Size.Full : Le code sera en mode full (avec la grille de référence)
La valeur par défaut estBCGaztec.Size.Smallest . -
SetStructuredAppend(int
snum , intst , stringsname ) — Spécifie que les données seront dispersées sur plusieurs codes-barresDescriptionLes données du code Aztec peuvent être séparées sur plusieurs codes-barres.
Le premier argument est le numéro du code-barres (commençant par 1), le deuxième argument est le nombre total de codes-barres que vous avez. Le dernier argument est optionnel, il spécifie un identifiant à votre groupe de code-barres. Celui-ci doit rester le même pour chaque code-barres.
Il est possible d'encoder sur 26 codes-barres différents au maximum.Retournebool -true en cas de succès,false en cas d'échec -
GetTilde()
—
Retourne si le comportement du caractère ~ est modifié
DescriptionRetourne si le comportement du caractère ~ est modifié.
Voyez aussi SetTilde() pour plus de détails.Retournebool -true si activé,false autrement -
SetTilde(bool
accept ) — Modifie le fonctionnement du caractère tilde ~DescriptionEn mettanttrue à l'argument de cette méthode, les caractères tilde (ASCII 126 ~) seront pris comme des caractères spéciaux. Voici les caractères spéciaux que vous pouvez écrire.
- ~~ : Écrit un simple tilde
- ~F : Écrit le caractère FNC1
- ~Exxxxxx : Écrit le caractère ECI xxxxxx avec x pouvant varier de 0 à 9
La valeur par défaut est false. -
GetRune()
—
Retourne le numéro du Rune qui sera dessiné
DescriptionRetourne le numéro du Rune qui sera dessiné.Retourne
int - numéro du Rune oufalse si aucun Rune ne sera dessiné -
SetRune(int
runeNumber ) — Spécifie de dessiner un RuneDescriptionLe numéro du RuneruneNumber sera dessiné à l'écran. Les Runes sont des symboles spéciaux.
Le numéro Rune doit être spécifié entre 0 et 255.
La valeur par défaut est -1.
-
SetScaleX(int
scaleX ) — Spécifie la résolution du codes-barres en XDescriptionLa largeur en pixel d'un module.
La valeur par défaut est 1.
Notez que cette méthode est protégée (protected). -
SetScaleY(int
scaleY ) — Spécifie la résolution du codes-barres en YDescriptionLa hauteur en pixel d'un module.
La valeur par défaut est 1.
Notez que cette méthode est protégée (protected).
-
Parse(string
text ) — Analyse un messagetext pour dessiner par la suiteDescriptionLes données que vous passez à l'argumenttext doivent être supportées par le type de code-barres que vous utilisez.
Référez-vous à l'introduction de chaque code-barres pour obtenir plus d'informations comment utiliser cette méthode pour chaque type de code-barres. -
Draw(Graphics
image ) — Dessine le code-barres sur l'imageimage DescriptionLa valeur de l'argumentimage doit être une image ressource. La taille de l'image peut être définie avec la valeur reçue deGetDimension() . -
GetDimension(int
width , intheight ) — Retourne un tableau concernant la taille de l'image requiseDescriptionRetourne un tableau dont le premier index est la largeur de l'image et le deuxième index est la hauteur de l'image.
Les arguments sont utilisés pour spécifier le point de départ du dessin. Ils devraient être 0.
La classeBCGDrawing utilise cette fonction pour créer la ressource d'image.Retournearray(int, int) - [0] étant la largeur, [1] étant la hauteur -
GetScale()
—
Retourne la résolution du code-barres
DescriptionRetourne la taille du code-barres. La valeur correspond à la "plus petite" unité exprimée en pixel.Retourne
int - valeur en pixels -
SetScale(int
scale ) — Fixe la résolution du code-barresDescriptionLe code-barres serax fois plus grand. Un pixel sera alors de taillex parx . -
GetForegroundColor()
—
Retourne la couleur des barres
DescriptionRetourne la couleur des barres du code-barres.Retourne
-
SetForegroundColor(BCGColor
color ) — Fixe la couleur des barres -
GetBackgroundColor()
—
Retourne la couleur des espaces
DescriptionRetourne la couleur des espaces du code-barres.Retourne
-
SetBackgroundColor(BCGColor
color ) — Fixe la couleur des espaces -
SetColor(BCGColor
foregroundColor , BCGColorbackgroundColor ) — Fixe la couleur des barres et des espacesDescriptionUne méthode plus rapide pour fixer la couleur de premier plan et de l'arrière-plan. Référez-vous àSetForegroundColor() etSetBackgroundColor() . -
GetOffsetX()
—
Retourne le décalage en X
DescriptionRetourne le décalage en X en pixel. Cette valeur n'est pas multipliée par la résolution.Retourne
int - valeur en pixels -
SetOffsetX(int
value ) — Spécifie le décalage en XDescriptionSpécifie le décalage en X du code-barres en pixel multiplié par la résolution. La taille requise retournée parGetDimension() sera modifiée en conséquence. -
GetOffsetY()
—
Retourne le décalage en Y
DescriptionRetourne le décalage en Y en pixel. Cette valeur n'est pas multipliée par la résolution.Retourne
int - valeur en pixels -
SetOffsetY(int
value ) — Spécifie le décalage en YDescriptionSpécifie le décalage en Y du code-barres en pixel multiplié par la résolution. La taille requise retournée parGetDimension() sera modifiée en conséquence. -
AddLabel(BCGLabel
label ) — Ajoute un texte qui accompagne le dessinDescriptionAjoute un objetBCGLabel au dessin. -
RemoveLabel(BCGLabel
label ) — Supprime un texte qui accompagne le dessinDescriptionSupprime un objetBCGLabel spécifique du graphique. -
ClearLabels()
—
Supprime les textes qui accompagnent le dessin
DescriptionSupprime tous les objets
BCGLabel du dessin.