|
The task below illustrates how to add arguments to a
macro. |
|
Macros with arguments are features that can be:
- stored in CATPart or CATProduct documents,
|
- stored in catalogs. Double-click them in the catalog to run them,
|
- called from a rule (VBScriptRun)
or a reaction. In this case, arguments are passed from the rule.
|
The
icon enables you to access the macro editor. In addition to the usual 'edit
and run' capabilities, this editor allows you to:
|
- carry forward a feature definition to the editor by selecting the
feature either in the tree or in the geometry area.
|
|
|
- Note that the VB macro with arguments functionality is
intended to help you write macros. It is not intended to find the code of
other objects: Only the objects that were correctly integrated to the
macros are supported.
- Output values are not supported.
|
|
-
Click the
icon. The script editor is displayed.
-
Copy/paste the script below into the editor:
Dim oActiveDoc As Document
Set oActiveDoc = CATIA.ActiveDocument
If (InStr(oActiveDoc.Name,".CATPart")) <> 0 Then
Dim oParams As Parameters
Set oParams = oActiveDoc.Part.Parameters
Dim strParam1 As StrParam
Set strParam1 = oParams.CreateString("FirstName", "")
Dim strParam2 As StrParam
Set strParam2 = oParams.CreateString("LastName", "")
strParam1.Value = fname
strParam2.value = lname
Else MsgBox "The active document must be a CATPart"
End If
End Sub
|
-
Enter the fname and lname arguments in the field located
between the parentheses. The arguments must always be separated by a
comma.
-
Click OK to add the macro to the document. A 'VB Scripts'
sub-node is added to the specification tree below the Relations node. A
VB Script object is added below this sub node.
-
Double-click the VB Script object. The Script Editor is
displayed. Insert Object Resolution allows you to retrieve a
feature definition. The VB Script.2 macro of the
KwrObject.CATPart sample
illustrates how to use this capability.
-
Click Run script.... The Select Inputs for
Script Arguments is displayed.
-
If need be, select fname from the argument list, then
enter a string into the value field (no quotation marks). Then select
lname and enter the lname value.
-
Click OK to run the script. The two string type
parameters are added to the document. Their values are those you have
specified.
|
|
Note that the VB script features with arguments are
provided with a contextual menu enabling you to launch the script. |