. DirectXtras Home
        Home

DirectCommunication Xtra
DirectConnection Xtra
DirectControl Xtra
DirectEmail Xtra
DirectFTP Xtra
DirectImage Xtra
DirectInteraction Xtra
DirectOS Xtra
Documentation
License Agreement
Licensing Fees
Order Form
DirectSMS Xtra
DirectSound Xtra
DirectTransition Xtra
DirectTransition3D Xtra Set I
DirectTransition3D Xtra Set II
DirectTransition3D Xtra Set III
DirectTTS Xtra
XtrAgent
DirectXport Xtra

SpeechPlugin

Special Discounted Bundles

The Gallery
How To Order
Order Form
Check for Upgrades

Sign in
Change Your Profile

Contact Us
















    .
DirectXtras
Xtra Power for Director & Authorware



DirectOS Xtra
 Directing Windows and MacOS. The OS at your fingertips!

Authorware 4.x Compatible Authorware 5.x CompatibleAuthorware 6.x CompatibleAuthorware 7.x CompatibleDirector 5.x Compatible Director 6.x CompatibleDirector 7.x Compatible Director 8.x CompatibleDirector MX Compatible     MacOS 8.x and 9.x CompatibleMacOS X Compatible   

dosGetGestaltValue(string Selector, integer SubInfo)

Retrieves the value of a particular gestalt selector.

Parameters :

Selector : A string specifying the gestalt selector to check. This parameter is case sensitive.
SubInfo : An integer specifying the particular field of the gestalt selector to get information about. This is actually the bit to check in the gestalt response, and can be a number between 0 and 31. To obtain the full gestalt integer response value rather than a particular bit field, set this parameter to -1, otherwise, the value in this parameter is tied in with Selector and the function result would be true or false.

 Possible Values :

Selector : "qtim" (QuickTime Version)

SubInfo : -1 - QuickTime version (in hex)

 

Selector : "qd  " (QuickDraw Version)

SubInfo : -1 - QuickDraw version (in hex)

Selector : "apvr" (Appearance Manager Version)

SubInfo : -1 - Appearance Manager version (in hex)

 

Selector : "appr" (Appearance Manager)

SubInfo : 0 - Appearance Manager exists

 

Selector : "ascr" (AppleScript)

SubInfo : 0 - Apple Script exists
               
1
- Power PC Support

 

Selector : "sdev" (Control Strip)

SubInfo : 0 - Control Strip exists
                1
- Supports user-selectable font/size
                2 - Supports user-selectable hot key

 

Selector : "dply" (Display Manager)

SubInfo : 0 - Display Manager exists
               
2 - Supports switch modes on mirrored
                     displays
                3 - SetDepth generates display manager
                     notification
                4 - Supports DMConfirmConfiguration
                5 - Supports profiles for displays

 

Selector : "alis" (Alias Manager)

SubInfo : 0 - Alias Manager exists
               
1 - Knows about remote AppleTalk
                2 - Knows about AOCE Keychain
                3 - Resolve Alias File with Mount Options

 

Selector : "evnt" (Apple Events)

SubInfo : 0 - Apple Events exist
               
1
- Supports scripting
                2 - OSL in system

 

Selector : "crm " (Comm Resource Manager)

SubInfo : 0 - Comm Resource Manager exists
                1
- Has fix for persistent tools
                2 - Has CRMGetToolResource/    
                      ReleaseToolResource

 

Selector : "conn" (Connection Manager)

SubInfo : 0 - Connection Manager exists
                1
- Has fix for CMAddSearch
                2 - Has CMGetErrorString
                3 - Has CMNewIOPB, CMDisposeIOPB,
                     CMPBRead, CMPBWrite and
                     CMPBIOKill

Selector : "ditl" (AppenDITL)

SubInfo : 0 - AppenDITL exists
               
1
- Supports ICTB

 

Selector : "drag" (Drag Manager)

SubInfo : 0 - Drag Manager exists
               
1
- Supports floating windows
                2 - PPC DragLib is present
                3 - Allows SetDragImage call
                4 - Supports starting a drag in a floating
                     window

 

Selector : "powr" (Power Manager)

SubInfo : 0 - Power Manager exists
               
1 - CPU can Idle
                2 - Can stop SCC clock
                3 - Can turn off sound power
                4 - Dispatch exists

 

Selector : "easy" (Easy Access)

SubInfo : 0 - Easy Access exists
               
1 - Easy Access "ON"
                2 - Easy Access "Sticky"
                3 - Easy Access "Locked"

 

Selector : "edtn" (Edition Manager)

SubInfo : 0 - Edition Manager exists
               
1
- Is translation manager aware

 

Selector : "fxfr" (File Transfer Manager)

SubInfo : 0 - File Transfer Manager exists
               
1
- Supports FTSend and FTReceive
                2 - Supports FTGetErrorString
                3 - SupportsFTSendAsync,
                     FTReceiveAsync and
                     FTCompletionAsync

 

Selector : "fold" (Folder Manager)

SubInfo : 0 - Folder Manager exists
               
1
- Has folderDesc calls

 

Selector : "help" (Help Manager)

SubInfo :   0 - Help Manager exists
                 
1
- Extensions installed
                31 - Apple Guide is present

 

Selector : "icon" (Icon Utilities)

SubInfo : 0 - Icon Utilities exist
               
1
- Supports 48x48 icons
                2 - Supports 32-bit deep icons
                3 - Supports 8-bit deep icons
                4 - IconServices present

 

Selector : "slot" (Slot Manager)

SubInfo : 0 - Slot Manager exists
               
1
- NuBus slots present
                2 - SE PDS slots present
                3 - SE/30 slots present
                4 - Portable's slot present

 

Selector : "ttsc" (Speech Manager)

SubInfo : 0 - Speech Manager exists
               
1
- Native PowerPC Glue routines exists

 

Selector : "nlup" (StandardNBP)

SubInfo : 0 - StandardNBP exists
               
1
- Supports StandardNBP (-1, -1) to alert position main
                      screen

 

Selector : "tele" (Telephone Manager)

SubInfo : 0 - Telephone Manager exists
               
1
- Supports PowerPC
                2 - Supports Sound Streams
                3 - Supports Auto Answer
                4 - Supports IndHandset
                5 - Has Silent Detect
                6 - Has NewTEL support

 

Selector : "term" (Terminal Manager)

SubInfo : 0 - Terminal Manager exists
               
2
- Supports error string function

 

Selector : "thds" (Thread Manager)

SubInfo : 0 - Thread Manager exists
               
1
- Supports exact match creation option
                2 - Shared library is present

 

Selector : "xlat" (Translation Manager)

SubInfo : 0 - Translation Manager exists
               
1
- Hint order reversal in effect
                2 - PowerPC translation available
                3 - Get Path API available

 

Selector : "usb " (USB)

SubInfo : 0 - USB exists
               
1
- USB Isochronous features available

 

Selector : "vm  " (Virtual Memory)

SubInfo : 0 - Virtual Memory exists
               
1
- LockMemoryForOutput available
                2 - FileMapping available
                3 - MakeMemoryResident, MakeMemoryNonResident,
                     FlushMemory and ReleaseMemoryData available

 

The above list is incomplete, additional gestalt selectors and information may be available. To query for other gestalt selectors simply pass their 4 letter value as the Selector parameter and the appropriate SubInfo value representing the desired information.

Return Value : An integer value of 1 if the gestalt selector value exists or is supported or a value of 0 if it is not supported. If the Selector string or the SubInfo value were invalid a value of 0 will also be returned along with an error code. To find the source of the error, dosGetLastError() should be called. 

Possible Returned Error Codes via dosGetLastError() :
10001 : Invalid string specified for Selector
10022 : Method is not supported on Windows. 
10049 : The specified gestalt selector was not found.



DirectXtras Inc.
P.O Box 2645, Menlo Park, CA, 94026, U.S.A
Voice: +1-415-5058249, Fax: +1-801-8585841
Toll Free: 1-800-4453093
E-mail General Information: info@directxtras.com
E-mail Technical Support: support@directxtras.com

Copyright 1996-2004 DirectXtras Inc. All Rights Reserved.
WebMaster: tamar@directxtras.com
Last Updated: 12/20/2002 4:54:06 AM.