Shell Uzantı İşleyicileri Oluşturma

Shell'in özellikleri kayıt defteri girdileri ve .ini dosyalarıyla genişletilebilir. Kabuğu genişletmeye yönelik bu yaklaşım basit ve birçok amaç için yeterli olsa da, sınırlıdır. Örneğin, kayıt defterini kullanarak bir dosya türü için özel bir simge belirtirseniz, bu türdeki her dosya için aynı simge görüntülenir. Kabuğun kayıt defteriyle genişletilmesi, aynı türdeki farklı dosyalara farklı simgeler atamanıza olanak tanımaz. Dosyalara sağ tıklandığında açılan Özellikleri özellik sayfası gibi Shell’in diğer yönleri, kayıt defteri ile değiştirilemez.

Kabuğu genişletmenin daha güçlü ve esnek bir yolu, kabuk uzantısı işleyicileriuygulamaktır. Bu işleyiciler, Kabuğun gerçekleştirebileceği çeşitli eylemler için uygulanabilir. Kabuk, eylemi gerçekleştirmeden önce uzantı işleyicisini sorgular ve eylemi değiştirme fırsatı verir. Kısayol menüsü uzantısı işleyicisi yaygın bir örnektir. Bir dosya türü için uygulandıysa, dosyalardan birine sağ tıklandığında sorgulanır. İşleyici daha sonra dosya türünün tamamı için aynı kümeye sahip olmak yerine dosya temelinde ek menü öğeleri belirtebilir.

Bu belgede, çeşitli Kabuk eylemlerini değiştirmenize olanak sağlayan uzantı işleyicilerinin nasıl uygulanılacağı açıklanır. Aşağıdaki işleyiciler belirli bir dosya türüyle ilişkilendirilir ve dosya temelinde belirtmenize olanak sağlar:

Diğer işleyiciler belirli bir dosya türüyle ilişkilendirilmemiştir ancak bazı Shell işlemlerinden önce çağrılır:

Belirli uzantı işleyicilerinin nasıl uygulandığıyla ilgili ayrıntılar, yukarıda listelenen bölümlerde ele alınmıştır. Bu belgenin geri kalanı, tüm Kabuk uzantısı işleyicileri için ortak olan bazı uygulama sorunlarını kapsar.

• Kabuk Uzantısı İşleyicilerini Uygulama
  • IPersistFile'i Uygulama
  • IShellExtInit'i Uygulamak
  • Bilgi İpucu Özelleştirme
• Kabuk Uzantısı İşleyicileri ile Windows Aramasını Geliştirme
• Kabuk Uzantısı İşleyicilerini Kaydetme
  • İşleyici Adları
  • Önceden Tanımlanmış Kabuk Nesneleri
  • Bir Uzantı İşleyicisi Kaydı Örneği
• İlgili konular

Shell Uzantısı İşleyicilerini Uygulama

Shell uzantısı işleyici nesnesinin uygulamasının büyük bir kısmı, nesnenin türüne bağlıdır. Ancak bazı yaygın öğeler vardır. Bu bölümde, tüm Shell uzantısı işleyicileri tarafından paylaşılan uygulama yönleri ele alınmaktadır.

Birçok Shell uzantı işleyicisi, işlem içinde çalışan Bileşen Nesne Modeli (COM) nesneleridir. Bunlara bir GUID atanmalı ve Kabuk Uzantısı İşleyicilerini Kaydetme bölümünde açıklandığı gibi kaydedilmelidir. DLL'ler olarak uygulanır ve aşağıdaki standart işlevleri dışarı aktarmaları gerekir:

• DllMain. DLL'ye standart giriş noktası.
• DllGetClassObject. Nesnenin sınıf fabrikasını açığa çıkarır.
• DllCanUnloadNow. COM, nesnenin herhangi bir istemciye hizmet verip vermediğini belirlemek için bu işlevi çağırır. Aksi takdirde sistem DLL'yi kaldırıp ilişkili belleği boşaltabilir.

Tüm COM nesneleri gibi, Kabuk uzantısı işleyicileri de IUnknown arabirimini ve sınıf fabrikasınıuygulamalı. Çoğu uzantı işleyicisi, Windows XP veya önceki sürümlerde IPersistFile veya IShellExtInit arabirimini de uygulamalıdır. Bunlar, Windows Vista'da IInitializeWithStream, IInitializeWithItem ve IInitializeWithFile ile değiştirildi. Shell, işleyiciyi başlatmak için bu arabirimleri kullanır.

IPersistFile arabirimi aşağıdakiler tarafından uygulanmalıdır:

• Veri işleyicileri
• İşleyicileri bırakma

Geçmişte, IPersistFileuygulamak için de simge işleyicileri gerekiyordu, ancak bu artık doğru değil. Simge işleyicileri için IPersistFile artık isteğe bağlıdır ve IInitializeWithItem gibi diğer arabirimler tercih edilir.

IShellExtInit arabirimi aşağıdakiler tarafından uygulanmalıdır:

• Kısayol menüsü işleyicileri
• Sürükle ve bırak işleyicileri
• Özellik sayfası işleyicileri

IPersistFile'i Uygulama

IPersistFile arabirimi, bir nesnenin disk dosyasından yüklenmesine veya disk dosyasına kaydedilmesine izin vermek için tasarlanmıştır. IUnknown, beş tane kendi yöntemine ve IPersist'dan devraldığı GetClassID yöntemine ek olarak altı yöntemi vardır. Kabuk uzantılarıyla, IPersist yalnızca bir Kabuk uzantısı işleyici nesnesi başlatmak için kullanılır. Diskten okuma veya diske yazma gereği genellikle olmadığından, yalnızca GetClassID ve Load yöntemleri için bir nontoken uygulama gereklidir.

Shell, önce GetClassIDçağırır ve işlev uzantı işleyici nesnesinin sınıf tanımlayıcısını (CLSID) döndürür. Kabuk daha sonra Load'ü çağırır ve iki değer iletir. İlki pszFileName, Shell'in üzerinde çalışmak üzere olduğu dosya veya klasörün adına sahip bir Unicode dizesidir. İkincisi dwModedosya erişim modunu gösterir. Normalde dosyalara erişmeye gerek olmadığından dwMode genellikle sıfırdır. yöntemi, bu değerleri daha sonra başvurmak için gereken şekilde depolar.

Aşağıdaki kod parçası, tipik bir Kabuk uzantısı işleyicisinin GetClassID ve Load yöntemlerini nasıl uyguladığını gösterir. ANSI veya Unicode işlemek için tasarlanmıştır. CLSID_SampleExtHandler uzantı işleyici nesnesinin GUID'si, CSampleExtHandler ise arabirimi uygulamak için kullanılan sınıfın adıdır. m_szFileName ve m_dwMode değişkenleri, dosyanın adını ve erişim bayraklarını depolamak için kullanılan özel değişkenlerdir.

wchar_t m_szFileName[MAX_PATH];    // The file name
DWORD m_dwMode;                  // The file access mode

CSampleExtHandler::GetClassID(CLSID *pCLSID)
{
    *pCLSID = CLSID_SampleExtHandler;
}

CSampleExtHandler::Load(PCWSTR pszFile, DWORD dwMode)
{
    m_dwMode = dwMode;
    return StringCchCopy(_szFileName, ARRAYSIZE(m_szFileName), pszFile);
}

IShellExtInit'i Uygulama

IShellExtInit arabirimi, IUnknownyanında yalnızca bir yöntem, IShellExtInit::Initialize, içerir. yöntemi, Shell'in çeşitli bilgi türlerini geçirmek için kullanabileceği üç parametreye sahiptir. geçirilen değerler işleyici türüne bağlıdır ve bazıları NULL olarak ayarlanabilir.

• pIDFolder bir klasörün öğe tanımlayıcı listesine (PIDL) işaretçisini saklar. Özellik sayfası uzantıları için NULL. Kısayol menüsü uzantıları için, kısayol menüsü görüntülenen öğeyi içeren klasörün PIDL'sidir. Varsayılan olmayan sürükle ve bırak işleyicileri için hedef klasörün PIDL'idir.
• pDataObject, veri nesnesinin IDataObject arabirimine bir işaretçi tutar. Veri nesnesi, CF_HDROP biçimde bir veya daha fazla dosya adını barındırıyor.
• hRegKey dosya nesnesi veya klasör türü için bir kayıt defteri anahtarı tutar.

IShellExtInit::Initialize yöntemi dosya adını, IDataObject işaretçisini ve kayıt defteri anahtarını daha sonra kullanmak üzere depolar. Aşağıdaki kod parçası, IShellExtInit::Initializeuygulamasını gösterir. Kolaylık olması için, bu örnekte veri nesnesinin yalnızca tek bir dosya içerdiği varsayılır. Genel olarak, her birinin ayıklanması gereken birden çok dosya içerebilir.

LPCITEMIDLIST  m_pIDFolder;           //The folder's PIDL
wchar_t        m_szFile[MAX_PATH];    //The file name
IDataObject   *m_pDataObj;            //The IDataObject pointer
HKEY           m_hRegKey;             //The file or folder's registry key

STDMETHODIMP CShellExt::Initialize(LPCITEMIDLIST pIDFolder, 
                                   IDataObject *pDataObj, 
                                   HKEY hRegKey) 
{ 
    // If Initialize has already been called, release the old PIDL
    ILFree(m_pIDFolder);
    m_pIDFolder = nullptr;

    // Store the new PIDL.
    if (pIDFolder)
    {
        m_pIDFolder = ILClone(pIDFolder);
    }
    
    // If Initialize has already been called, release the old
    // IDataObject pointer.
    if (m_pDataObj)
    { 
        m_pDataObj->Release(); 
    }
     
    // If a data object pointer was passed in, save it and
    // extract the file name. 
    if (pDataObj) 
    { 
        m_pDataObj = pDataObj; 
        pDataObj->AddRef(); 
      
        STGMEDIUM   medium;
        FORMATETC   fe = {CF_HDROP, NULL, DVASPECT_CONTENT, -1, TYMED_HGLOBAL};
        UINT        uCount;

        if (SUCCEEDED(m_pDataObj->GetData(&fe, &medium)))
        {
            // Get the count of files dropped.
            uCount = DragQueryFile((HDROP)medium.hGlobal, (UINT)-1, NULL, 0);

            // Get the first file name from the CF_HDROP.
            if (uCount)
                DragQueryFile((HDROP)medium.hGlobal, 0, m_szFile, 
                              sizeof(m_szFile)/sizeof(TCHAR));

            ReleaseStgMedium(&medium);
        }
    }

    // Duplicate the registry handle. 
    if (hRegKey) 
        RegOpenKeyEx(hRegKey, nullptr, 0L, MAXIMUM_ALLOWED, &m_hRegKey); 
    return S_OK; 
}

CSampleExtHandler, arabirimi uygulamak için kullanılan sınıfın adıdır. m_pIDFolder, m_pDataObject, m_szFileNameve m_hRegKey değişkenleri, geçirilen bilgileri depolamak için kullanılan özel değişkenlerdir. Kolaylık olması için, bu örnekte veri nesnesi tarafından yalnızca bir dosya adının tutulacağı varsayılır. FORMATETC yapısı veri nesnesinden alındıktan sonra, FORMATETC yapısının medium.hGlobal üyesinden dosya adını ayıklamak için DragQueryFile kullanılır. Bir kayıt defteri anahtarı verilirse, yöntem önce RegOpenKeyEx kullanarak anahtarı açar ve ardından tanıtıcıyı m_hRegKeyatar.

Bilgi İpucu Özelleştirmesi

Bilgi ipuçlarını özelleştirmenin iki yolu vardır:

• IQueryInfo destekleyen bir nesne uygulayın ve ardından bu nesneyi kayıt defterindeki uygun alt anahtara kaydedin (aşağıdaki Kabuk Uzantısı İşleyicilerini Kaydetme bakın).
• Görüntülenecek belirli dosya özelliklerinin listesini veya sabit bir dize belirtin.

Ad alanı uzantısının sabit dizesini görüntülemek için, ad alanı uzantınızın {CLSID} anahtarında InfoTip adlı bir girdi oluşturun. Bu girdinin değerini, bu örnekte gösterildiği gibi görüntülemek istediğiniz değişmez değer dizesi veya bu kaynak içinde bir kaynak ve dizin belirten dolaylı bir dize olacak şekilde ayarlayın (yerelleştirme amacıyla).

HKEY_CLASSES_ROOT
   CLSID
      {CLSID}
         InfoTip = InfoTip string for your namespace extension

Bir dosya türünün sabit dizesini görüntülemek için, bu dosya türünün ProgID anahtarında InfoTip adlı bir girdi oluşturun. Bu girdinin değerini, görüntülemek istediğiniz değişmez değer dizesi veya bu örnekte gösterildiği gibi bu kaynak içinde bir kaynak ve dizin belirten dolaylı bir dize (yerelleştirme amacıyla) olarak ayarlayın.

HKEY_CLASSES_ROOT
   ProgID
      InfoTip = Resource.dll, 3

Shell'in belirli bir dosya türünün bilgi ipucunda belirli dosya özelliklerini görüntülemesini istiyorsanız, bu dosya türü için ProgID anahtarında InfoTip adlı bir girdi oluşturun. Bu girdinin değerini kurallı özellik adlarının, biçim tanımlayıcısının (FMTID)/özellik tanımlayıcısı (PID) çiftlerinin veya her ikisinin noktalı virgülle ayrılmış listesi olarak ayarlayın. Bu değerin özellik listesi dizesi olarak tanımlanması için "prop:" ile başlaması gerekir. "prop:" değerini atlarsanız, değer değişmez dize olarak görülür ve bu şekilde görüntülenir.

Aşağıdaki örnekte, propname kurallı bir özellik adıdır (System.Date gibi) ve {fmtid},pidbir FMTID/PID çiftidir.

HKEY_CLASSES_ROOT
   ProgID
      InfoTip = prop:propname;propname;{fmtid},pid;{fmtid},pid

Aşağıdaki özellik adları kullanılabilir:

Kabuk Uzantısı İşleyicileri ile Windows Search'i Geliştirme

Kabuk uzantısı işleyicileri, Windows Search protokol işleyicisi tarafından sağlanan kullanıcı deneyimini geliştirmek için kullanılabilir. Bu tür geliştirmeleri etkinleştirmek için destekleyici Kabuk uzantısı işleyicisi, arama protokolü işleyicisi ile veri kaynağı olarak tümleştirilecek şekilde tasarlanmalıdır. Kabuk uzantısı işleyicisi ile tümleştirme yoluyla Windows Search protokol işleyicisini geliştirme hakkında bilgi için bkz. Simgeler, Önizlemeler ve Kısayol Menüleri Ekleme. Windows Search protokol işleyicileri hakkında daha fazla bilgi için bkz. Protokol İşleyicileri Geliştirme.

Kabuk Uzantısı İşleyicilerini Kaydetme

Shell'in kullanabilmesi için bir Kabuk uzantısı işleyici nesnesinin kaydedilmesi gerekir. Bu bölüm, kabuk uzantı işleyicisinin nasıl kaydedileceğine dair genel bir tartışmadır.

Kabuk uzantısı işleyicisini her oluşturduğunuzda veya değiştirdiğinizde, SHChangeNotifykullanarak bir değişiklik yaptığınızı sisteme bildirmeniz önemlidir, bu bildiride SHCNE_ASSOCCHANGED olayını belirtin. SHChangeNotifyçağrısı yapmazsanız, sistem yeniden başlatılana kadar değişiklik tanınmayabilir.

Tüm COM nesnelerde olduğu gibi, UUIDGEN.exegibi bir araç kullanarak işleyici için bir GUID oluşturmanız gerekir. HKEY_CLASSES_ROOT\CLSID altında, adı GUID'nin dize biçimi olan bir anahtar oluşturun. Kabuk uzantısı işleyicileri işlem içi sunucular olduğu için, GUID anahtarı altında işleyicinin DLL yoluna varsayılan değeri ayarlanmış bir InProcServer32 anahtarı oluşturmanız gerekir. Apartment iş parçacığı modelini kullanın.

Shell, Shell uzantı işleyicisini içerebilecek bir eylem gerçekleştirdiğinde, uygun kayıt defteri anahtarını kontrol eder. Bir uzantı işleyicisinin kayıtlı olduğu anahtar, ne zaman çağrılacağını denetler. Örneğin, Kabuk birdosya türünün üyesi için bir kısayol menüsü görüntülediğinde adlı bir kısayol menüsü işleyicisinin olması yaygın bir uygulamadır. Bu durumda işleyici, dosya türünün ProgID anahtarı altında kaydedilmelidir.

İşleyici Adları

Kabuk uzantısı işleyicisini etkinleştirmek için, ProgID (dosya türleri için) veya Önceden Tanımlanmış Kabuk Nesneleriiçin Kabuk nesne türü adının ShellEx alt anahtarı altında, işleyici alt anahtar adıyla bir alt anahtar oluşturun.

Örneğin, MyProgram.1 için bir kısayol menüsü uzantısı işleyicisi kaydetmek istiyorsanız, aşağıdaki alt anahtarı oluşturarak başlarsınız:

HKEY_CLASSES_ROOT
   MyProgram.1
      ShellEx
         ContextMenuHandlers

Aşağıdaki işleyiciler için, adı Shell uzantısının CLSID'sinin dize sürümü olan "İşleyici Alt Anahtarı adı" anahtarının altında bir alt anahtar oluşturun. Birden çok alt anahtar oluşturularak işleyici alt anahtarı adı altında birden çok uzantı kaydedilebilir.

Aşağıdaki işleyiciler için, "İşleyici Alt Anahtarı Adı" anahtarının varsayılan değeri, Kabuk uzantısının CLSID'sinin dize sürümüdür. Bu işleyiciler için yalnızca bir uzantı kaydedilebilir.

Başlat Menüsüne Sabitle eklemek için belirtilen alt anahtarlar ve bir öğenin kısayol menüsüne Görev Çubuğuna Sabitle yalnızca IsShortCut girdisini içeren dosya türleri için gereklidir.

Windows Vista'da sütun sağlayıcısı işleyicileri desteği kaldırıldı. Ayrıca, Windows Vista'da IPropertySetStorage, IPropertyStorelehine kullanım dışı bırakılmıştır.

IExtractImage desteklenmeye devam etse de, IThumbnailProvider Windows Vista ve sonraki sürümler için tercih edilir.

Önceden Tanımlanmış Kabuk Nesneleri

Kabuk, HKEY_CLASSES_ROOT altında dosya türleriyle aynı şekilde genişletilebilen ek nesneler tanımlar. Örneğin, tüm dosyalar için bir özellik sayfası işleyicisi eklemek için PropertySheetHandlers anahtarına kaydolabilirsiniz.

HKEY_CLASSES_ROOT
   *
      shellex
         PropertySheetHandlers

Aşağıdaki tablo, uzantı işleyicilerinin kaydedilebileceği çeşitli HKEY_CLASSES_ROOT alt anahtarlarını verir. Listelenen alt anahtarların tümü altında birçok uzantı işleyicisinin kaydedilemeyeceğini unutmayın. Diğer ayrıntılar için belirli işleyicinin belgelerine bakın.

Notlar:

• Dosya klasörü arka plan kısayol menüsüne, bir dosya klasörünün içinde sağ tıklayarak erişilir, ancak klasörün içeriklerinden herhangi birinin üzerine erişemezsiniz.
• "Fiiller", HKEY_CLASSES_ROOT\Alt Anahtar\Kabuk\Fiil altında kaydedilen özel komutlardır.
• Ağ\Türü\# için , "#" ondalık olarak bir ağ sağlayıcısı türü kodudur. Ağ sağlayıcısı türü kodu, bir ağ türünün yüksek sözcüğüdür. Ağ türlerinin listesi Winnetwk.h üst bilgi dosyasında (WNNC_NET_* değerler) verilir. Örneğin, WNNC_NET_SHIVA 0x00330000 olduğundan ilgili tür anahtarı HKEY_CLASSES_ROOT\Ağ\Türü\51 olacaktır.
• "network_provider_name", WNetGetProviderNametarafından belirtilen bir ağ sağlayıcısı adıdır ve boşluklar alt çizgiye dönüştürülür. Örneğin, Microsoft Ağ sağlayıcısı yüklüyse, sağlayıcı adı "Microsoft Windows Network" olur ve karşılık gelen network_provider_nameMicrosoft_Windows_Networkolarak belirlenir.

Uzantı İşleyicisi Kaydı Örneği

Belirli bir işleyiciyi etkinleştirmek için, uzantı işleyici türü anahtarı altında işleyicinin adıyla bir alt anahtar oluşturun. Shell işleyicinin adını kullanmaz, ancak bu tür alt anahtar altındaki diğer tüm adlardan farklı olmalıdır. Ad alt anahtarının varsayılan değerini işleyicinin GUID'sinin dize biçimine ayarlayın.

Aşağıdaki örnekte, örnek bir .myp dosya türü kullanılarak kısayol menüsü ve özellik sayfası uzantısı işleyicilerini etkinleştiren kayıt defteri girdileri gösterilmektedir:

HKEY_CLASSES_ROOT
   .myp
      (Default) = MyProgram.1
   CLSID
      {00000000-1111-2222-3333-444444444444}
         InProcServer32
            (Default) = C:\MyDir\MyCommand.dll
            ThreadingModel = Apartment
      {11111111-2222-3333-4444-555555555555}
         InProcServer32
            (Default) = C:\MyDir\MyPropSheet.dll
            ThreadingModel = Apartment
   MyProgram.1
      (Default) = MyProgram Application
      Shellex
         ContextMenuHandler
            MyCommand
               (Default) = {00000000-1111-2222-3333-444444444444}
         PropertySheetHandlers
            MyPropSheet
               (Default) = {11111111-2222-3333-4444-555555555555}

Bu bölümde açıklanan kayıt yordamı tüm Windows sistemleri için izlenmelidir.

İlgili konular

Uzantıların Uygulanması için Yönerge In-Process