Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Interapplication Communication /
Chapter 10 - Scripting Components / Scripting Components Reference
Optional Scripting Component Routines / Manipulating Dialects


OSAGetDialectInfo

You can use the OSAGetDialectInfo function to get information about a specified dialect provided by a specified scripting component.

OSAGetDialectInfo (scriptingComponent: ComponentInstance; 
                   dialectCode: Integer; selector: OSType;
                   VAR resultingDialectInfo: AEDesc): OSAError;
scriptingComponent
A component instance created by a prior call to the Component Manager function OpenDefaultComponent or OpenComponent (see page 10-4).
dialectCode
A code for the dialect about which you want information. You can obtain a list of a scripting component's dialect codes by calling OSAAvailableDialectCodeList.
selector
A constant that indicates what kind of information you want OSAGetDialectInfo to return in the result parameter. This constant determines the descriptor type for the descriptor record returned. See the description that follows for a list of the standard constants you can specify in this parameter.
resultingDialectInfo
A descriptor record containing the requested information. The descriptor record's descriptor type corresponds to the constant specified in the selector parameter.
DESCRIPTION
After you obtain a list of dialect codes by calling OSAAvailableDialectCodeList, you can pass any of those codes to OSAGetDialectInfo to get information about the corresponding dialect. The descriptor type of the descriptor record returned by OSAGetDialectInfo depends on the constant specified in the selector parameter. All scripting components support the following constants for this parameter:

CONST
   keyOSADialectName       = 'dnam';{used with descriptor record }
                                    { of any text type, such as }
                                    { type typeChar}
   keyOSADialectLangCode   = 'dlcd';{used with descriptor record }
                                    { of type typeShortInteger}
   keyOSADialectScriptCode = 'dscd';{used with descriptor record }
                                    { of type typeShortInteger}
Individual scripting components may allow you to specify additional constants.

RESULT CODES
noErr0No error
errOSASystemError-1750General scripting system error
errOSABadSelector-1754Invalid selector
errOSANoSuchDialect-1757Invalid dialect code
badComponentInstance$80008001Invalid component instance

Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996