NOTE: This method was deprecated in V4-0. The recommended method to set the Scale to Link is via SetPenAttribute specifying an attribute of "SCALESTRATEGY".
long SetScaleLinkByName (LPCTSTR CurrentDL, LPCTSTR CurrentItemName, LPCTSTR LinkDL, LPCTSTR LinkItemName, float Multiplier, float Offset);
Available (from release):
stOCX (V2-01), stPro Automation (V2-01)
Return Value:
Nonzero if successful otherwise 0.
Note: The stPro automation interface does not return a value for this method.
Parameters:
|
Name: |
Description: |
|
CurrentDL |
The DL of the item whose minimum and maximum scale values are to be derived from the Link item. |
|
CurrentItemName |
The item name of the pen whose minimum and maximum scale values are to be derived from the Link item. |
|
LinkDL |
The DL of the link item. |
|
LinkItemName |
The name of the Link item. |
|
Multiplier |
The multiplier to apply to the scale values of the Link pen. |
|
Offset |
The offset to apply to the scale values of the Link pen. |
Remarks:
Call this function to link the scales of one pen to another by item name.
Tip: If the LinkPen scales are to be preserved 'as is' then ensure that the Multiplier is set to 1 and the Offset is set to 0.
Note: When calculating the scales for the CurrentPen the Multiplier is applied before the Offset.