$excel.autosize

Description

Ajuste automatiquement les dimensions de cellules d'une sheet.

Syntaxe

$excel.autosize( workbook , rules [, options ] )

Paramètres

workbook pojo

Workbook à traiter

rules map / array

Règle de redimensionnement, passée sous la forme d'un objet de type map contenant les propriétés suivantes:

sheet string

Nom de la sheet que l'on veut traiter

columns string / array

Facultatif. Colonne(s) à redimensionner. La ou les colonnes sont à référencer par leur position (1-based).

Le paramètre peut prendre une valeur seule, dans ce cas seule cette colonne est adaptée.

Le paramètre peut prendre la valeur "*", dans ce cas toutes les colonnes sont adaptées.

Le paramètre peut avoir la forme x-y, dans ce cas les colonnes x à y (compris) sont adaptées. Les valeurs x et/ou y peuvent être remplacées par "*".

Le paramètre peut également être un tableau de string, auquel cas la méthode boucle sur le tableau et traite chaque entrée comme décrit ci-dessus.

rows string / array

Facultatif. Lignes(s) à redimensionner. La ou les lignes sont à référencer par leur position (1-based).

Le paramètre peut prendre une valeur seule, dans ce cas seule cette ligne est adaptée.

Le paramètre peut prendre la valeur "*", dans ce cas toutes les lignes sont adaptées.

Le paramètre peut avoir la forme x-y, dans ce cas les lignes x à y (compris) sont adaptées. Les valeurs x et/ou y peuvent être remplacées par "*".

Le paramètre peut également être un tableau de string, auquel cas la méthode boucle sur le tableau et traite chaque entrée comme décrit ci-dessus.

Le paramètre rules peut être un tableau contenant les règles d'autosize ci-dessus.

options map

Options de traitement. Les propriétés suivantes sont traitées:

mode string

Mode de traitement à appliquer. La propriété peut prendre les valeurs poi ou int. Par défaut, le mode poi est utilisé.

La méthode poi utilise le mécanisme interne de POI.

La méthode int applique une solution interne qui calcule une approximation de la largeur de colonne. Cela donne un résultat moins précis, mais le traitement est beaucoup plus rapide.

maxLength number

Largeur max des colonnes. Cette propriété n'est traitée que lorsque la méthode reçoit des règles de redimensionnement de colonnes et que le mode int est utilisé. La largeur est définie en nombre de caractères. Par exemple si on définit une valeur 50, la méthode dimensionnera les colonnes avec une largeur max correspondant à environ 50 caractères (dans la police Serif).

Retour

Retourne true si le redimensionnement a pu se faire sans erreur, sinon false.

Exemple

Non disponible