Altova MobileTogether Designer

Commandes de mesure

Accueil Préc Haut Suivant

L’action Commandes de mesure (capture d’écran ci-dessous) retourne la largeur minimum en pixels du types de commande spécifié (bouton ou libellé, par exemple) lorsque le string spécifié dans le premier paramètre est le texte d’affichage de la commande. L’action peut être utilisée pour trouver des largeurs de commande d’un ensemble de strings et d’utiliser cette information dans votre design. Par exemple, vous pouvez trouver la largeur de toutes les touches dans une colonne puis définir la largeur de cette colonne conformément à la largeur du bouton la plus grande.

MTActionMeasureControls

Strings de texte des commandes

Puisque la largeur de commande dépend de la taille de son texte, vous devez fournir dans le premier paramètre le string que vous souhaitez placer dans la commande. Si vous souhaitez connaître les largeurs de plusieurs commandes, chacune ayant un texte différent, vous devrez fournir ces textes en tant que les items de string d’une séquence. La valeur de retour sera une séquence contenant les largeurs de chaque string. Cette séquence sera stockée dans la variable MT_MeasureControls. Par exemple, dans la capture d’écran ci-dessus, nous avons fourni une séquence de deux strings : ("Altova Product", "Go to Product Description"). Ces strings ne doivent pas absolument être présents dans les commandes du design. La valeur de retour contiendra deux valeurs de nombre qui sont, respectivement, la largeur des deux strings. Vous pouvez ajouter n’importe quel string à la séquence pour découvrir la largeur de commande pour ce string.

 

Paramètres de texte

La deuxième configuration doit être une expression map XPath qui spécifie les paramètres pour lesquels le calcul de la largeur est effectué. Les paramètres contiennent des informations telles que : la commande mesurée est-elle un bouton ou un libellé, ou bien la taille du texte est-elle petite ou moyenne, ou bien le texte est-il gras ou pas. Les clés du map et leurs valeurs autorisées sont recensées ci-dessous. La seule clé obligatoire est "Control Kind". Si une clé n’est pas spécifiée, sa valeur par défaut sera utilisée. Dans la capture d’écran ci-dessus, par exemple, la largeur est mensurée pour des boutons sur lesquels le texts apparaît avec les valeurs par défaut des paramètres respectifs. L’expression XPath est : map{"Control Kind":"Button"}.

 

Clé

Valeur

Défaut

Control Kind

"Label"|"Button"

Valeur obligatoire

Text Size

"small"|"medium"|"large"

"medium"

Unit

"px"|"dp"|"sp"|"". Voir Tailles : Pixels, DPI, DP, SP.

"px"

Bold Text

true| false()

"false"

Italic Text

true| false()

"false"

Underline Text

true| false()

"false"

Image Bouton

Une des options Image de bouton (par exemple, + ou - ou > ou Share

Aucun

Arrière-plan de la touche

"transparent"|"not_transparent"

"not_transparent"

 

 

L’argument Parameters est un map key-value qui définit les propriétés de la commande. Les clés disponibles et leurs valeurs sont regroupées ci-dessous. L’entier qui est retourné est la largeur minimum, en pixels, de la commande lorsque le string Text soumis (premier paramètre) est affiché avec les propriétés spécifiées dans l’argument Parameters. Cette valeur peut ensuite être utilisée pour calculer et spécifier d’autres propriétés liées à la commande, comme les largeurs des colonnes de table dans laquelle la commande apparaît.

 

La valeur retournée et la variable "MT_MeasureControls"

L’action retourne une séquence de nombres, qui est automatiquement stockée dans la variable MT_MeasureControls. Vous pouvez utiliser MT_MeasureControls dans les expressions XPath des actions. Puisque les items dans la séquence retournée sont des nombres, vous pouvez utiliser la fonction max() pour découvrir la largeur de commande la plus grande (par exemple : max(MT_MeasureControls)). Une autre fonction utile est la fonction serialize(), qui peut être utilisée pour afficher la séquence complète.

 

Points à noter

Veuillez noter les points suivants :

 

Pour chaque action, vous pouvez découvrir les largeurs d’un seul type de commande. Pour découvrir les largeurs d’un autre type de commande, appeler l’action une deuxième fois avec une nouvelle valeur de paramètre Control Kind.

Cette action permet la même fonctionnalité que la fonction mt-control-width(). Une différence essentielle est que la fonction ne peut pas être utilisée pour un rendu client web, alors que l’action peut être utilisée pour les clients web.

 

Fonctions d'extension de MobileTogether

MobileTogether fournit une série de fonctions d'extension XPath qui ont été créées spécifiquement pour l'utilisation dans les designs MobileTogether. Quelques fonctions peuvent être particulièrement utiles avec des actions spécifiques. Par exemple, mt-available -languages() renvoie les langues dans lesquelles la solution est disponible et pourrait, par exemple, être utilisée avec l'action Boîte de messages. Si une fonction est particulièrement pertinente pour cette action, elle se trouvera dans la liste ci-dessous. Pour une liste complète de ces fonctions d'extension et leurs descriptions, voir la page <Fonctions d'extension MobileTogether.

© 2017-2023 Altova GmbH