开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 多媒体编程 > 查看源码
Dictionary.h
资源名称：fullMPCcode.rar　[点击查看]
上传用户：xjjlds
上传日期：2015-12-05
资源大小：22823k
文件大小：29k
源码类别：

多媒体编程

开发平台：

Visual C++

Dictionary.h：源码内容
  1. /*
  2.      File:       Dictionary.h
  3.  
  4.      Contains:   Dictionary Manager Interfaces
  5.  
  6.      Version:    Technology: System 7
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1992-2001 by Apple Computer, Inc., all rights reserved.
  10.  
  11.      Bugs?:      For bug reports, consult the following page on
  12.                  the World Wide Web:
  13.  
  14.                      http://developer.apple.com/bugreporter/
  15.  
  16. */
  17. #ifndef __DICTIONARY__
  18. #define __DICTIONARY__
  20. #ifndef __MACTYPES__
  21. #include "MacTypes.h"
  22. #endif
  24. #ifndef __FILES__
  25. #include "Files.h"
  26. #endif
  28. #ifndef __AEREGISTRY__
  29. #include "AERegistry.h"
  30. #endif
  32. #ifndef __CODEFRAGMENTS__
  33. #include "CodeFragments.h"
  34. #endif
  36. #ifndef __MACERRORS__
  37. #include "MacErrors.h"
  38. #endif
  43. #if PRAGMA_ONCE
  44. #pragma once
  45. #endif
  47. #ifdef __cplusplus
  48. extern "C" {
  49. #endif
  51. #if PRAGMA_IMPORT
  52. #pragma import on
  53. #endif
  55. #if PRAGMA_STRUCT_ALIGN
  56.     #pragma options align=power
  57. #elif PRAGMA_STRUCT_PACKPUSH
  58.     #pragma pack(push, 2)
  59. #elif PRAGMA_STRUCT_PACK
  60.     #pragma pack(2)
  61. #endif
  63. /*
  64. =============================================================================================
  65.  Modern Dictionary Manager
  66. =============================================================================================
  67. */
  68. /*
  69.     Dictionary information
  70. */
  71. enum {
  72.     kDictionaryFileType         = FOUR_CHAR_CODE('dict'),
  73.     kDCMDictionaryHeaderSignature = FOUR_CHAR_CODE('dict'),
  74.     kDCMDictionaryHeaderVersion = 2
  75. };
  77. enum {
  78.     kDCMAnyFieldTag             = typeWildCard,
  79.     kDCMAnyFieldType            = typeWildCard
  80. };
  82. /*
  83.     Contents of a Field Info Record (an AERecord)
  84. */
  85. enum {
  86.     keyDCMFieldTag              = FOUR_CHAR_CODE('ftag'),       /* typeEnumeration */
  87.     keyDCMFieldType             = FOUR_CHAR_CODE('ftyp'),       /* typeEnumeration */
  88.     keyDCMMaxRecordSize         = FOUR_CHAR_CODE('mrsz'),       /* typeMagnitude */
  89.     keyDCMFieldAttributes       = FOUR_CHAR_CODE('fatr'),
  90.     keyDCMFieldDefaultData      = FOUR_CHAR_CODE('fdef'),
  91.     keyDCMFieldName             = FOUR_CHAR_CODE('fnam'),       /* typeChar */
  92.     keyDCMFieldFindMethods      = FOUR_CHAR_CODE('ffnd')        /* typeAEList of typeDCMFindMethod */
  93. };
  95. /*
  96.     Special types for fields of a Field Info Record
  97. */
  98. enum {
  99.     typeDCMFieldAttributes      = FOUR_CHAR_CODE('fatr'),
  100.     typeDCMFindMethod           = FOUR_CHAR_CODE('fmth')
  101. };
  104. /*
  105.     Field attributes
  106. */
  107. enum {
  108.     kDCMIndexedFieldMask        = 0x00000001,
  109.     kDCMRequiredFieldMask       = 0x00000002,
  110.     kDCMIdentifyFieldMask       = 0x00000004,
  111.     kDCMFixedSizeFieldMask      = 0x00000008,
  112.     kDCMHiddenFieldMask         = (long)0x80000000
  113. };
  115. typedef OptionBits                      DCMFieldAttributes;
  116. /*
  117.     Standard dictionary properties
  118. */
  119. enum {
  120.     pDCMAccessMethod            = FOUR_CHAR_CODE('amtd'),       /* data type: typeChar ReadOnly */
  121.     pDCMPermission              = FOUR_CHAR_CODE('perm'),       /* data type: typeUInt16 */
  122.     pDCMListing                 = FOUR_CHAR_CODE('list'),       /* data type: typeUInt16 */
  123.     pDCMMaintenance             = FOUR_CHAR_CODE('mtnc'),       /* data type: typeUInt16 */
  124.     pDCMLocale                  = FOUR_CHAR_CODE('locl'),       /* data type: typeUInt32.  Optional; default = kLocaleIdentifierWildCard */
  125.     pDCMClass                   = pClass,                       /* data type: typeUInt16 */
  126.     pDCMCopyright               = FOUR_CHAR_CODE('info')        /* data type: typeChar */
  127. };
  129. /*
  130.     pDCMPermission property constants
  131. */
  132. enum {
  133.     kDCMReadOnlyDictionary      = 0,
  134.     kDCMReadWriteDictionary     = 1
  135. };
  137. /*
  138.     pDCMListing property constants
  139. */
  140. enum {
  141.     kDCMAllowListing            = 0,
  142.     kDCMProhibitListing         = 1
  143. };
  145. /*
  146.     pDCMClass property constants
  147. */
  148. enum {
  149.     kDCMUserDictionaryClass     = 0,
  150.     kDCMSpecificDictionaryClass = 1,
  151.     kDCMBasicDictionaryClass    = 2
  152. };
  154. /*
  155.     Standard search method
  156. */
  157. enum {
  158.     kDCMFindMethodExactMatch    = kAEEquals,
  159.     kDCMFindMethodBeginningMatch = kAEBeginsWith,
  160.     kDCMFindMethodContainsMatch = kAEContains,
  161.     kDCMFindMethodEndingMatch   = kAEEndsWith,
  162.     kDCMFindMethodForwardTrie   = FOUR_CHAR_CODE('ftri'),       /* used for morphological analysis*/
  163.     kDCMFindMethodBackwardTrie  = FOUR_CHAR_CODE('btri')        /* used for morphological analysis*/
  164. };
  166. typedef OSType                          DCMFindMethod;
  167. /*
  168.     AccessMethod features
  169. */
  170. enum {
  171.     kDCMCanUseFileDictionaryMask = 0x00000001,
  172.     kDCMCanUseMemoryDictionaryMask = 0x00000002,
  173.     kDCMCanStreamDictionaryMask = 0x00000004,
  174.     kDCMCanHaveMultipleIndexMask = 0x00000008,
  175.     kDCMCanModifyDictionaryMask = 0x00000010,
  176.     kDCMCanCreateDictionaryMask = 0x00000020,
  177.     kDCMCanAddDictionaryFieldMask = 0x00000040,
  178.     kDCMCanUseTransactionMask   = 0x00000080
  179. };
  181. typedef OptionBits                      DCMAccessMethodFeature;
  182. typedef UInt32                          DCMUniqueID;
  183. typedef struct OpaqueDCMObjectID*       DCMObjectID;
  184. typedef DCMObjectID                     DCMAccessMethodID;
  185. typedef DCMObjectID                     DCMDictionaryID;
  186. #define kDCMInvalidObjectID ((DCMObjectID) kInvalidID)
  187. typedef struct OpaqueDCMObjectRef*      DCMObjectRef;
  188. typedef DCMObjectRef                    DCMDictionaryRef;
  189. typedef DCMObjectRef                    DCMDictionaryStreamRef;
  190. #define kDCMInvalidObjectRef ((DCMObjectRef) kInvalidID)
  191. typedef struct OpaqueDCMObjectIterator*  DCMObjectIterator;
  192. typedef DCMObjectIterator               DCMAccessMethodIterator;
  193. typedef DCMObjectIterator               DCMDictionaryIterator;
  194. typedef struct OpaqueDCMFoundRecordIterator*  DCMFoundRecordIterator;
  195. /*
  196.     Field specification declarations
  197. */
  198. typedef DescType                        DCMFieldTag;
  199. typedef DescType                        DCMFieldType;
  200. /*
  201.     Dictionary header information
  202. */
  204. struct DCMDictionaryHeader {
  205.     FourCharCode                    headerSignature;
  206.     UInt32                          headerVersion;
  207.     ByteCount                       headerSize;
  208.     Str63                           accessMethod;
  209. };
  210. typedef struct DCMDictionaryHeader      DCMDictionaryHeader;
  211. /*
  212.     Callback routines
  213. */
  214. typedef CALLBACK_API( Boolean , DCMProgressFilterProcPtr )(Boolean determinateProcess, UInt16 percentageComplete, UInt32 callbackUD);
  215. typedef STACK_UPP_TYPE(DCMProgressFilterProcPtr)                DCMProgressFilterUPP;
  216. #if OPAQUE_UPP_TYPES
  217. #if CALL_NOT_IN_CARBON
  218.     EXTERN_API(DCMProgressFilterUPP)
  219.     NewDCMProgressFilterUPP        (DCMProgressFilterProcPtr userRoutine);
  221.     EXTERN_API(void)
  222.     DisposeDCMProgressFilterUPP    (DCMProgressFilterUPP    userUPP);
  224.     EXTERN_API(Boolean)
  225.     InvokeDCMProgressFilterUPP     (Boolean                 determinateProcess,
  226.                                     UInt16                  percentageComplete,
  227.                                     UInt32                  callbackUD,
  228.                                     DCMProgressFilterUPP    userUPP);
  230. #endif  /* CALL_NOT_IN_CARBON */
  232. #else
  233.     enum { uppDCMProgressFilterProcInfo = 0x00000E50 };             /* pascal 1_byte Func(1_byte, 2_bytes, 4_bytes) */
  234.     #define NewDCMProgressFilterUPP(userRoutine)                    (DCMProgressFilterUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppDCMProgressFilterProcInfo, GetCurrentArchitecture())
  235.     #define DisposeDCMProgressFilterUPP(userUPP)                    DisposeRoutineDescriptor(userUPP)
  236.     #define InvokeDCMProgressFilterUPP(determinateProcess, percentageComplete, callbackUD, userUPP)  (Boolean)CALL_THREE_PARAMETER_UPP((userUPP), uppDCMProgressFilterProcInfo, (determinateProcess), (percentageComplete), (callbackUD))
  237. #endif
  238. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  239. #define NewDCMProgressFilterProc(userRoutine)                   NewDCMProgressFilterUPP(userRoutine)
  240. #define CallDCMProgressFilterProc(userRoutine, determinateProcess, percentageComplete, callbackUD) InvokeDCMProgressFilterUPP(determinateProcess, percentageComplete, callbackUD, userRoutine)
  241. /*
  242.     Library version
  243. */
  244. EXTERN_API( UInt32 )
  245. DCMLibraryVersion               (void);
  247. /*
  248.     Create/delete dictionary
  249. */
  250. EXTERN_API( OSStatus )
  251. DCMNewDictionary                (DCMAccessMethodID      accessMethodID,
  252.                                  const FSSpec *         newDictionaryFile,
  253.                                  ScriptCode             scriptTag,
  254.                                  const AEDesc *         listOfFieldInfoRecords,
  255.                                  Boolean                invisible,
  256.                                  ItemCount              recordCapacity,
  257.                                  DCMDictionaryID *      newDictionary);
  259. EXTERN_API( OSStatus )
  260. DCMDeriveNewDictionary          (DCMDictionaryID        srcDictionary,
  261.                                  const FSSpec *         newDictionaryFile,
  262.                                  ScriptCode             scriptTag,
  263.                                  Boolean                invisible,
  264.                                  ItemCount              recordCapacity,
  265.                                  DCMDictionaryID *      newDictionary);
  267. EXTERN_API( OSStatus )
  268. DCMDeleteDictionary             (DCMDictionaryID        dictionaryID);
  270. /*
  271.     Register dictionary
  272. */
  273. EXTERN_API( OSStatus )
  274. DCMRegisterDictionaryFile       (const FSSpec *         dictionaryFile,
  275.                                  DCMDictionaryID *      dictionaryID);
  277. EXTERN_API( OSStatus )
  278. DCMUnregisterDictionary         (DCMDictionaryID        dictionaryID);
  280. /*
  281.     Open dictionary
  282. */
  283. EXTERN_API( OSStatus )
  284. DCMOpenDictionary               (DCMDictionaryID        dictionaryID,
  285.                                  ByteCount              protectKeySize,
  286.                                  ConstLogicalAddress    protectKey,
  287.                                  DCMDictionaryRef *     dictionaryRef);
  289. EXTERN_API( OSStatus )
  290. DCMCloseDictionary              (DCMDictionaryRef       dictionaryRef);
  292. /*
  293.     Change access privilege
  294. */
  295. EXTERN_API( OSStatus )
  296. DCMGetDictionaryWriteAccess     (DCMDictionaryRef       dictionaryRef,
  297.                                  Duration               timeOutDuration);
  299. EXTERN_API( OSStatus )
  300. DCMReleaseDictionaryWriteAccess (DCMDictionaryRef       dictionaryRef,
  301.                                  Boolean                commitTransaction);
  303. /*
  304.     Find records
  305. */
  306. EXTERN_API( OSStatus )
  307. DCMFindRecords                  (DCMDictionaryRef       dictionaryRef,
  308.                                  DCMFieldTag            keyFieldTag,
  309.                                  ByteCount              keySize,
  310.                                  ConstLogicalAddress    keyData,
  311.                                  DCMFindMethod          findMethod,
  312.                                  ItemCount              preFetchedDataNum,
  313.                                  DCMFieldTag            preFetchedData[],
  314.                                  ItemCount              skipCount,
  315.                                  ItemCount              maxRecordCount,
  316.                                  DCMFoundRecordIterator * recordIterator);
  318. EXTERN_API( ItemCount )
  319. DCMCountRecordIterator          (DCMFoundRecordIterator  recordIterator);
  321. EXTERN_API( OSStatus )
  322. DCMIterateFoundRecord           (DCMFoundRecordIterator  recordIterator,
  323.                                  ByteCount              maxKeySize,
  324.                                  ByteCount *            actualKeySize,
  325.                                  LogicalAddress         keyData,
  326.                                  DCMUniqueID *          uniqueID,
  327.                                  AEDesc *               dataList);
  329. EXTERN_API( OSStatus )
  330. DCMDisposeRecordIterator        (DCMFoundRecordIterator  recordIterator);
  332. /*
  333.     Dump dictionary
  334. */
  335. EXTERN_API( OSStatus )
  336. DCMCountRecord                  (DCMDictionaryID        dictionaryID,
  337.                                  ItemCount *            count);
  339. EXTERN_API( OSStatus )
  340. DCMGetRecordSequenceNumber      (DCMDictionaryRef       dictionaryRef,
  341.                                  DCMFieldTag            keyFieldTag,
  342.                                  ByteCount              keySize,
  343.                                  ConstLogicalAddress    keyData,
  344.                                  DCMUniqueID            uniqueID,
  345.                                  ItemCount *            sequenceNum);
  347. EXTERN_API( OSStatus )
  348. DCMGetNthRecord                 (DCMDictionaryRef       dictionaryRef,
  349.                                  DCMFieldTag            keyFieldTag,
  350.                                  ItemCount              serialNum,
  351.                                  ByteCount              maxKeySize,
  352.                                  ByteCount *            keySize,
  353.                                  LogicalAddress         keyData,
  354.                                  DCMUniqueID *          uniqueID);
  356. EXTERN_API( OSStatus )
  357. DCMGetNextRecord                (DCMDictionaryRef       dictionaryRef,
  358.                                  DCMFieldTag            keyFieldTag,
  359.                                  ByteCount              keySize,
  360.                                  ConstLogicalAddress    keyData,
  361.                                  DCMUniqueID            uniqueID,
  362.                                  ByteCount              maxKeySize,
  363.                                  ByteCount *            nextKeySize,
  364.                                  LogicalAddress         nextKeyData,
  365.                                  DCMUniqueID *          nextUniqueID);
  367. EXTERN_API( OSStatus )
  368. DCMGetPrevRecord                (DCMDictionaryRef       dictionaryRef,
  369.                                  DCMFieldTag            keyFieldTag,
  370.                                  ByteCount              keySize,
  371.                                  ConstLogicalAddress    keyData,
  372.                                  DCMUniqueID            uniqueID,
  373.                                  ByteCount              maxKeySize,
  374.                                  ByteCount *            prevKeySize,
  375.                                  LogicalAddress         prevKeyData,
  376.                                  DCMUniqueID *          prevUniqueID);
  378. /*
  379.     Get field data
  380. */
  381. EXTERN_API( OSStatus )
  382. DCMGetFieldData                 (DCMDictionaryRef       dictionaryRef,
  383.                                  DCMFieldTag            keyFieldTag,
  384.                                  ByteCount              keySize,
  385.                                  ConstLogicalAddress    keyData,
  386.                                  DCMUniqueID            uniqueID,
  387.                                  ItemCount              numOfData,
  388.                                  const DCMFieldTag      dataTag[],
  389.                                  AEDesc *               dataList);
  391. EXTERN_API( OSStatus )
  392. DCMSetFieldData                 (DCMDictionaryRef       dictionaryRef,
  393.                                  DCMFieldTag            keyFieldTag,
  394.                                  ByteCount              keySize,
  395.                                  ConstLogicalAddress    keyData,
  396.                                  DCMUniqueID            uniqueID,
  397.                                  const AEDesc *         dataList);
  399. /*
  400.     Add record
  401. */
  402. EXTERN_API( OSStatus )
  403. DCMAddRecord                    (DCMDictionaryRef       dictionaryRef,
  404.                                  DCMFieldTag            keyFieldTag,
  405.                                  ByteCount              keySize,
  406.                                  ConstLogicalAddress    keyData,
  407.                                  Boolean                checkOnly,
  408.                                  const AEDesc *         dataList,
  409.                                  DCMUniqueID *          newUniqueID);
  411. EXTERN_API( OSStatus )
  412. DCMDeleteRecord                 (DCMDictionaryRef       dictionaryRef,
  413.                                  DCMFieldTag            keyFieldTag,
  414.                                  ByteCount              keySize,
  415.                                  ConstLogicalAddress    keyData,
  416.                                  DCMUniqueID            uniqueID);
  418. /*
  419.     Reorganize/compact dictionary
  420. */
  421. EXTERN_API( OSStatus )
  422. DCMReorganizeDictionary         (DCMDictionaryID        dictionaryID,
  423.                                  ItemCount              extraCapacity,
  424.                                  DCMProgressFilterUPP   progressProc,
  425.                                  UInt32                 userData);
  427. EXTERN_API( OSStatus )
  428. DCMCompactDictionary            (DCMDictionaryID        dictionaryID,
  429.                                  DCMProgressFilterUPP   progressProc,
  430.                                  UInt32                 userData);
  432. /*
  433.     DictionaryID utilities
  434. */
  435. EXTERN_API( OSStatus )
  436. DCMGetFileFromDictionaryID      (DCMDictionaryID        dictionaryID,
  437.                                  FSSpec *               fileRef);
  439. EXTERN_API( OSStatus )
  440. DCMGetDictionaryIDFromFile      (const FSSpec *         fileRef,
  441.                                  DCMDictionaryID *      dictionaryID);
  443. EXTERN_API( DCMDictionaryID )
  444. DCMGetDictionaryIDFromRef       (DCMDictionaryRef       dictionaryRef);
  446. /*
  447.     Field information and manipulation
  448. */
  449. EXTERN_API( OSStatus )
  450. DCMGetDictionaryFieldInfo       (DCMDictionaryID        dictionaryID,
  451.                                  DCMFieldTag            fieldTag,
  452.                                  AEDesc *               fieldInfoRecord);
  454. /*
  455.     Dictionary property
  456. */
  457. EXTERN_API( OSStatus )
  458. DCMGetDictionaryProperty        (DCMDictionaryID        dictionaryID,
  459.                                  DCMFieldTag            propertyTag,
  460.                                  ByteCount              maxPropertySize,
  461.                                  ByteCount *            actualSize,
  462.                                  LogicalAddress         propertyValue);
  464. EXTERN_API( OSStatus )
  465. DCMSetDictionaryProperty        (DCMDictionaryID        dictionaryID,
  466.                                  DCMFieldTag            propertyTag,
  467.                                  ByteCount              propertySize,
  468.                                  ConstLogicalAddress    propertyValue);
  470. EXTERN_API( OSStatus )
  471. DCMGetDictionaryPropertyList    (DCMDictionaryID        dictionaryID,
  472.                                  ItemCount              maxPropertyNum,
  473.                                  ItemCount *            numProperties,
  474.                                  DCMFieldTag            propertyTag[]);
  476. /*
  477.     Seaarch dictionary
  478. */
  479. EXTERN_API( OSStatus )
  480. DCMCreateDictionaryIterator     (DCMDictionaryIterator * dictionaryIterator);
  482. /*
  483.     Search AccessMethod
  484. */
  485. EXTERN_API( OSStatus )
  486. DCMCreateAccessMethodIterator   (DCMAccessMethodIterator * accessMethodIterator);
  488. /*
  489.     Iterator Operation
  490. */
  491. EXTERN_API( ItemCount )
  492. DCMCountObjectIterator          (DCMObjectIterator      iterator);
  494. EXTERN_API( OSStatus )
  495. DCMIterateObject                (DCMObjectIterator      iterator,
  496.                                  DCMObjectID *          objectID);
  498. EXTERN_API( OSStatus )
  499. DCMResetObjectIterator          (DCMObjectIterator      iterator);
  501. EXTERN_API( OSStatus )
  502. DCMDisposeObjectIterator        (DCMObjectIterator      iterator);
  504. /*
  505.     Get AccessMethod information
  506. */
  507. EXTERN_API( OSStatus )
  508. DCMGetAccessMethodIDFromName    (ConstStr63Param        accessMethodName,
  509.                                  DCMAccessMethodID *    accessMethodID);
  511. /*
  512.     Field Info Record routines
  513. */
  514. EXTERN_API( OSStatus )
  515. DCMCreateFieldInfoRecord        (DescType               fieldTag,
  516.                                  DescType               fieldType,
  517.                                  ByteCount              maxRecordSize,
  518.                                  DCMFieldAttributes     fieldAttributes,
  519.                                  AEDesc *               fieldDefaultData,
  520.                                  ItemCount              numberOfFindMethods,
  521.                                  DCMFindMethod          findMethods[],
  522.                                  AEDesc *               fieldInfoRecord);
  524. EXTERN_API( OSStatus )
  525. DCMGetFieldTagAndType           (const AEDesc *         fieldInfoRecord,
  526.                                  DCMFieldTag *          fieldTag,
  527.                                  DCMFieldType *         fieldType);
  529. EXTERN_API( OSStatus )
  530. DCMGetFieldMaxRecordSize        (const AEDesc *         fieldInfoRecord,
  531.                                  ByteCount *            maxRecordSize);
  533. EXTERN_API( OSStatus )
  534. DCMGetFieldAttributes           (const AEDesc *         fieldInfoRecord,
  535.                                  DCMFieldAttributes *   attributes);
  537. EXTERN_API( OSStatus )
  538. DCMGetFieldDefaultData          (const AEDesc *         fieldInfoRecord,
  539.                                  DescType               desiredType,
  540.                                  AEDesc *               fieldDefaultData);
  542. EXTERN_API( OSStatus )
  543. DCMGetFieldFindMethods          (const AEDesc *         fieldInfoRecord,
  544.                                  ItemCount              findMethodsArrayMaxSize,
  545.                                  DCMFindMethod          findMethods[],
  546.                                  ItemCount *            actualNumberOfFindMethods);
  548. /*
  549.     Check Dictionary Manager availability
  550. */
  551. #if TARGET_RT_MAC_CFM
  552. #ifdef __cplusplus
  553.     inline pascal Boolean DCMDictionaryManagerAvailable() { return (DCMLibraryVersion != (void*)kUnresolvedCFragSymbolAddress); }
  554. #else
  555.     #define DCMDictionaryManagerAvailable()     ((DCMLibraryVersion != (void*)kUnresolvedCFragSymbolAddress)
  556. #endif
  557. #elif TARGET_RT_MAC_MACHO
  558. /* Dictionary Manager is always available on OS X */
  559. #ifdef __cplusplus
  560.     inline pascal Boolean DCMDictionaryManagerAvailable() { return true; }
  561. #else
  562.     #define DCMDictionaryManagerAvailable()     (true)
  563. #endif
  564. #endif  /*  */
  566. /*
  567. =============================================================================================
  568.     Definitions for Japanese Analysis Module
  569. =============================================================================================
  570. */
  571. /*
  572.     Default dictionary access method for Japanese analysis
  573. */
  574. #define kAppleJapaneseDefaultAccessMethodName   "pDAM:Apple Backward Trie Access Method"
  575. /*
  576.     Data length limitations of Apple Japanese dictionaries
  577. */
  578. enum {
  579.     kMaxYomiLengthInAppleJapaneseDictionary = 40,
  580.     kMaxKanjiLengthInAppleJapaneseDictionary = 64
  581. };
  583. /*
  584.     Defined field tags of Apple Japanese dictionary
  585. */
  586. enum {
  587.     kDCMJapaneseYomiTag         = FOUR_CHAR_CODE('yomi'),
  588.     kDCMJapaneseHyokiTag        = FOUR_CHAR_CODE('hyok'),
  589.     kDCMJapaneseHinshiTag       = FOUR_CHAR_CODE('hins'),
  590.     kDCMJapaneseWeightTag       = FOUR_CHAR_CODE('hind'),
  591.     kDCMJapanesePhoneticTag     = FOUR_CHAR_CODE('hton'),
  592.     kDCMJapaneseAccentTag       = FOUR_CHAR_CODE('acnt'),
  593.     kDCMJapaneseOnKunReadingTag = FOUR_CHAR_CODE('OnKn'),
  594.     kDCMJapaneseFukugouInfoTag  = FOUR_CHAR_CODE('fuku')
  595. };
  597. enum {
  598.     kDCMJapaneseYomiType        = typeUnicodeText,
  599.     kDCMJapaneseHyokiType       = typeUnicodeText,
  600.     kDCMJapaneseHinshiType      = FOUR_CHAR_CODE('hins'),
  601.     kDCMJapaneseWeightType      = typeShortInteger,
  602.     kDCMJapanesePhoneticType    = typeUnicodeText,
  603.     kDCMJapaneseAccentType      = FOUR_CHAR_CODE('byte'),
  604.     kDCMJapaneseOnKunReadingType = typeUnicodeText,
  605.     kDCMJapaneseFukugouInfoType = FOUR_CHAR_CODE('fuku')
  606. };
  609. /*
  610. =============================================================================================
  611.  System 7 Dictionary Manager
  612. =============================================================================================
  613. */
  615. #if PRAGMA_STRUCT_ALIGN
  616. #pragma options align=reset
  617. #pragma options align=mac68k
  618. #endif
  620. enum {
  621.                                                                 /* Dictionary data insertion modes */
  622.     kInsert                     = 0,                            /* Only insert the input entry if there is nothing in the dictionary that matches the key. */
  623.     kReplace                    = 1,                            /* Only replace the entries which match the key with the input entry. */
  624.     kInsertOrReplace            = 2                             /* Insert the entry if there is nothing in the dictionary which matches the key, otherwise replaces the existing matched entries with the input entry. */
  625. };
  627. /* This Was InsertMode */
  629. typedef short                           DictionaryDataInsertMode;
  630. enum {
  631.                                                                 /* Key attribute constants */
  632.     kIsCaseSensitive            = 0x10,                         /* case sensitive = 16       */
  633.     kIsNotDiacriticalSensitive  = 0x20                          /* diac not sensitive = 32    */
  634. };
  636. enum {
  637.                                                                 /* Registered attribute type constants.   */
  638.     kNoun                       = -1,
  639.     kVerb                       = -2,
  640.     kAdjective                  = -3,
  641.     kAdverb                     = -4
  642. };
  644. /* This Was AttributeType */
  645. typedef SInt8                           DictionaryEntryAttribute;
  646. /* Dictionary information record */
  648. struct DictionaryInformation {
  649.     FSSpec                          dictionaryFSSpec;
  650.     SInt32                          numberOfRecords;
  651.     SInt32                          currentGarbageSize;
  652.     ScriptCode                      script;
  653.     SInt16                          maximumKeyLength;
  654.     SInt8                           keyAttributes;
  655. };
  656. typedef struct DictionaryInformation    DictionaryInformation;
  658. struct DictionaryAttributeTable {
  659.     UInt8                           datSize;
  660.     DictionaryEntryAttribute        datTable[1];
  661. };
  662. typedef struct DictionaryAttributeTable DictionaryAttributeTable;
  663. typedef DictionaryAttributeTable *      DictionaryAttributeTablePtr;
  664. #if CALL_NOT_IN_CARBON
  665. EXTERN_API( OSErr )
  666. InitializeDictionary            (const FSSpec *         theFsspecPtr,
  667.                                  SInt16                 maximumKeyLength,
  668.                                  SInt8                  keyAttributes,
  669.                                  ScriptCode             script)                             THREEWORDINLINE(0x303C, 0x0500, 0xAA53);
  671. EXTERN_API( OSErr )
  672. OpenDictionary                  (const FSSpec *         theFsspecPtr,
  673.                                  SInt8                  accessPermission,
  674.                                  SInt32 *               dictionaryReference)                THREEWORDINLINE(0x303C, 0x0501, 0xAA53);
  676. EXTERN_API( OSErr )
  677. CloseDictionary                 (SInt32                 dictionaryReference)                THREEWORDINLINE(0x303C, 0x0202, 0xAA53);
  679. EXTERN_API( OSErr )
  680. InsertRecordToDictionary        (SInt32                 dictionaryReference,
  681.                                  ConstStr255Param       key,
  682.                                  Handle                 recordDataHandle,
  683.                                  DictionaryDataInsertMode  whichMode)                       THREEWORDINLINE(0x303C, 0x0703, 0xAA53);
  685. EXTERN_API( OSErr )
  686. DeleteRecordFromDictionary      (SInt32                 dictionaryReference,
  687.                                  ConstStr255Param       key)                                THREEWORDINLINE(0x303C, 0x0404, 0xAA53);
  689. EXTERN_API( OSErr )
  690. FindRecordInDictionary          (SInt32                 dictionaryReference,
  691.                                  ConstStr255Param       key,
  692.                                  DictionaryAttributeTablePtr  requestedAttributeTablePointer,
  693.                                  Handle                 recordDataHandle)                   THREEWORDINLINE(0x303C, 0x0805, 0xAA53);
  695. EXTERN_API( OSErr )
  696. FindRecordByIndexInDictionary   (SInt32                 dictionaryReference,
  697.                                  SInt32                 recordIndex,
  698.                                  DictionaryAttributeTablePtr  requestedAttributeTablePointer,
  699.                                  Str255                 recordKey,
  700.                                  Handle                 recordDataHandle)                   THREEWORDINLINE(0x303C, 0x0A06, 0xAA53);
  702. EXTERN_API( OSErr )
  703. GetDictionaryInformation        (SInt32                 dictionaryReference,
  704.                                  DictionaryInformation * theDictionaryInformation)          THREEWORDINLINE(0x303C, 0x0407, 0xAA53);
  706. EXTERN_API( OSErr )
  707. CompactDictionary               (SInt32                 dictionaryReference)                THREEWORDINLINE(0x303C, 0x0208, 0xAA53);
  712. #endif  /* CALL_NOT_IN_CARBON */
  715. #if PRAGMA_STRUCT_ALIGN
  716.     #pragma options align=reset
  717. #elif PRAGMA_STRUCT_PACKPUSH
  718.     #pragma pack(pop)
  719. #elif PRAGMA_STRUCT_PACK
  720.     #pragma pack()
  721. #endif
  723. #ifdef PRAGMA_IMPORT_OFF
  724. #pragma import off
  725. #elif PRAGMA_IMPORT
  726. #pragma import reset
  727. #endif
  729. #ifdef __cplusplus
  730. }
  731. #endif
  733. #endif /* __DICTIONARY__ */