CreateThreadedOLE - Revision history

Admin: 1 revision imported

2022-03-13T10:04:45Z

1 revision imported

1>Admin at 10:34, 2 March 2022

2022-03-02T10:34:19Z

Admin: 1 revision imported

2021-02-07T06:43:15Z

1 revision imported

Admin at 06:46, 2 February 2020

2020-02-02T06:46:20Z

New page

{{infobox function
|name=CreateThreadedOLE
|object=[[Функции общего назначения]]
|caption=Создание OLE объекта
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, ошибка создания объекта
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]], [[Объект OLE]]}}
Функция создает новый объект OLE (COM) по строке идентификатора, если требуемый объект в системе отсутствует, функция вызывает исключение. Объект может быть доступен в любом потоке, не только в том, который создал объект. Вызовы к таким объектам осуществляются несколько медленнее (однако, замедление очень невелико). Так все такие вызовы выполняются в одном особом потоке, в многопоточном клиенте (особенно консольном) может возникнуть ситуация, когда выполнение вызовов задерживается, так как вызвавший поток ждет, пока выполнится вызов другого потока. Если такая ситуация недопустима, необходимо использовать функцию [[CreateOLE]] и выполнять действия с объектом только в одном потоке.

== Синтаксис ==
<code>
'''CreateThreadedOLE'''(''<Идентификатор объекта OLE (STRING)>''):''<Новый объект OLE (OLE)>''
</code>
==== Аргументы ====
* <code>''<Идентификатор объекта OLE (STRING)>''</code> - Строка-индентификатор объекта. К примеру <code>"Excel.Application"</code> или <code>"ADODB.Connection"</code>.

==== Возвращаемое значение ====
Возвращает созданный объект.

== Примеры ==
<pre>
//Пример создает новую книгу Excel с листом "Данные" и заполняет на нем квадрат 20 на 20 ячеек случайными числами.
Try
Х:=CreateThreadedOLE("Excel.Application");
Except
Message(PopError(),"!");
Message("Ошибка создании объекта! Возможно, не установлен MS Excel!","!");
Exit;
EndTry;
Try
Х.WorkBooks.Add();
Х.WorkSheets(1).Name:="Данные";

Л:=Х.WorkSheets(1);
Л.Activate();
Л.Select();
//Заполнение квадрата 20 x 20 случайными числами 0..9
For i:=1 To 20 Do
For j:=1 To 20 Do
Л.Cells(i,j).Value:=Str(Random(10));
EndDo;
EndDo;
Finally
Х.Visible:=1;
EndTry;
</pre>

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

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Функции общего назначения]], [[Объект OLE]]}}
-Функция создает новый объект OLE (COM) по строке идентификатора, если требуемый объект в системе отсутствует, функция вызывает исключение. Объект может быть доступен в любом потоке, не только в том, который создал объект. Вызовы к таким объектам осуществляются несколько медленнее (однако, замедление очень невелико). Так все такие вызовы выполняются в одном особом потоке, в многопоточном клиенте (особенно консольном) может возникнуть ситуация, когда выполнение вызовов задерживается, так как вызвавший поток ждет, пока выполнится вызов другого потока. Если такая ситуация недопустима, необходимо использовать функцию [[CreateOLE]] и выполнять действия с объектом только в одном потоке.
+Функция создает новый объект OLE (COM) по строке идентификатора, если требуемый объект в системе отсутствует, функция вызывает исключение. Объект работает в режима STA, однако, может быть доступен в любом потоке, не только в том, который создал объект. Вызовы к таким объектам осуществляются несколько медленнее (однако, замедление очень невелико). Так все такие вызовы выполняются в одном особом потоке, в многопоточном клиенте (особенно консольном) может возникнуть ситуация, когда выполнение вызовов задерживается, так как вызвавший поток ждет, пока выполнится вызов другого потока. Если такая ситуация недопустима, необходимо использовать функцию [[CreateOLE]] и выполнять действия с объектом только в одном потоке.
 == Синтаксис ==

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