Работа с атрибутами - История изменений

Aleksandr Dragunkin в 13:38, 20 февраля 2025

2025-02-20T13:38:21Z

← Предыдущая версия		Версия от 16:38, 20 февраля 2025
Строка 1:		Строка 1:
	[[Category:Макро]]		[[Category:Макро]]
	{{Макро}}		{{Макро}}
	----		----{{Идея\|Атрибутом в системе K3 называется дополнительная негеометрическая информация об объекте. Каждый объект может содержать один или несколько атрибутов, а может не содержать их вовсе.}}
	~~Атрибутов~~ в системе ~~'''~~K3~~'''~~ называется дополнительная негеометрическая информация об объекте. Каждый объект может содержать один или несколько атрибутов, а может не содержать их вовсе. Сам атрибут можно условно разделить на две составляющие:		Сам атрибут можно условно разделить на две составляющие:

	* Шаблон атрибута. Он определяет характеристики той негеометрической информации, которую содержит объект.		* Шаблон атрибута. Он определяет характеристики той негеометрической информации, которую содержит объект.

Aleksandr Dragunkin в 13:34, 19 февраля 2025

2025-02-19T13:34:07Z

← Предыдущая версия		Версия от 16:34, 19 февраля 2025
Строка 91:		Строка 91:
	Дополнительные ключи задают перечисляемость атрибута (<code>enum<nowiki> [</nowiki>on\|off]</code>) и значение по умолчанию (<code>default ''<Value>''</code>).		Дополнительные ключи задают перечисляемость атрибута (<code>enum<nowiki> [</nowiki>on\|off]</code>) и значение по умолчанию (<code>default ''<Value>''</code>).

	~~Пример:~~		{{macro\|
			<syntaxhighlight lang="c">
	attribute create "Super" "Суперподсказка" string 10 20		attribute create "Super" "Суперподсказка" string 10 20
	enum on default "Пустота" done;		enum on default "Пустота" done;
			</syntaxhighlight >
			}}
			{{python\|
			<syntaxhighlight lang="python">
			k3.attribute(k3.k_create, "Super", "Суперподсказка", k3.k_string, 10, 20,
			k3.k_enum, k3.k_on, k3.k_default, "Пустота", k3.k_done)
			</syntaxhighlight >
			}}

	<code>'''attribute edit''' ''<Name> <Params>''</code>		<code>'''attribute edit''' ''<Name> <Params>''</code>
Строка 236:		Строка 244:
	Без указания владельца <code>''<Holder>''</code>, может использоваться сценариями группового выбора в выражении, задающем условие выбора по атрибутам.		Без указания владельца <code>''<Holder>''</code>, может использоваться сценариями группового выбора в выражении, задающем условие выбора по атрибутам.

	~~Пример:~~		{{macro\|
			<syntaxhighlight lang="c">
	select attribute “IsAssign(\”posit\”)”		select attribute “IsAssign(\”posit\”)”
			</syntaxhighlight>
			}}
	===IsValue===		===IsValue===
	<code>LOGICAL '''IsValue'''(STRING ''<Name>''<nowiki> [,VARIANT </nowiki>''<Holder>''])</code>		<code>LOGICAL '''IsValue'''(STRING ''<Name>''<nowiki> [,VARIANT </nowiki>''<Holder>''])</code>
Строка 252:		Строка 262:
	Без указания владельца <code>''<Holder>''</code>, может использоваться сценариями группового выбора в выражении, задающем условие выбора по атрибутам.		Без указания владельца <code>''<Holder>''</code>, может использоваться сценариями группового выбора в выражении, задающем условие выбора по атрибутам.

	~~Пример:~~		{{macro\|
			<syntaxhighlight lang="c">
	select attribute “IsValue(\”posit\”)”		select attribute “IsValue(\”posit\”)”
			</syntaxhighlight>
			}}
	===GetAttr===		===GetAttr===
	<code>VARIANT '''GetAttr'''(VARIANT ''<Holder>'', STRING ''<Name>'', VARIANT ''<Defvalue>'')</code>		<code>VARIANT '''GetAttr'''(VARIANT ''<Holder>'', STRING ''<Name>'', VARIANT ''<Defvalue>'')</code>

Aleksandr Dragunkin в 13:19, 19 февраля 2025

2025-02-19T13:19:33Z

← Предыдущая версия		Версия от 16:19, 19 февраля 2025
Строка 297:		Строка 297:

	Функция копирует значение атрибута <code>''<AttrNameSrc>''</code> в атрибут <code>''<AttrNameDst></code> ''у всех объектов всех уровней и возвращает количество обработанных объектов или '''-1''', если произошла ошибка.		Функция копирует значение атрибута <code>''<AttrNameSrc>''</code> в атрибут <code>''<AttrNameDst></code> ''у всех объектов всех уровней и возвращает количество обработанных объектов или '''-1''', если произошла ошибка.
	{{Внимание\|'''Функция реализована пока только для числовых атрибутов.'''		{{Внимание\|'''Функция attrcopy реализована пока только для числовых атрибутов.'''
	}}		}}

Aleksandr Dragunkin в 13:18, 19 февраля 2025

2025-02-19T13:18:47Z

← Предыдущая версия		Версия от 16:18, 19 февраля 2025
Строка 331:		Строка 331:
	:'''0''' — Прочие виды ошибок		:'''0''' — Прочие виды ошибок

	{~~\| class="prettytable"~~		{{Примечание\|''Для чтения значений атрибутов у объекта, находящегося внутри группы, используются обычные функции работы с атрибутами.''
	\|-		}}
	~~\|valign="top"\|[[image:i.png]]~~
	\|''Для чтения значений атрибутов у объекта, находящегося внутри группы, используются обычные функции работы с атрибутами.''
	\|}
	----		----
	{{Макро}}		{{Макро}}

Aleksandr Dragunkin в 13:17, 19 февраля 2025

2025-02-19T13:17:35Z

← Предыдущая версия		Версия от 16:17, 19 февраля 2025
Строка 156:		Строка 156:

	Команда удаляет шаблон атрибута с именем <code>''<Name>''</code> или все пользовательские шаблоны атрибутов (<code>all</code>).		Команда удаляет шаблон атрибута с именем <code>''<Name>''</code> или все пользовательские шаблоны атрибутов (<code>all</code>).
	{~~\| class="prettytable"~~		{{Примечание\|''Команды редактирования и удаления шаблонов атрибутов работают только с пользовательскими атрибутами. В системе '''''K3''''' существует множество системных атрибутов, на которые действие описанных выше команд не распространяется.''
	\|-		}}
	~~\|valign="top"\|[[image:i.png]]~~		{{Примечание\|''В командах работы с атрибутами может присутствовать ключ ''<code>list</code>'' (список), который позволяет работать с атрибутами посредством диалоговых окон. В макропрограммах удобнее работать с атрибутами из командной строки.''
	\|''Команды редактирования и удаления шаблонов атрибутов работают только с пользовательскими атрибутами. В системе '''''K3''''' существует множество системных атрибутов, на которые действие описанных выше команд не распространяется.''		}}
	\|}
	{~~\| class="prettytable"~~
	\|-
	~~\|valign="top"\|[[image:i.png]]~~
	\|''В командах работы с атрибутами может присутствовать ключ ''<code>list</code>'' (список), который позволяет работать с атрибутами посредством диалоговых окон. В макропрограммах удобнее работать с атрибутами из командной строки.''
	\|}
	[[Файл:Attribute_delete.png\|thumb\|center\|600px\|Удаление атрибута из диалогового окна]]		[[Файл:Attribute_delete.png\|thumb\|center\|600px\|Удаление атрибута из диалогового окна]]

Строка 303:		Строка 297:

	Функция копирует значение атрибута <code>''<AttrNameSrc>''</code> в атрибут <code>''<AttrNameDst></code> ''у всех объектов всех уровней и возвращает количество обработанных объектов или '''-1''', если произошла ошибка.		Функция копирует значение атрибута <code>''<AttrNameSrc>''</code> в атрибут <code>''<AttrNameDst></code> ''у всех объектов всех уровней и возвращает количество обработанных объектов или '''-1''', если произошла ошибка.
	{~~\| class="prettytable"~~		{{Внимание\|'''Функция реализована пока только для числовых атрибутов.'''
	\|-		}}
	~~\|valign="top"\|[[image:eksklamacia.png]]~~
	\|'''Функция реализована пока только для числовых атрибутов.'''
	\|}

	===AttrNmScan===		===AttrNmScan===

Aleksandro: Замена текста — « » на « »

2024-06-27T13:22:11Z

Замена текста — « » на « »

← Предыдущая версия		Версия от 16:22, 27 июня 2024
Строка 4:		Строка 4:
	Атрибутов в системе '''K3''' называется дополнительная негеометрическая информация об объекте. Каждый объект может содержать один или несколько атрибутов, а может не содержать их вовсе. Сам атрибут можно условно разделить на две составляющие:		Атрибутов в системе '''K3''' называется дополнительная негеометрическая информация об объекте. Каждый объект может содержать один или несколько атрибутов, а может не содержать их вовсе. Сам атрибут можно условно разделить на две составляющие:

	* Шаблон атрибута. Он определяет характеристики той негеометрической информации, которую содержит объект.		* Шаблон атрибута. Он определяет характеристики той негеометрической информации, которую содержит объект.
	* Значение атрибута. Оно определяет величину, значение той информации, которая задана шаблоном атрибута.		* Значение атрибута. Оно определяет величину, значение той информации, которая задана шаблоном атрибута.

	Атрибуты в '''K3''' бывают следующих типов:		Атрибуты в '''K3''' бывают следующих типов:

	* Строковый;		* Строковый;
	* Числовой;		* Числовой;
	* Логической;		* Логической;
	* Текстовый.		* Текстовый.

	Тип того или иного атрибута задается шаблоном атрибута и определяет возможные значения этого атрибута.		Тип того или иного атрибута задается шаблоном атрибута и определяет возможные значения этого атрибута.
Строка 18:		Строка 18:
	Команды работы с атрибутами можно условно разделить на два класса		Команды работы с атрибутами можно условно разделить на два класса

	* Работа с шаблонами атрибутов		* Работа с шаблонами атрибутов
	* Работа со значениями атрибутов		* Работа со значениями атрибутов

	Шаблон атрибута един для всех объектов системы. Сам же атрибут у каждого объекта может иметь свое значение, а может быть не присвоен объекту вовсе.		Шаблон атрибута един для всех объектов системы. Сам же атрибут у каждого объекта может иметь свое значение, а может быть не присвоен объекту вовсе.
Строка 173:		Строка 173:


	<code>'''attrobj attach''' { all \| <Name1>, <Name2>, …, <NameN> done \| record } [partly\|wholly] <Obj> <Value1>, <Value2>, …, <ValueN></code>		<code>'''attrobj attach''' { all \| <Name1>, <Name2>, …, <NameN> done \| record } [partly\|wholly] <Obj> <Value1>, <Value2>, …, <ValueN></code>

	Команда присваивает объекту <code>''<Obj>''</code> атрибуты с именами <code>''<Name1></code>'', <code>''<Name2>''</code>, …, <code>''<NameN>''</code> и значениями <code>''<Value1></code>, <code><Value2></code>, …, <code><ValueN>''</code>. Ключ <code>all</code> позволяет присвоить все имеющиеся атрибуты. Ключ <code>record</code> позволяет получить список атрибутов для присвоения из рабочей записи. В качестве объекта <code>''<Obj>''</code> может выступать объект '''K3 '''(<code>''<Object>''</code>), несколько объектов (<code>group'' <Objects></code>)'', рабочая запись (<code>record</code>), блок (<code>block'' <Name>''</code>).		Команда присваивает объекту <code>''<Obj>''</code> атрибуты с именами <code>''<Name1></code>'', <code>''<Name2>''</code>, …, <code>''<NameN>''</code> и значениями <code>''<Value1></code>, <code><Value2></code>, …, <code><ValueN>''</code>. Ключ <code>all</code> позволяет присвоить все имеющиеся атрибуты. Ключ <code>record</code> позволяет получить список атрибутов для присвоения из рабочей записи. В качестве объекта <code>''<Obj>''</code> может выступать объект '''K3 '''(<code>''<Object>''</code>), несколько объектов (<code>group'' <Objects></code>)'', рабочая запись (<code>record</code>), блок (<code>block'' <Name>''</code>).
Строка 213:		Строка 213:
	Функция возвращает тип атрибута c именем ''<Name>'':		Функция возвращает тип атрибута c именем ''<Name>'':

	:'''1''' — Строка текста;		:'''1''' — Строка текста;
	:'''2''' — Числовой;		:'''2''' — Числовой;
	:'''3''' — Логический;		:'''3''' — Логический;
	:'''4''' — Многострочный текст;		:'''4''' — Многострочный текст;
	:'''0''' — Атрибут не определен		:'''0''' — Атрибут не определен

	===IsAttrDef===		===IsAttrDef===
Строка 226:		Строка 226:
	Функция возвращает		Функция возвращает

	:'''1''' — атрибут определен,		:'''1''' — атрибут определен,
	:'''0''' — атрибут не определен.		:'''0''' — атрибут не определен.

	===IsAssign===		===IsAssign===
Строка 236:		Строка 236:
	Необязательный параметр <code>''<Holder>''</code> может быть одним из следующих типов:		Необязательный параметр <code>''<Holder>''</code> может быть одним из следующих типов:

	* <code>OBJECT</code> — владелец — указанный объект;		* <code>OBJECT</code> — владелец — указанный объект;
	* <code>STRING</code> — владелец — блок с именем заданным строкой <code>''<Holder>''</code>;		* <code>STRING</code> — владелец — блок с именем заданным строкой <code>''<Holder>''</code>;
	* <code>INT</code> — владелец — рабочая запись.		* <code>INT</code> — владелец — рабочая запись.

	Без указания владельца <code>''<Holder>''</code>, может использоваться сценариями группового выбора в выражении, задающем условие выбора по атрибутам.		Без указания владельца <code>''<Holder>''</code>, может использоваться сценариями группового выбора в выражении, задающем условие выбора по атрибутам.
Строка 252:		Строка 252:
	Необязательный параметр <code>''<Holder>''</code> может быть одним из следующих типов:		Необязательный параметр <code>''<Holder>''</code> может быть одним из следующих типов:

	* <code>OBJECT</code> — '''владелец''' — указанный объект;		* <code>OBJECT</code> — '''владелец''' — указанный объект;
	* <code>STRING</code> — '''владелец''' — блок с именем заданным строкой <code>''<Holder>''</code>;</code>		* <code>STRING</code> — '''владелец''' — блок с именем заданным строкой <code>''<Holder>''</code>;</code>
	* <code>INT</code> — '''владелец''' — рабочая запись.		* <code>INT</code> — '''владелец''' — рабочая запись.

Aleksandro: Замена текста — « - » на « — »

2024-06-26T13:12:05Z

Замена текста — « - » на « — »

← Предыдущая версия		Версия от 16:12, 26 июня 2024
Строка 236:		Строка 236:
	Необязательный параметр <code>''<Holder>''</code> может быть одним из следующих типов:		Необязательный параметр <code>''<Holder>''</code> может быть одним из следующих типов:

	* <code>OBJECT</code> — владелец - указанный объект;		* <code>OBJECT</code> — владелец — указанный объект;
	* <code>STRING</code> — владелец - блок с именем заданным строкой <code>''<Holder>''</code>;		* <code>STRING</code> — владелец — блок с именем заданным строкой <code>''<Holder>''</code>;
	* <code>INT</code> — владелец - рабочая запись.		* <code>INT</code> — владелец — рабочая запись.

	Без указания владельца <code>''<Holder>''</code>, может использоваться сценариями группового выбора в выражении, задающем условие выбора по атрибутам.		Без указания владельца <code>''<Holder>''</code>, может использоваться сценариями группового выбора в выражении, задающем условие выбора по атрибутам.

Aleksandro: /* Функции работы с атрибутами в группе */

2024-03-28T14:28:34Z

Функции работы с атрибутами в группе

← Предыдущая версия		Версия от 17:28, 28 марта 2024
Строка 326:		Строка 326:
	Функция '''SetAttrValG''' присваивает атрибуту с именем <code>''<Name>''</code> у объекта <code>''<Obj>''</code>, входящего в состав группы значение <code>''<Value>''</code>. Функция возвращает:		Функция '''SetAttrValG''' присваивает атрибуту с именем <code>''<Name>''</code> у объекта <code>''<Obj>''</code>, входящего в состав группы значение <code>''<Value>''</code>. Функция возвращает:

	:'''1''' - Значение присвоено;		:'''1''' — Значение присвоено;
	:'''2''' - У данного объекта <code>''<Obj>''</code> нет атрибута с именем <code>''<Name>''</code>;		:'''2''' — У данного объекта <code>''<Obj>''</code> нет атрибута с именем <code>''<Name>''</code>;
	:'''3''' - Несоответствие типов. Тип атрибута с именем <code>''<Name>''</code> отличается от типа <code>''<Value>''</code>;		:'''3''' — Несоответствие типов. Тип атрибута с именем <code>''<Name>''</code> отличается от типа <code>''<Value>''</code>;
	:'''0''' - Прочие виды ошибок		:'''0''' — Прочие виды ошибок


Строка 336:		Строка 336:
	Функция '''DelAttrValG''' удаляет атрибут с именем <code>''<Name>''</code> у объекта <code>''<Obj>''</code>. Функция возвращает:		Функция '''DelAttrValG''' удаляет атрибут с именем <code>''<Name>''</code> у объекта <code>''<Obj>''</code>. Функция возвращает:

	:'''1''' - Удаление прошло успешно;		:'''1''' — Удаление прошло успешно;
	:'''2''' - У данного объекта <code>''<Obj>''</code> нет атрибута с именем <code>''<Name>''</code>;		:'''2''' — У данного объекта <code>''<Obj>''</code> нет атрибута с именем <code>''<Name>''</code>;
	:'''0''' - Прочие виды ошибок		:'''0''' — Прочие виды ошибок

	{\| class="prettytable"		{\| class="prettytable"

Aleksandro: /* GetAttr */

2024-03-28T14:23:12Z

GetAttr

← Предыдущая версия		Версия от 17:23, 28 марта 2024
Строка 268:		Строка 268:
	Необязательный параметр <code>''<Holder>''</code> может быть одним из следующих типов:		Необязательный параметр <code>''<Holder>''</code> может быть одним из следующих типов:

	* <code>OBJECT</code> - владелец — указанный объект;		* <code>OBJECT</code> — '''владелец''' — указанный объект;
	* <code>STRING</code> - владелец — блок с именем, заданным строкой <code>''<Holder>''</code>;		* <code>STRING</code> — '''владелец''' — блок с именем, заданным строкой <code>''<Holder>''</code>;
	* <code>INT</code> - владелец — рабочая запись.		* <code>INT</code> — '''владелец''' — рабочая запись.

	===GetAttrText===		===GetAttrText===

Aleksandro: /* GetAttr */

2024-03-28T14:21:47Z

GetAttr

← Предыдущая версия		Версия от 17:21, 28 марта 2024
Строка 281:		Строка 281:
	Для атрибутов других типов возвращает ноль.		Для атрибутов других типов возвращает ноль.

	* <code>OBJECT</code> - владелец — указанный объект;		* <code>OBJECT</code> — '''владелец''' — указанный объект;
	* <code>STRING</code> - владелец — блок с именем заданным строкой <code>''<Holder>''</code>;		* <code>STRING</code> — '''владелец''' — блок с именем заданным строкой <code>''<Holder>''</code>;
	* <code>INT</code> - владелец — рабочая запись.		* <code>INT</code> — '''владелец''' — рабочая запись.

	Если вместо имени массива <code>''<S>''</code> указана строковая переменная <code>''<ArrayName>''</code>, то создается массив с таким именем и заполняется строками текстового атрибута. Размерность массива в этом случае равна количеству строк в текстовом атрибуте.		Если вместо имени массива <code>''<S>''</code> указана строковая переменная <code>''<ArrayName>''</code>, то создается массив с таким именем и заполняется строками текстового атрибута. Размерность массива в этом случае равна количеству строк в текстовом атрибуте.