Различия

Показаны различия между двумя версиями страницы.

--- ru:skin:gui:keywords [2015/06/30 14:33]
Роман
+++ ru:skin:gui:keywords [2016/10/26 14:53] (текущий)
Konstantin Goncharik
@@ Строка 1: / Строка 1: @@
 ====== Ключевые слова ======
-Ключевые слова обозначают заданные в программе значения, которые изменяются со временем. Некоторые из них являются глобальными и могут использоваться в любом месте скина, другие – только в определённых окнах или списках. Ключевые слова можно задавать в тексте меток, кнопок и флажков, в атрибуте state кнопки, атрибуте value индикатора прогресса и в атрибуте tags любых объектов. Ключевые слова начинаются с символа “%” (в tags необязательно).
+Ключевые слова обозначают заданные в программе значения, которые изменяются со временем. Некоторые из них являются глобальными и могут использоваться в любом месте скина, другие --- только в определённых окнах или списках. Ключевые слова можно задавать в тексте меток, кнопок и флажков, в атрибуте ''state'' кнопки, атрибуте ''value'' индикатора прогресса и в атрибуте ''tags'' любых объектов. Ключевые слова начинаются с символа ''%'' (в ''tags'' необязательно).
-Ключевые слова могут быть текстовыми и числовыми (некоторые имеют и текстовое, и числовое значение). Текстовое значение используется в атрибуте text, а числовое – в атрибутах state, value и tags. Числовое значение текстового ключевого слова равно 0, если текстовое значение пустое, и 1 в противном случае.
+Ключевые слова могут быть текстовыми и числовыми (некоторые имеют и текстовое, и числовое значение). Текстовое значение используется в атрибуте ''text'', а числовое --- в атрибутах ''state'', ''value'' и ''tags''. Числовое значение текстового ключевого слова равно 0, если текстовое значение пустое, и 1 в противном случае.
 При использовании ключевых слов в тексте объектов можно указать несколько вариантов и условия, определяющие выбор одного из вариантов. Для этого используется следующий синтаксис:
@@ Строка 8: / Строка 10: @@
 Текст, заданный в кавычках, выводится, если задано значение всех ключевых слов, указанных в скобках. Если скобки со списком ключевых слов отсутствуют, текст выводится, если задано значение хотя бы одного ключевого слова, содержащегося в нём. Разные варианты разделяются точкой с запятой. Варианты рассматриваются слева направо до тех пор, пока не будет найден вариант, условия которого выполняются. Могут использоваться как двойные, так и одинарные кавычки. Текст может содержать вложенные выражения. Если в тексте присутствуют ключевые слова, разделённые пробелами и запятыми, то эти разделители не выводятся, если значения соответствующих ключевых слов не заданы.
 Например:
-{"%nextRoadTitle"; "%nextRoadType{" – %nextRoadDirection"}"}
+<code>{"%nextRoadTitle"; "%nextRoadType{" – %nextRoadDirection"}"}</code>
-Здесь выводится наименование улицы, а если оно не задано – тип и, если есть, направление.
+Здесь выводится наименование улицы, а если оно не задано --- тип и, если есть, направление.
-{"%street, %house"(%street, %house); "%label"; "%city"}
+<code>{"%street, %house"(%street, %house); "%label"; "%city"}</code>
-Здесь, если заданы улица и дом, выводятся улица и дом, иначе, если есть подпись, выводится подпись, иначе город
+Здесь, если заданы улица и дом, выводятся улица и дом, иначе, если есть подпись, выводится подпись, иначе город.
-При задании ключевого слова в атрибуте state кнопки её состояние становится равным числовому значению ключевого слова. Для каждого состояния кнопки может быть задан свой текст и картинка.
-Ключевые слова можно использовать для изменения видимости объектов. Для этого в атрибуте tags объекта указывается через точку с запятой список ключевых слов, значения которых должны быть ненулевыми, чтобы объект был виден на экране. Если, наоборот, объект должен быть виден, когда значение ключевого слова равно нулю, перед ключевым словом ставится знак “!”.
+При задании ключевого слова в атрибуте ''state'' кнопки её состояние становится равным числовому значению ключевого слова. Для каждого состояния кнопки может быть задан свой текст и картинка.
+Ключевые слова можно использовать для изменения видимости объектов. Для этого в атрибуте ''tags'' объекта указывается через точку с запятой список ключевых слов, значения которых должны быть ненулевыми, чтобы объект был виден на экране. Если, наоборот, объект должен быть виден, когда значение ключевого слова равно нулю, перед ключевым словом ставится знак ''!''.
 ===== Глобальные ключевые слова =====
@@ Строка 20: / Строка 26: @@
   * addondsUpdate – 1, если доступны обновления дополнений.
   * battery – состояние батареи: 0 – заряд меньше 25%, 1 – заряд от 25 до 50%, 2 – заряд от 50 до 75%, 3 – заряд от 75 до 100%, 4 – идёт зарядка батареи или состояние не известно.
+  * compass – содержит значение 1, если необходимо показывать компас, и 0 в противном случае.
   * currentRoadDirection – направление текущей дороги.
   * currentRoadTitle – наименование текущей дороги.
@@ Строка 27: / Строка 34: @@
   * finishTime – время приезда к финишу.
   * finishTimeLeft – время до финиша.
+  * glideRatio -- отношение горизонтальной скорости к вертикальной.
   * goalDistance – расстояние до цели.
   * goalTime – время приезда к цели.
@@ Строка 46: / Строка 54: @@
   * nextSpeedLimit – следующее ограничение скорости. Текстовое значение содержит значение скорости. Числовое значение равно 1, если активен индикатор изменения ограничения, и 0 в противном случае.
   * nextSpeedLimitDist – расстояние до следующего ограничения скорости.
+  * planningRoute -- информация о прокладке маршрута. Числовое значение равно 1, если идёт прокладка маршрута, и 0 в противном случае. Текстовое значение равно "1", если идёт прокладка маршрута, и "" в противном случае.
   * poiViewMode - режим отображения ''POI'' на карте (0 - скрывать все, 1 - использовать фильтр, 2 - показывать все).
+  * ''premium'' --- признак активированной премиум-версии.
   * route – 1, если проложен или прокладывается маршрут, и 0 в противном случае.
   * secondTurn – 1, если активен индикатор второго манёвра, и 0 в противном случае.
@@ Строка 61: / Строка 71: @@
   * turnDistance – расстояние до манёвра.
   * turnTime – время до манёвра.
+  * vertSpeed -- вертикальная скорость.
   * writeTrack -- содержит значение 1, если нужно писать трек, и 0 в противном случае.
 ===== Ключевые слова в окнах с картой =====
+  * azimuth -- направление движения.
   * cursor – информация о курсоре. Числовое значение равно 1, если на карте установлен курсор, и 0 в противном случае. Текстовое значение содержит наименование выбранного объекта.
   * gps – 1, если доступна информация о местоположении или установлена точка старта, и 0 в противном случае.
@@ Строка 74: / Строка 85: @@
   * manual – 1, если карта не привязана к «машинке», пользователь взаимодействует с экраном, и 0 в противном случае.
   * 3D – 1, если карта находится в 3D-режиме, и 0 в противном случае.
-===== Ключевые слова на поисковой карте =====
-  * entireRoute – 1, если активен режим отображения всего маршрута, и 0 в противном случае.
-  * entryPoints – 1, активен режим выбора точек подъезда.
 ===== Ключевые слова в окнах с дополнениями =====
-  * addonSize – размер дополнения в распакованном виде.
+  * addonSize --- размер дополнения в распакованном виде.
-  * address1, address2, address3, address4 – административный адрес карт, содержащихся в дополнении.
+  * address1, address2, address3, address4 --- административный адрес карт, содержащихся в дополнении.
-  * description – описание дополнения (только в окне AddonDescForm).
+  * description --- описание дополнения (только в окне AddonDescForm).
-  * localDate – дата дополнения, которое загружено на диск.
+  * localDate --- дата дополнения, которое загружено на диск.
-  * progress – прогресс загрузки/распаковки дополнения. Может использоваться в атрибутах text (label, button) и value (progressBar).
+  * products --- требуется ли оплата. Числовое значение: 0 --- не требуется, 1 --- требуется. Текстовое значение: «» --- не требуется, «1» --- требуется.
-  * provider – наименование поставщика дополнения.
+  * progress --- прогресс загрузки/распаковки дополнения. Может использоваться в атрибутах text (label, button) и value (progressBar).
-  * serverDate – дата дополнения на сервере.
+  * provider --- наименование поставщика дополнения.
-  * state – состояние дополнения. Может использоваться в атрибутах text (label, button) и state (button). В последнем случае принимает следующие значения:
+  * serverDate --- дата дополнения на сервере.
-    * 0 – не скачивалось;
+  * state --- состояние дополнения. Может использоваться в атрибутах text (label, button) и state (button). В последнем случае принимает следующие значения:
-    * 1 – идет загрузка;
+    * 0 --- не скачивалось;
-    * 2 – распаковывается;
+    * 1 --- идет загрузка;
-    * 3 – ошибка (загрузки или распаковки);
+    * 2 --- распаковывается;
-    * 4 – готово к использованию;
+    * 3 --- ошибка (загрузки или распаковки);
-    * 5 – доступно обновление;
+    * 4 --- готово к использованию;
-    * 6 – пауза;
+    * 5 --- доступно обновление;
-  * title – наименование дополнения.
+    * 6 --- пауза;
-  * zipSize – размер дополнения в запакованном виде.
+  * title --- наименование дополнения.
+  * zipSize --- размер дополнения в запакованном виде.
-===== Ключевые слова в окнах с подписками =====
+===== Ключевые слова в окнах с покупками =====
-  * title – наименование подписки.
+  * ''active'' --- 1, если продукт куплен и "действует".
-  * price – стоимость подписки.
+  * ''canceled'' --- 1, если подписка на продукт отменена, но ещё действует.
-  * description – описание подписки.
+  * ''canPurchase'' --- 1, если продукт можно купить.
-  * comment – комментарий.
+  * ''comment'' --- комментарий.
-  * purchaseDate – дата покупки подписки.
+  * ''description'' --- описание продукта.
-  * state – состояние подписки. Числовое значение:
+  * ''premiumProduct'' --- 1, если продукт активирует премиум-версию.
-    * 0 – не активна;
+  * ''price'' --- стоимость продукта.
-    * 1 – активна;
+  * ''purchaseDate'' --- дата покупки.
-    * 2 – отменена.
+  * ''title'' --- наименование продукта.
-  * subs – требуется ли подписка. Числовое значение: 0 – не требуется, 1 – требуется. Текстовое значение: «» – не требуется, «1» – требуется.
 ===== Ключевые слова в списках =====

Navikey Wiki Pages

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы