Объект OLE - Revision history

Admin: 1 revision imported

2022-11-18T09:41:51Z

1 revision imported

1>Admin: /* Атрибуты и функции */

2022-10-27T21:37:54Z

‎Атрибуты и функции

Admin: 1 revision imported

2022-03-13T10:11:14Z

1 revision imported

1>Admin at 10:34, 2 March 2022

2022-03-02T10:34:51Z

Admin: 1 revision imported

2021-03-04T14:58:36Z

1 revision imported

Admin at 11:17, 4 March 2021

2021-03-04T11:17:25Z

Admin: 1 revision imported

2021-02-07T06:55:23Z

1 revision imported

Admin at 10:13, 2 January 2021

2021-01-02T10:13:21Z

New page

{{infobox object
|object=OLE
|status=2
|create=[[List.Create|Create]]}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]}}
Объект '''OLE''' (''Object Linking and Embedding'') позволяет получить доступ к функциям операционной системы и других программ из программных модулей клиента, если эти программы поддерживают интерфейс ''COM'' (Component Object Model). Microsoft создали достаточно много терминов для OLE-объектов: ''OLE'', ''COM'', ''OCX'', ''ActiveX'', все они в каком-то роде означают один и тот же способ работы с внешними объектами. Самый большой минус такого способа работы заключается в том, что OLE-сервер не может контролировать время исполнения методов объектов. Это может привести к тому, что если в методе OLE-объекта есть ошибка, и метод зависнет или выдаст на экран модальное сообщение, OLE вызов никогда не вернет управление программе. Для визуального клиента это имеет меньшее значение, так как пользователь сможет перезапустить программу, однако, для консольных клиентов это весьма опасно, поэтому для консольных клиентов рекомендуется использовать функции [[Функции общего назначения#Объект сторожевого пса|сторожевого пса]].

На данный момент система работает с ''COM'' интерфейсом в режиме STA (Single-Threaded Apartment). Это означает, что объект, созданный в одном потоке, не может быть доступен в других потоках. Windows позволяет вызов методов из других потоков, но это происходит с помощью стандартной очереди сообщений Windows, что идеально подходит для визуальный объектов, созданных в основном потоке системы, однако, неудобно для объектов, созданных в рабочих потоках, так как в рабочих потоках отсутствует обработчик очереди сообщений. Это ограничение можно обойти, создав OLE-объект в особом режиме. Ниже даны возможные режимы использования OLE-объектов в программных модулях или обработчиках событий:
* Режим ''STA'' (однопоточный режим). OLE-объекты, созданные таким образом, делятся на две категории:
** Визуальные OLE-объекты, находящиеся на формах или в электронных таблицах. Такие объекты позволяют вызовы из разных потоков, так как визуальный поток обрабатывает сообщения из очереди сообщений. Вызовы из других потоков для этой категории объектов будут обладать такими же минусами, как и вызовы к объектам, созданным в режиме "центрального потока" (см. ниже).
** OLE-объекты, созданные программно. Методы таких объектов не могут быть вызваны из других потоков (только из потока, где эти объекты были созданы). Зачастую такие объекты создаются, чтобы выполнить определенную работу, и после этого удаляются, поэтому, это не вызывает проблем в работе.
* Режим исполнения центрального потока. OLE-объекты создаются с помощью функции [[CreateThreadedOLE]] в специально выделенном для этого потоке, который в дальнейшем обслуживает все обращения из других потоков. Обращения происходят не с помощью использования стандартной очереди сообщений Windows, а с помощью более быстрой межпоточной синхронизации. Однако, так как все OLE-объекты, созданные в системе таким образом, обслуживает только один поток, может получиться ситуация (особенно с консольными серверами), когда выполнение вызова к объекту будет задержано, пока выполняется вызов из другого потока. В визуальных клиентах, где количество одновременно работающих потоков мало, это не будет являться реальным ограничением.
* Режим исполнения индивидуального потока. Данный режим, который пока не создан, и необходимость в котором рассматривается, будет позволять для каждого созданного OLE-объекта иметь свой собственный поток исполнения методов. Минусами такого режима, может стать большое потребление ресурсов системы, однако, в случаях, когда объектов в системе немного, а вызовы к ним занимают продолжительное время, этот режим мог бы быть полезен.

В системе OLE-объекты могут присутствовать:
* Объекты, созданные программно [[CreateOLE]]
* Объекты, расположенные на формах. В этом режиме, объект добавляется на форму в момент ее создания в Студии, для таких объектов могут быть заданы визуальные события ''COM''.
* Объекты, внедренные в электронные таблицы. Такие объекты также можно добавлять программно или при копировании частей таблицы с помощью функций типа [[Table.CopyByX|CopyByX]].

== Атрибуты и функции==
{{function header}}
{{function entry
|name=[[CreateOLE]]
|form='''CreateOLE'''(''<Идентификатор объекта OLE (STRING)>''):''<Новый объект OLE (OLE)>''
|type=1
|status=2
|visual=0
|description=Функция создает новый объект OLE (COM) по строке идентификатора
}}
{{function entry
|name=[[CreateThreadedOLE]]
|form='''CreateThreadedOLE'''(''<Идентификатор объекта OLE (STRING)>''):''<Новый объект OLE (OLE)>''
|type=1
|status=2
|visual=0
|description=Функция создает новый объект OLE (COM) по строке идентификатора. Объект может быть доступен в любом потоке, не только в том, который создал объект. Вызовы к таким объектам осуществляются несколько медленнее.
}}
{{function entry
|name=[[OLE.SetTimeout|SetTimeout]]
|form={{Grey|OLE.}}'''SetTimeout'''({{Optional|<Время ожидания исполнения команд в мс. (INT)>}}):''<Предыдущее время ожидания исполнения команд в мс. (INT)>''
|type=1
|status=0
|visual=0
|description=Функция задает или получает для объекта максимальное время ожидания исполнения команд. По умолчанию при создании объекта, это время равно 0 (не ограничено). При истечении времени ожидания система произведет отсоединение от текущего OLE-объекта и выполнявшаяся функция вызовет исключение.
}}
{{function entry
|name=[[OLE.SetEventHandler|SetEventHandler]]
|form={{Grey|OLE.}}'''SetEventHandler'''(''<Имя события OLE объекта (STRING)>'',''<Имя функции-обработчика события (STRING)>''{{Optional|,<Тип вызова события (INT)>{{Default|{{Eq}}0}}}})
|type=1
|status=0
|visual=0
|description=Функция сопоставляет локальную или глобальную функцию с событием OLE-объекта. Исполнение функции может происходить в трех режимах, в зависимости от аргумента ''тип вызова события'': '''0''' (по умолчанию) -- функция будет вызвана, как прерывающее событие в контексте текущей формы (работает только для визуальных форм), '''1''' -- для вызова функции будет создан отдельный поток (как это происходит при вызове функции [[Mutex.ExecuteFunctionInSeparateThread|ExecuteFunctionInSeparateThread]]) (работает для любого контекста, но создание нового потока для часто исполняемых событий может замедлить работу системы), '''2''' -- событие будет помещено в очередь ожидания и будет исполнено в момент вызова функции [[OLE.OLESleep|OLESleep]] (работает для любого контекста).
}}
{{function entry
|name=[[OLE.OLESleep|OLESleep]]
|form={{Grey|OLE.}}'''OLESleep'''(''<Время ожидания появления события (INT)>'')
|type=1
|status=0
|visual=0
|description=Функция ожидает появления OLE события (только для событий, сопоставленных в режиме 2, см. [[OLE.SetEventHandler|SetEventHandler]]). Событие исполняется, если оно ожидает в очереди на начало вызова функции или происходит в течение времени ожидания функции. Событие будет вызвано в текущем потоке и будет иметь доступ ко всем его переменным. При задании аргумента равным нулю, событие будет исполнено, только если оно ожидает в очереди на момент вызова функции, ожидания события не будет.
}}
{{function footer}}

{{Объекты}}

← Older revision	Revision as of 09:41, 18 November 2022
(No difference)

@@ Line 13: / Line 13: @@
 ** Визуальные OLE-объекты, находящиеся на формах или в электронных таблицах. Такие объекты позволяют вызовы из разных потоков, так как визуальный поток обрабатывает сообщения из очереди сообщений. Вызовы из других потоков для этой категории объектов будут обладать такими же минусами, как и вызовы к объектам, созданным в режиме "центрального потока" (см. ниже).
 ** Режим исполнения центрального потока. OLE-объекты создаются с помощью функции [[CreateThreadedOLE]] в специально выделенном для этого потоке, который в дальнейшем обслуживает все обращения из других потоков. Обращения происходят не с помощью использования стандартной очереди сообщений Windows, а с помощью более быстрой межпоточной синхронизации. Однако, так как все OLE-объекты, созданные в системе таким образом, обслуживает только один поток, может получиться ситуация (особенно с консольными серверами), когда выполнение вызова к объекту будет задержано, пока выполняется вызов из другого потока. В визуальных клиентах, где количество одновременно работающих потоков мало, это не будет являться реальным ограничением.
-* Режим ''MTA'' (многопоточный режим). OLE-объекты, созданные программно. Методы таких объектов могут быть вызваны из любых потоков, а не только из потока, где эти объекты были созданы. Не все OLE-объекты полностью поддерживают многопоточность, поэтому, если объект будет использоваться сразу в нескольких потоках (возможно более одного вызова в одно и то же время из разных потоков), необходимо предусмотреть какую-либо систему межпоточной синхронизации (к примеру с помощью функции [[LockObject]]). Чаще всего, однако, такие объекты создаются, чтобы выполнить определенную работу, и после этого удаляются, поэтому, многопоточность не вызывает проблем в работе.
+* Режим ''MTA'' (многопоточный режим). OLE-объекты, созданные программно. Методы таких объектов могут быть вызваны из любых потоков, а не только из потока, где эти объекты были созданы. Не все OLE-объекты полностью поддерживают многопоточность, поэтому, если объект будет использоваться сразу в нескольких потоках (возможно более одного вызова в одно и то же время из разных потоков), необходимо предусмотреть какую-либо систему межпоточной синхронизации (к примеру с помощью функции [[LockObject]]). Чаще всего, однако, такие объекты создаются, чтобы выполнить определенную работу, и после этого удаляются, поэтому, многопоточность не вызывает проблем в работе. Некоторые объекты, не поддерживающие многопоточность, даже если их создавать в режиме MTA, будут работать только потоке, который создал объект (вызовы из других потоков будут вызывать исключения). В этом случае, использование [[CreateThreadedOLE]] уже является необходимостью, если с объектом предполагается работать из нескольких потоков.
 В системе OLE-объекты могут присутствовать:
@@ Line 82: / Line 82: @@
 |visual=0
 |description=Функция создает из объекта системы вспомогательный объект OLEVARIANT с заданным типом данных OLE. Функция может быть вызвана для любого объекта, однако, только следующие объекты имеет смысл превращать в объекты OLE: числа, строки, даты, другие OLE-объекты, списки.
 }}
 {{function entry
@@ Line 106: / Line 122: @@
 |visual=0
 |description=Функция ожидает появления OLE события (только для событий, сопоставленных в режиме 2, см. [[OLE.SetEventHandler|SetEventHandler]]). Событие исполняется, если оно ожидает в очереди на начало вызова функции или происходит в течение времени ожидания функции. Событие будет вызвано в текущем потоке и будет иметь доступ ко всем его переменным. При задании аргумента равным нулю, событие будет исполнено, только если оно ожидает в очереди на момент вызова функции, ожидания события не будет.
 }}
 {{function footer}}

← Older revision	Revision as of 10:11, 13 March 2022
(No difference)

@@ Line 9: / Line 9: @@
 Объект '''OLE''' (''Object Linking and Embedding'') позволяет получить доступ к функциям операционной системы и других программ из программных модулей клиента, если эти программы поддерживают интерфейс ''COM'' (Component Object Model). Microsoft создали достаточно много терминов для OLE-объектов: ''OLE'', ''COM'', ''OCX'', ''ActiveX'', все они в каком-то роде означают один и тот же способ работы с внешними объектами. Самый большой минус такого способа работы заключается в том, что OLE-сервер не может контролировать время исполнения методов объектов. Это может привести к тому, что если в методе OLE-объекта есть ошибка, и метод зависнет или выдаст на экран модальное сообщение, OLE вызов никогда не вернет управление программе. Для визуального клиента это имеет меньшее значение, так как пользователь сможет перезапустить программу, однако, для консольных клиентов это весьма опасно, поэтому для консольных клиентов рекомендуется использовать функции [[Функции общего назначения#Объект сторожевого пса|сторожевого пса]].
-На данный момент система работает с ''COM'' интерфейсом в режиме STA (Single-Threaded Apartment). Это означает, что объект, созданный в одном потоке, не может быть доступен в других потоках. Windows позволяет вызов методов из других потоков, но это происходит с помощью стандартной очереди сообщений Windows, что идеально подходит для визуальный объектов, созданных в основном потоке системы, однако, неудобно для объектов, созданных в рабочих потоках, так как в рабочих потоках отсутствует обработчик очереди сообщений. Это ограничение можно обойти, создав OLE-объект в особом режиме. Ниже даны возможные режимы использования OLE-объектов в программных модулях или обработчиках событий:
+Система работает с интерфейсом ''COM'' в режиме STA (Single-Threaded Apartment) для визуальных (GUI) объектов и в режиме MTA (Multithreaded Apartments) для объектов, не связанных с визуальными формами. Объект связан с визуальными формами, если он располагается на визуальной форме или в таблице SFT, а также если он был создан с прямым указанием на его визуальность. Режим STA для объектов означает, что объект, созданный в одном потоке (основном визуальном потоке), не может быть доступен в других потоках. Windows позволяет вызов методов из других потоков, но это происходит с помощью стандартной очереди сообщений Windows, что идеально подходит для визуальный объектов, созданных в основном потоке системы, однако, такие вызовы исполняются несколько медленнее. Также существует особый однопоточный режим работы OLE-объектов, работающий в режиме STA, если по какой-то причине использование многопоточного режима недопустимо для конкретного OLE-объекта (к примеру, если объект должен работать как строго однопоточный). Ниже дана сводная таблица всех режимов OLE-объектов системы:
 * Режим ''STA'' (однопоточный режим). OLE-объекты, созданные таким образом, делятся на две категории:
 ** Визуальные OLE-объекты, находящиеся на формах или в электронных таблицах. Такие объекты позволяют вызовы из разных потоков, так как визуальный поток обрабатывает сообщения из очереди сообщений. Вызовы из других потоков для этой категории объектов будут обладать такими же минусами, как и вызовы к объектам, созданным в режиме "центрального потока" (см. ниже).
-** OLE-объекты, созданные программно. Методы таких объектов не могут быть вызваны из других потоков (только из потока, где эти объекты были созданы). Зачастую такие объекты создаются, чтобы выполнить определенную работу, и после этого удаляются, поэтому, это не вызывает проблем в работе.
+** Режим исполнения центрального потока. OLE-объекты создаются с помощью функции [[CreateThreadedOLE]] в специально выделенном для этого потоке, который в дальнейшем обслуживает все обращения из других потоков. Обращения происходят не с помощью использования стандартной очереди сообщений Windows, а с помощью более быстрой межпоточной синхронизации. Однако, так как все OLE-объекты, созданные в системе таким образом, обслуживает только один поток, может получиться ситуация (особенно с консольными серверами), когда выполнение вызова к объекту будет задержано, пока выполняется вызов из другого потока. В визуальных клиентах, где количество одновременно работающих потоков мало, это не будет являться реальным ограничением.
-* Режим исполнения центрального потока. OLE-объекты создаются с помощью функции [[CreateThreadedOLE]] в специально выделенном для этого потоке, который в дальнейшем обслуживает все обращения из других потоков. Обращения происходят не с помощью использования стандартной очереди сообщений Windows, а с помощью более быстрой межпоточной синхронизации. Однако, так как все OLE-объекты, созданные в системе таким образом, обслуживает только один поток, может получиться ситуация (особенно с консольными серверами), когда выполнение вызова к объекту будет задержано, пока выполняется вызов из другого потока. В визуальных клиентах, где количество одновременно работающих потоков мало, это не будет являться реальным ограничением.
+* Режим ''MTA'' (многопоточный режим). OLE-объекты, созданные программно. Методы таких объектов могут быть вызваны из любых потоков, а не только из потока, где эти объекты были созданы. Не все OLE-объекты полностью поддерживают многопоточность, поэтому, если объект будет использоваться сразу в нескольких потоках (возможно более одного вызова в одно и то же время из разных потоков), необходимо предусмотреть какую-либо систему межпоточной синхронизации (к примеру с помощью функции [[LockObject]]). Чаще всего, однако, такие объекты создаются, чтобы выполнить определенную работу, и после этого удаляются, поэтому, многопоточность не вызывает проблем в работе.
 В системе OLE-объекты могут присутствовать:
@@ Line 23: / Line 22: @@
 Некоторые аргументы OLE функций могут представлять собой массивы. В этом случае, программа должна передать список одинаковых по типу элементов (OLE не поддерживает списки с разными типами данных). Если OLE функция возвращает массив, он автоматически будет превращен в список.
-Система обычно работает с простыми типами, максимальными по размеру и совместимости. Однако, не все OLE-объекты принимают такие аргументы, и при этом могут не указывать необходимый им тип в свойствах библиотеки. К примеру, OLE функция во втором аргументе ожидает массив из чисел без знака длиной 2 байта (одно слово), однако, тип этого аргумента указан как ''VT_VARIANT'' (т.е. произвольный тип). Если программа передаст функции список значений с числами, система не будет знать, какой тип чисел задавать в массиве и может создать массив из 32-битных целых чисел, который не будет принят вызываемой функцией. Чтобы обойти эту проблему, необходимо использовать вспомогательную функцию [[OLEVariant]], позволяющую из [[Объекты|объекта]] системы создать особый OLE ориентированный объект с твердо заданным типом данных. При этом тип данных указывается, как константа (см. [[Константы#Константы типов данных OLE|константы типов данных OLE]].
+Система обычно работает с простыми типами, максимально совместимыми по размеру с OLE-оригиналами. Однако, не для всех OLE-объектов есть возможность узнать и передать требуемый объектом тип аргумента. Это происходит, если объект не указывает необходимый ему тип в свойствах библиотеки. К примеру, OLE функция во втором аргументе ожидает массив из чисел без знака длиной 2 байта (одно слово), однако, тип этого аргумента указан как ''VT_VARIANT'' (т.е. произвольный тип). Если программа передаст функции список значений с числами, система не будет знать, какой тип чисел задавать в массиве и может создать массив из 32-битных целых чисел, который не будет принят вызываемой функцией. Чтобы обойти эту проблему, необходимо использовать вспомогательную функцию [[OLEVariant]], позволяющую из [[Объекты|объекта]] системы создать особый OLE ориентированный объект с твердо заданным типом данных. При этом тип данных указывается, как константа OLE (см. [[Константы#Константы типов данных OLE|константы типов данных OLE]]).
 Как альтернативный вариант, при передаче числовых массивов в аргументе функции, тип данных в массиве может быть указан, как наименование первого элемента массива. При этом принимаются следующие типы данных:
@@ Line 74: / Line 73: @@
 |status=2
 |visual=0
-|description=Функция создает новый объект OLE (COM) по строке идентификатора. Объект может быть доступен в любом потоке, не только в том, который создал объект. Вызовы к таким объектам осуществляются несколько медленнее.
+|description=Функция создает новый объект OLE (COM) по строке идентификатора. Объект работает в режима STA, однако, может быть доступен в любом потоке, не только в том, который создал объект. Вызовы к таким объектам осуществляются несколько медленнее.
 }}
 {{function entry

← Older revision	Revision as of 14:58, 4 March 2021
(No difference)

@@ Line 20: / Line 20: @@
 * Объекты, расположенные на формах. В этом режиме, объект добавляется на форму в момент ее создания в Студии, для таких объектов могут быть заданы визуальные события ''COM''.
 * Объекты, внедренные в электронные таблицы. Такие объекты также можно добавлять программно или при копировании частей таблицы с помощью функций типа [[Table.CopyByX|CopyByX]].
 == Атрибуты и функции==
@@ Line 38: / Line 75: @@
 |visual=0
 |description=Функция создает новый объект OLE (COM) по строке идентификатора. Объект может быть доступен в любом потоке, не только в том, который создал объект. Вызовы к таким объектам осуществляются несколько медленнее.
 }}
 {{function entry

← Older revision	Revision as of 06:55, 7 February 2021
(No difference)