src/TortoiseShell/IconOverlay.cpp

   1 // TortoiseGit - a Windows shell extension for easy version control
   2
   3 // Copyright (C) 2003-2008 - TortoiseSVN
   4
   5 // This program is free software; you can redistribute it and/or
   6 // modify it under the terms of the GNU General Public License
   7 // as published by the Free Software Foundation; either version 2
   8 // of the License, or (at your option) any later version.
   9
  10 // This program is distributed in the hope that it will be useful,
  11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 // GNU General Public License for more details.
  14
  15 // You should have received a copy of the GNU General Public License
  16 // along with this program; if not, write to the Free Software Foundation,
  17 // 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18 //
  19 #include "stdafx.h"
  20 #include "ShellExt.h"
  21 #include "Guids.h"
  22 #include "PreserveChdir.h"
  23 #include "UnicodeUtils.h"
  24 #include "GitStatus.h"
  25 #include "..\TGitCache\CacheInterface.h"
  26
  27 // "The Shell calls IShellIconOverlayIdentifier::GetOverlayInfo to request the
  28 //  location of the handler's icon overlay. The icon overlay handler returns
  29 //  the name of the file containing the overlay image, and its index within
  30 //  that file. The Shell then adds the icon overlay to the system image list."
  31
  32 STDMETHODIMP CShellExt::GetOverlayInfo(LPWSTR /*pwszIconFile*/, int /*cchMax*/, int * /*pIndex*/, DWORD * /*pdwFlags*/)
  33 {
  34         PreserveChdir preserveChdir;
  35
  36         // Now here's where we can find out if due to lack of enough overlay
  37         // slots some of our overlays won't be shown.
  38         // To do that we have to mark every overlay handler that's successfully
  39         // loaded, so we can later check if some are missing
  40         switch (m_State)
  41         {
  42                 case FileStateVersioned                         : g_normalovlloaded = true; break;
  43                 case FileStateModified                          : g_modifiedovlloaded = true; break;
  44                 case FileStateConflict                          : g_conflictedovlloaded = true; break;
  45                 case FileStateDeleted                           : g_deletedovlloaded = true; break;
  46                 case FileStateReadOnly                          : g_readonlyovlloaded = true; break;
  47                 case FileStateLockedOverlay                     : g_lockedovlloaded = true; break;
  48                 case FileStateAddedOverlay                      : g_addedovlloaded = true; break;
  49                 case FileStateIgnoredOverlay            : g_ignoredovlloaded = true; break;
  50                 case FileStateUnversionedOverlay        : g_unversionedovlloaded = true; break;
  51         }
  52
  53         // we don't have to set the icon file and/or the index here:
  54         // the icons are handled by the TortoiseOverlays dll.
  55         return S_OK;
  56 };
  57
  58 STDMETHODIMP CShellExt::GetPriority(int *pPriority)
  59 {
  60         switch (m_State)
  61         {
  62                 case FileStateConflict:
  63                         *pPriority = 0;
  64                         break;
  65                 case FileStateModified:
  66                         *pPriority = 1;
  67                         break;
  68                 case FileStateDeleted:
  69                         *pPriority = 2;
  70                         break;
  71                 case FileStateReadOnly:
  72                         *pPriority = 3;
  73                         break;
  74                 case FileStateLockedOverlay:
  75                         *pPriority = 4;
  76                         break;
  77                 case FileStateAddedOverlay:
  78                         *pPriority = 5;
  79                         break;
  80                 case FileStateVersioned:
  81                         *pPriority = 6;
  82                         break;
  83                 default:
  84                         *pPriority = 100;
  85                         return S_FALSE;
  86         }
  87         return S_OK;
  88 }
  89
  90 // "Before painting an object's icon, the Shell passes the object's name to
  91 //  each icon overlay handler's IShellIconOverlayIdentifier::IsMemberOf
  92 //  method. If a handler wants to have its icon overlay displayed,
  93 //  it returns S_OK. The Shell then calls the handler's
  94 //  IShellIconOverlayIdentifier::GetOverlayInfo method to determine which icon
  95 //  to display."
  96
  97 STDMETHODIMP CShellExt::IsMemberOf(LPCWSTR pwszPath, DWORD /*dwAttrib*/)
  98 {
  99         PreserveChdir preserveChdir;
 100         git_wc_status_kind status = git_wc_status_none;
 101         bool readonlyoverlay = false;
 102         bool lockedoverlay = false;
 103         if (pwszPath == NULL)
 104                 return S_FALSE;
 105         const TCHAR* pPath = pwszPath;
 106
 107         // the shell sometimes asks overlays for invalid paths, e.g. for network
 108         // printers (in that case the path is "0", at least for me here).
 109         if (_tcslen(pPath)<2)
 110                 return S_FALSE;
 111         // since the shell calls each and every overlay handler with the same filepath
 112         // we use a small 'fast' cache of just one path here.
 113         // To make sure that cache expires, clear it as soon as one handler is used.
 114
 115         AutoLocker lock(g_csGlobalCOMGuard);
 116         if (_tcscmp(pPath, g_filepath.c_str())==0)
 117         {
 118                 status = g_filestatus;
 119                 readonlyoverlay = g_readonlyoverlay;
 120                 lockedoverlay = g_lockedoverlay;
 121         }
 122         else
 123         {
 124                 if (!g_ShellCache.IsPathAllowed(pPath))
 125                 {
 126                         int drivenumber = -1;
 127                         if ((m_State == FileStateVersioned) && g_ShellCache.ShowExcludedAsNormal() &&
 128                                 ((drivenumber=PathGetDriveNumber(pPath))!=0)&&(drivenumber!=1) &&
 129                                 PathIsDirectory(pPath) && g_ShellCache.HasGITAdminDir(pPath, true))
 130                         {
 131                                 return S_OK;
 132                         }
 133                         return S_FALSE;
 134                 }
 135
 136                 switch (g_ShellCache.GetCacheType())
 137                 {
 138                 case ShellCache::exe:
 139                         {
 140                                 CTGitPath tpath(pPath);
 141                                 if(!tpath.HasAdminDir())
 142                                 {
 143                                         status = git_wc_status_none;
 144                                         break;
 145                                 }
 146                                 if(tpath.IsAdminDir())
 147                                 {
 148                                         status = git_wc_status_none;
 149                                         break;
 150                                 }
 151                                 TGITCacheResponse itemStatus;
 152                                 SecureZeroMemory(&itemStatus, sizeof(itemStatus));
 153                                 if (m_remoteCacheLink.GetStatusFromRemoteCache(tpath, &itemStatus, true))
 154                                 {
 155                                         status = GitStatus::GetMoreImportant(itemStatus.m_status.text_status, itemStatus.m_status.prop_status);
 156 /*                                      if ((itemStatus.m_kind == git_node_file)&&(status == git_wc_status_normal)&&((itemStatus.m_needslock && itemStatus.m_owner[0]==0)||(itemStatus.m_readonly)))
 157                                                 readonlyoverlay = true;
 158                                         if (itemStatus.m_owner[0]!=0)
 159                                                 lockedoverlay = true;*/
 160                                 }
 161                         }
 162                         break;
 163                 case ShellCache::dll:
 164                 case ShellCache::dllFull:
 165                         {
 166                                 // Look in our caches for this item
 167                                 const FileStatusCacheEntry * s = m_CachedStatus.GetCachedItem(CTGitPath(pPath));
 168                                 if (s)
 169                                 {
 170                                         status = s->status;
 171                                 }
 172                                 else
 173                                 {
 174                                         // No cached status available
 175
 176                                         // since the dwAttrib param of the IsMemberOf() function does not
 177                                         // have the SFGAO_FOLDER flag set at all (it's 0 for files and folders!)
 178                                         // we have to check if the path is a folder ourselves :(
 179                                         if (PathIsDirectory(pPath))
 180                                         {
 181                                                 if (g_ShellCache.HasGITAdminDir(pPath, TRUE))
 182                                                 {
 183                                                         if ((!g_ShellCache.IsRecursive()) && (!g_ShellCache.IsFolderOverlay()))
 184                                                         {
 185                                                                 status = git_wc_status_normal;
 186                                                         }
 187                                                         else
 188                                                         {
 189                                                                 const FileStatusCacheEntry * s = m_CachedStatus.GetFullStatus(CTGitPath(pPath), TRUE);
 190                                                                 status = s->status;
 191                                                                 // GitFolderStatus does not list unversioned files/dir so they would always end up as normal below
 192                                                                 // so let's assume file/dir is unversioned if not found in cache
 193                                                                 /*// sub-dirs that are empty (or contain no versioned files) are reported as unversioned (and should be kept as such)
 194                                                                 if (status != git_wc_status_unversioned)
 195                                                                 {
 196                                                                         // if get status fails then display status as 'normal' on folder (since it contains .git)
 197                                                                         // TODO: works for svn since each folder has .svn, not sure if git needs additinoal processing
 198                                                                         status = GitStatus::GetMoreImportant(git_wc_status_normal, status);
 199                                                                 }*/
 200                                                         }
 201                                                 }
 202                                                 else
 203                                                 {
 204                                                         status = git_wc_status_none;
 205                                                 }
 206                                         }
 207                                         else
 208                                         {
 209                                                 const FileStatusCacheEntry * s = m_CachedStatus.GetFullStatus(CTGitPath(pPath), FALSE);
 210                                                 status = s->status;
 211                                         }
 212                                 }
 213 #if 0
 214                                 if ((s)&&(status == git_wc_status_normal)&&(s->needslock)&&(s->owner[0]==0))
 215                                         readonlyoverlay = true;
 216                                 if ((s)&&(s->owner[0]!=0))
 217                                         lockedoverlay = true;
 218 #endif
 219                         }
 220
 221                         break;
 222                 default:
 223                 case ShellCache::none:
 224                         {
 225                                 // no cache means we only show a 'versioned' overlay on folders
 226                                 // with an admin directory
 227                                 if (PathIsDirectory(pPath))
 228                                 {
 229                                         if (g_ShellCache.HasGITAdminDir(pPath, TRUE))
 230                                         {
 231                                                 status = git_wc_status_normal;
 232                                         }
 233                                         else
 234                                         {
 235                                                 status = git_wc_status_none;
 236                                         }
 237                                 }
 238                                 else
 239                                 {
 240                                         status = git_wc_status_none;
 241                                 }
 242                         }
 243                         break;
 244                 }
 245                 ATLTRACE(_T("Status %d for file %s\n"), status, pwszPath);
 246         }
 247         g_filepath.clear();
 248         g_filepath = pPath;
 249         g_filestatus = status;
 250         g_readonlyoverlay = readonlyoverlay;
 251         g_lockedoverlay = lockedoverlay;
 252
 253         //the priority system of the shell doesn't seem to work as expected (or as I expected):
 254         //as it seems that if one handler returns S_OK then that handler is used, no matter
 255         //if other handlers would return S_OK too (they're never called on my machine!)
 256         //So we return S_OK for ONLY ONE handler!
 257
 258         switch (status)
 259         {
 260                 // note: we can show other overlays if due to lack of enough free overlay
 261                 // slots some of our overlays aren't loaded. But we assume that
 262                 // at least the 'normal' and 'modified' overlay are available.
 263                 case git_wc_status_none:
 264                         return S_FALSE;
 265                 case git_wc_status_unversioned:
 266                         if (g_ShellCache.ShowUnversionedOverlay() && g_unversionedovlloaded && (m_State == FileStateUnversionedOverlay))
 267                         {
 268                                 g_filepath.clear();
 269                                 return S_OK;
 270                         }
 271                         return S_FALSE;
 272                 case git_wc_status_ignored:
 273                         if (g_ShellCache.ShowIgnoredOverlay() && g_ignoredovlloaded && (m_State == FileStateIgnoredOverlay))
 274                         {
 275                                 g_filepath.clear();
 276                                 return S_OK;
 277                         }
 278                         return S_FALSE;
 279                 case git_wc_status_normal:
 280                 case git_wc_status_external:
 281                 case git_wc_status_incomplete:
 282                         if ((readonlyoverlay)&&(g_readonlyovlloaded))
 283                         {
 284                                 if (m_State == FileStateReadOnly)
 285                                 {
 286                                         g_filepath.clear();
 287                                         return S_OK;
 288                                 }
 289                                 else
 290                                         return S_FALSE;
 291                         }
 292                         else if ((lockedoverlay)&&(g_lockedovlloaded))
 293                         {
 294                                 if (m_State == FileStateLockedOverlay)
 295                                 {
 296                                         g_filepath.clear();
 297                                         return S_OK;
 298                                 }
 299                                 else
 300                                         return S_FALSE;
 301                         }
 302                         else if (m_State == FileStateVersioned)
 303                         {
 304                                 g_filepath.clear();
 305                                 return S_OK;
 306                         }
 307                         else
 308                                 return S_FALSE;
 309                 case git_wc_status_missing:
 310                 case git_wc_status_deleted:
 311                         if (g_deletedovlloaded)
 312                         {
 313                                 if (m_State == FileStateDeleted)
 314                                 {
 315                                         g_filepath.clear();
 316                                         return S_OK;
 317                                 }
 318                                 else
 319                                         return S_FALSE;
 320                         }
 321                         else
 322                         {
 323                                 // the 'deleted' overlay isn't available (due to lack of enough
 324                                 // overlay slots). So just show the 'modified' overlay instead.
 325                                 if (m_State == FileStateModified)
 326                                 {
 327                                         g_filepath.clear();
 328                                         return S_OK;
 329                                 }
 330                                 else
 331                                         return S_FALSE;
 332                         }
 333                 case git_wc_status_replaced:
 334                 case git_wc_status_modified:
 335                         if (m_State == FileStateModified)
 336                         {
 337                                 g_filepath.clear();
 338                                 return S_OK;
 339                         }
 340                         else
 341                                 return S_FALSE;
 342                 case git_wc_status_merged:
 343                         if (m_State == FileStateReadOnly)
 344                         {
 345                                 g_filepath.clear();
 346                                 return S_OK;
 347                         }
 348                         else
 349                                 return S_FALSE;
 350                 case git_wc_status_added:
 351                         if (g_addedovlloaded)
 352                         {
 353                                 if (m_State== FileStateAddedOverlay)
 354                                 {
 355                                         g_filepath.clear();
 356                                         return S_OK;
 357                                 }
 358                                 else
 359                                         return S_FALSE;
 360                         }
 361                         else
 362                         {
 363                                 // the 'added' overlay isn't available (due to lack of enough
 364                                 // overlay slots). So just show the 'modified' overlay instead.
 365                                 if (m_State == FileStateModified)
 366                                 {
 367                                         g_filepath.clear();
 368                                         return S_OK;
 369                                 }
 370                                 else
 371                                         return S_FALSE;
 372                         }
 373                 case git_wc_status_conflicted:
 374                 case git_wc_status_obstructed:
 375                         if (g_conflictedovlloaded)
 376                         {
 377                                 if (m_State == FileStateConflict)
 378                                 {
 379                                         g_filepath.clear();
 380                                         return S_OK;
 381                                 }
 382                                 else
 383                                         return S_FALSE;
 384                         }
 385                         else
 386                         {
 387                                 // the 'conflicted' overlay isn't available (due to lack of enough
 388                                 // overlay slots). So just show the 'modified' overlay instead.
 389                                 if (m_State == FileStateModified)
 390                                 {
 391                                         g_filepath.clear();
 392                                         return S_OK;
 393                                 }
 394                                 else
 395                                         return S_FALSE;
 396                         }
 397                 default:
 398                         return S_FALSE;
 399         } // switch (status)
 400         //return S_FALSE;
 401 }
 402