Registration and Versioning (MATLAB Excel Builder)

MATLAB Excel Builder

Obtaining Registry Information

MATLAB Excel Builder includes the MATLAB function componentinfo to query the system registry for any installed Excel Builder components. The function can be executed inside MATLAB with the component name, major version number, and minor version number as arguments. It returns an array of structures with the requested information. Calling componentinfo with no arguments returns all Excel Builder components installed on the machine.

The next example queries the registry for a component named mycomponent and a version of 1.0. This component has four methods: mysum, randvectors, getdates, and myprimes, two properties: m and n, and one event: myevent.

Note Although properties and events may appear in componentinfo output fields, Excel Builder components currently do not support them.

Info = componentinfo('mycomponent', 1, 0)

Info = 

       Name: 'mycomponent'
      TypeLib: 'mycomponent 1.0 Type Library'
        LIBID: '{3A14AB34-44BE-11D5-B155-00D0B7BA7544}'
    MajorRev: 1
    MinorRev: 0
    FileName: 'D:\Work\ mycomponent\distrib\mycomponent_1_0.dll'
    Interfaces: [1x1 struct]
    CoClasses: [1x1 struct]

Info.Interfaces

ans = 

      Name: 'Imyclass'
       IID: '{3A14AB36-44BE-11D5-B155-00D0B7BA7544}'

Info.CoClasses

ans = 

          Name: 'myclass'
         CLSID: '{3A14AB35-44BE-11D5-B155-00D0B7BA7544}'
         ProgID: 'mycomponent.myclass.1_0'
   VerIndProgID: 'mycomponent.myclass'
InprocServer32:'D:\Work\mycomponent\distrib\mycomponent_1_0.dll'
       Methods: [1x4 struct]
    Properties: {'m', 'n'}
        Events: [1x1 struct]

Info.CoClasses.Events.M

ans =

function myevent(x, y)

Info.CoClasses.Methods

ans = 

1x4 struct array with fields:
    IDL
    M
    C
    VB

Info.CoClasses.Methods.M

ans =

function [y] = mysum(varargin)

ans =

function [varargout] = randvectors()

ans =

function [x] = getdates(n, inc)

ans =

function [p] = myprimes(n)

The returned structure contains fields corresponding to the most important information from the registry and type library for the component. These fields are defined in Table C-2.

Table C-2: Registry Information Returned by componentinfo
Field
Description

Name
Component name

TypeLib
Component type library

LIBID
Component type library GUID

MajorRev
Major version number

MinorRev
Minor version number

FileName
Type library filename and path. Since all MATLAB Excel Builder components have the type library bound into the DLL, this filename is the same as the DLL name and path.

Interfaces
An array of structures defining all interface definitions in the type library. Each structure contains two fields:
Name - Interface name

IID - Interface GUID

CoClasses
An array of structures defining all COM classes in the component. Each structure contains these fields:
Name - Class name

CLSID - GUID of the class

ProgID - Version dependent program ID

VerIndProgID - Version independent program ID

InprocServer32 - Full name and path to component DLL

Methods - A structure containing function prototypes of all class methods defined for this interface. This structure contains four fields:

IDL - An array of Interface Description Language function prototypes

M - An array of MATLAB function prototypes

C - An array of C-language function prototypes

VB - An array of Visual Basic function prototypes

Properties - A cell array containing the names of all class properties.

Events - A structure containing function prototypes of all events defined for this class. This structure contains four fields:

IDL - An array of IDL (Interface Description Language) function prototypes.

M - An array of MATLAB function prototypes.

C - An array of C-Language function prototypes.

VB - An array of Visual Basic function prototypes

**Table C-2: Registry Information Returned by componentinfo**
Field	Description
`Name`	Component name
`TypeLib`	Component type library
`LIBID`	Component type library GUID
`MajorRev`	Major version number
`MinorRev`	Minor version number
`FileName`	Type library filename and path. Since all MATLAB Excel Builder components have the type library bound into the DLL, this filename is the same as the DLL name and path.
`Interfaces`	An array of structures defining all interface definitions in the type library. Each structure contains two fields: `Name` - Interface name `IID` - Interface GUID
`CoClasses`	An array of structures defining all COM classes in the component. Each structure contains these fields: `Name` - Class name `CLSID` - GUID of the class `ProgID` - Version dependent program ID `VerIndProgID` - Version independent program ID `InprocServer32` - Full name and path to component DLL `Methods` - A structure containing function prototypes of all class methods defined for this interface. This structure contains four fields: `IDL` - An array of Interface Description Language function prototypes `M` - An array of MATLAB function prototypes `C` - An array of C-language function prototypes `VB` - An array of Visual Basic function prototypes `Properties` - A cell array containing the names of all class properties. `Events` - A structure containing function prototypes of all events defined for this class. This structure contains four fields: `IDL` - An array of IDL (Interface Description Language) function prototypes. `M` - An array of MATLAB function prototypes. `C` - An array of C-Language function prototypes. `VB` - An array of Visual Basic function prototypes

Versioning Utility Library