COM+ EXTENSION FOR MULTIMEDIA FUSION DEVELOPER 2
Version 1.0 - Andre Guerreiro Neto (byo)
Release Notes:
This is library that acts as an Activex extension companion.
With this non visual extension you can create multiple COM, COM+ & ADO objects with ease and treat them as named objects inside your application. You can make them interact with each other.
This extension doesn't require the .NET Framework and was made for any user in mind even those who don't know to script or program.
Note: To more advanced use, some knowledge on the object's methods and properties is required. There are several example in the EXAMPLES folder and there's more to be added soon. If you have any example, article or tutorial that you wish to share, it's much appreciated.
No scripting or programming is required (except knowing the object's methods and properties like "Size = 20", for instance).
CONDITIONS:
- IS OBJECT INITIALISED?:
Helps you to detect if the given object is correctly initialised before using it.
EXPRESSIONS:
- GET INTEGER PROPERTY
Gets the property of the specified object as an integer value (ie. 13).
- GET FLOT PROPERTY
Gets the property of the specified object as a float value (ie. 1.2).
- GET STRING PROPERTY
Gets the property of the specified object as a string value (ie. 1.2).
NOTE: To each of the properties expressions above you must specify the object from which you're retrieving the value and the property command. Example: getting the property "Title" from the object "Document".
- GET LAST ERROR CODE
This will give you the last error code from the COM object.
If the error code is LESS than ZERO then there was an error.
If the error code is EQUAL to ZERO then no error ocurred.
- GET LAST ERROR DESCRIPTION
With this expression you can get the exact error string. Useful to debug your application or to show the user an error message.
ACTIONS
- CREATE OBJECT
In this action you enter the name of the object that you want to create. This name can be anything you want like "Doc", "MyObject", etc. The names of every object created must be unique and you can have as many objects as you want using only one extension. The second parameter is the object's ID which is the registered object's name like "InternetExplorer.Application" or "Word.Application". These names must match the object's ID and you can find more info on them either by looking at tutorials on the net about COM objects.
NOTE: You can have any number of different objects as long as you use different names for them and they can interact with each other very easily without you having to be worried about freeing memory, interfacing, etc.
You can find a bunch of examples in the EXAMPLES folder.
- GET OBJECT
You use this action when you want to create a new object from another object. Suppose you have an "InternetExplorer.Application" object in you application and you named it "IExplorer". After you use the "IExplorer" object method "Navigate", a new browser website is being shown. To get the properties of this website, you must first get the "Document" object inside the "InternetExplorer.Application". So it goes like this:
GET OBJECT "MyDoc" FROM "IExplorer"("Document")
Then you can use the methods and properties from the "MyDoc" such as "Title" to get the title of the document and many other properties. There is an example named "com_internet_get_html_title" in the example's folder that shows a simple way of achieving this.
- SET PROPERTY
This action will set the property of any object. The first parameter is the unique name that you gave to the object and the second one is the property command that you want to change/set. It's as easy as:
SET PROPERTY "Document"("FontSize = 22")
That means that you're setting the font size of the Document object to 22. Note that each COM object has its own predefined properties. You can't set a value to a property that doesn't exist obviously.
- CALL METHOD
When you're not setting an object's properties you're calling its methods. Every object has its own unique methods. "InternetExplorer.Application" object has the "Navigate" method that will take you to any website. You must know the object's methods prior to calling them.
SPECIAL NOTES:
- If you're converting a code or tutorial keep in mind that there are some differences:
1) Instead of "object.property" you would use "object\property".
2) Insted of passing strings directly like "FileName = myfile.doc" you would use "FileName = 'myfile.doc'.
