exponenta event banner

Методы COM

Информация о методе

Выполняется или вызывается COM-функции или методы, принадлежащие COM-объектам. Имена методов чувствительны к регистру. Вы не можете их сокращать.

Чтобы узнать, какие методы поддерживает COM-объект, используйте одну из следующих функций. Каждая функция представляет конкретную информацию, как описано в таблице. Сведения об использовании метода см. в документации поставщика.

ФункцияПродукция

methodsview

Графическое отображение имен функций и сигнатур

methods с -full определитель

Массив ячеек имен функций и сигнатур, отсортированных по алфавиту

methods

Массив ячеек только имен функций, отсортированных по алфавиту, с именами верхнего регистра, перечисленными первыми

invoke

Массив ячеек имен функций и сигнатур

Методы вызова объекта

MATLAB ® поддерживает следующие синтаксисы для вызова методов объекта.

  • По имени метода:

    outputvalue = methodname(object,'arg1','arg2',...);
  • По точечной нотации:

    outputvalue = object.methodname('arg1','arg2',...);
    
  • Использование явного синтаксиса:

    outputvalue = invoke(object,'methodname','arg1','arg2',...);
    

methodsview и methods -full команды показывают, какие типы данных следует использовать для входных и выходных аргументов.

Нельзя использовать синтаксис точки и необходимо явно вызвать get, set, и invoke функционирует при следующих условиях:

  • Для доступа к свойству или методу, не являющемуся открытым членом класса объектов.

  • Доступ к свойству или методу, отсутствующему в библиотеке типов сервера.

  • Для доступа к свойствам, принимающим аргументы. MATLAB рассматривает эти свойства как методы.

  • Для доступа к свойствам вектора объектов используйте get и set функции.

    Невозможно вызвать метод для нескольких COM-объектов, даже если вызывается invoke функция явно.

Указать перечисляемые параметры

Перечисление - это способ назначения описательного имени символьному значению. MATLAB поддерживает перечисление параметров, передаваемых методам, при условии, что используемая библиотека типов сообщает параметр как ENUM, и только как ENUM.

Примечание

MATLAB не поддерживает перечисление для любого параметра, который библиотека типов сообщает как оба ENUM и Optional.

Пропустить необязательные входные аргументы

При вызове метода, который принимает необязательные входные аргументы, можно пропустить необязательный аргумент, указав пустой массив ([]) на его месте. Например, синтаксис вызова метода со вторым аргументом arg2 не указано:

methodname(handle,arg1,[],arg3);

Вернуть несколько выходных аргументов

Если функция сервера поддерживает несколько выходов, можно вернуть любой или все эти выходы клиенту MATLAB.

Следующий синтаксис показывает функцию сервера functionname вызывается клиентом MATLAB. retval является первым выходным аргументом или возвращаемым значением. Другие выходные аргументы: out1, out2, ....

[retval out1 out2 ...] = functionname(handle,in1,in2,...);

Для реализации этой функции MATLAB использует возможности передачи по ссылке в COM. Pass-by-reference - это функция COM; MATLAB не поддерживает передачу по ссылке.

Связанные примеры

Подробнее