Denetim Masası İleti İşleme

CPlApplet geri çağırma işlevi, Denetim Masası öğesine gönderilen tüm iletileri Windows tarafından işler. İşleve gönderilen iletiler belirli bir sıradadır. Aynı belirteçle, .cpl öğesi iletilerin belirli bir şekilde işlenmesini gerektirir.

İlk olarak, CPlApplet işlevi, Windows Denetim Masası öğesini ilk kez yüklediğinde CPL_INIT iletisini alır. işlevi, bellek ayırma gibi herhangi bir başlatma gerçekleştirmeli ve sıfır olmayan bir değer döndürmelidir. CPlApplet başlatmayı tamamlayamazsa, bunun sonucunda Windows'un iletişimi sonlandırması ve DLL'yi serbest bırakması için sıfır döndürmelidir.

Ardından, CPL_INIT iletisi başarılı olursa Windows CPL_GETCOUNT iletisini gönderir. İşlev daha sonra .dll dosyası tarafından desteklenen Denetim Masası öğelerinin sayısını döndürmelidir.

CPlApplet işlevi, .dll dosyası tarafından desteklenen her Denetim Masası öğesi için bir CPL_INQUIRE iletiyi ve bir CPL_NEWINQUIRE iletiyi alır. İşlev, öğenizle ilgili ad, simge ve açıklayıcı bir dize gibi bilgilerle CPLINFO veya NEWCPLINFO yapısını doldurur. Uygulamaların çoğu CPL_INQUIRE iletisini işlemeli ve CPL_NEWINQUIRE iletisini yoksamalıdır. CPL_INQUIRE iletisi, Windows'un önbelleğe alabildiği bir biçimde bilgi sağlar ve bu da çok daha iyi performans sağlar. CPL_NEWINQUIRE iletisi yalnızca öğenin simgesini veya görüntü dizelerini bilgisayarın durumuna göre değiştirmeniz gerektiğinde kullanılır. CPL_NEWINQUIRE kullanan Denetim Masası öğeleri, önbelleğe almayı kullandığından Windows Vista'da Başlat menü araması tarafından bulunamaz.

CPlApplet işlevi, kullanıcının Denetim Masası öğesini temsil eden simgeyi seçtiğine ilişkin bir bildirim olarak bir CPL_DBLCLK iletisi alır. İşlev bu iletiyi birkaç kez alabilir. İleti, CPL_INQUIRE veya CPL_NEWINQUIREçağrısında CPLINFO veya NEWCPLINFO yapısında döndürülen öğe tanımlayıcısını ve lpData işaretçisini içerir. İşlev, ilgili iletişim kutusunu görüntülemeli ve sonraki kullanıcı girişini işlemelidir.

CPL_DBLCLK yanı sıra, bir Denetim Masası öğesi komut isteminden veya başka bir programdan gibi giriş parametreleriyle çağrılırsa CPL_STARTWPARMS iletisi gönderilebilir. İleti, ek parametre dizesiyle birlikte öğe tanımlayıcısını içerir.

Denetim uygulaması sonlandırılmadan önce, CPlApplet .dll dosyası tarafından desteklenen her Denetim Masası öğesi için CPL_STOP iletisini bir kez alır. İleti, Denetim Masası öğesinin tanımlayıcısını ve CPL_INQUIRE veya CPL_NEWINQUIREçağrısında CPLINFO veya NEWCPLINFO yapısında döndürülen lpData işaretçisini içerir. İşlev, belirtilen iletişim kutusu için ayırmış olduğu tüm belleği boşaltmalıdır.

Son CPL_STOP iletiden sonra CPlApplet bir CPL_EXIT iletisi alır. İşlev, kalan tüm ayrılmış belleği boşaltmalı ve kaydetmiş olabileceği özel pencere sınıflarının kaydını kaldırmalıdır. İşlev bu iletiden döndükten hemen sonra Windows, FreeLibrary işlevini çağırarak Denetim Masası öğesini serbest bırakır.

İlgili konular

Denetim Masası Öğeleri

Kullanıcı Deneyimi Yönergeleri

Denetim Masası Öğelerini Kaydetme

CPLApplet Kullanarak

Denetim Masası Öğelerini Çalıştırma

Sistem Denetim Masası Öğelerini Genişletme

Denetim Masası Kategorileri Atama

Denetim Masası Öğesi için Aranabilir Görev Bağlantıları Oluşturma

Windows Vista altında Güvenli Modda Denetim Masası'na Erişme