filespecmac.h
上传用户:zhongxx05
上传日期:2007-06-06
资源大小:33641k
文件大小:4k
源码类别:

Symbian

开发平台:

C/C++

  1. /* ***** BEGIN LICENSE BLOCK ***** 
  2.  * Version: RCSL 1.0/RPSL 1.0 
  3.  *  
  4.  * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
  5.  *      
  6.  * The contents of this file, and the files included with this file, are 
  7.  * subject to the current version of the RealNetworks Public Source License 
  8.  * Version 1.0 (the "RPSL") available at 
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed 
  10.  * the file under the RealNetworks Community Source License Version 1.0 
  11.  * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
  12.  * in which case the RCSL will apply. You may also obtain the license terms 
  13.  * directly from RealNetworks.  You may not use this file except in 
  14.  * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
  15.  * applicable to this file, the RCSL.  Please see the applicable RPSL or 
  16.  * RCSL for the rights, obligations and limitations governing use of the 
  17.  * contents of the file.  
  18.  *  
  19.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  20.  * developer of the Original Code and owns the copyrights in the portions 
  21.  * it created. 
  22.  *  
  23.  * This file, and the files included with this file, is distributed and made 
  24.  * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
  25.  * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
  26.  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
  27.  * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
  28.  * 
  29.  * Technology Compatibility Kit Test Suite(s) Location: 
  30.  *    http://www.helixcommunity.org/content/tck 
  31.  * 
  32.  * Contributor(s): 
  33.  *  
  34.  * ***** END LICENSE BLOCK ***** */ 
  35. #ifndef FILESPECMAC_H
  36. #define FILESPECMAC_H
  37. #ifdef _CARBON
  38. #define USE_FSREFS 1
  39. #endif
  40. #include "hxstring.h"
  41. // CAliasHandler are the internal component of CHXFileSpecifier and CHXDirSpecifier
  42. // on the Mac. 
  43. class CAliasHandler
  44. {
  45. private:
  46. AliasHandle m_alias;
  47. #ifdef _DEBUG
  48. CHXString m_strReadOnlyPath; // shows path during debugging
  49. const char * m_pszReadOnlyPath; // easier to see path during debugging
  50. void  UpdateReadOnlyPath();
  51. #else
  52. inline void  UpdateReadOnlyPath() {};
  53. #endif
  54. static HX_RESULT StuffHexHandle(Handle hData, Handle hHexHandle);
  55. static HX_RESULT UnstuffHexHandle(Handle hHex, Handle hData);
  56. static OSErr ResolveRelativeAliasQuiet(AliasHandle alias,
  57. FSSpec *target, Boolean *changed);
  58. static OSErr ResolveAliasQuiet(const FSSpec *fromFile, AliasHandle alias,
  59. FSSpec *target, Boolean *changed);
  60. #ifdef USE_FSREFS
  61. static OSErr ResolveRelativeAliasQuietToRef(AliasHandle alias,
  62. FSRef *target, Boolean *changed);
  63. #endif
  64. public:
  65. CAliasHandler();
  66. CAliasHandler(const FSSpec& spec);
  67. CAliasHandler(AliasHandle alis);
  68. CAliasHandler(const char* psz);
  69. #ifdef USE_FSREFS
  70. CAliasHandler(const FSRef& ref);
  71. #endif
  72. virtual ~CAliasHandler();
  73. CAliasHandler& operator=(CAliasHandler &other);
  74. BOOL operator==(const CAliasHandler &other);
  75. BOOL operator!=(const CAliasHandler &other);
  76. operator FSSpec() const;
  77. #ifdef USE_FSREFS
  78. operator FSRef() const;
  79. CHXString GetPOSIXPath() const;
  80. HX_RESULT SetFromPOSIXPath(const char *pPosixPath);
  81. #endif
  82. BOOL IsSet() const; // object has been set to a file (which may or may not exist)
  83. void Unset();
  84. void DisposeAlias();
  85. CHXString GetPathName() const;
  86. CHXString GetName() const; // get the leaf item name
  87. OSErr GetParentDirectorySpec(FSSpec &parent) const;
  88. OSErr GetVolumeSpec(FSSpec &parent) const; // get a specifier for the disk
  89. void CopyAlias(const CAliasHandler& other);
  90. CHXString GetPersistentString() const;
  91. CHXString GetRelativePersistentString(const CAliasHandler& anchor) const;
  92. HX_RESULT SetFromPersistentString(const char *pBuffer);
  93. CHXString MakePersistentStringForAlias(AliasHandle theAlias) const;
  94. };
  95. #endif // FILESPECMAC_H