Aracılığıyla paylaş


CPLApplet kullanma

Windows Vista'nın öncesinde, bir .dll dosyası oluşturup .cpl uzantısıyla adlandırarak bir Denetim Masası öğesi oluşturdunuz. Bu dosya CPlApplet işlevini dışarı aktardı. Bu düzen Windows Vista ve sonraki sürümlerde hala desteklenir ve bu konuda ele alınmıştır. Ancak, yeni Denetim Masası öğelerine yönelik yönergeler, görev akışı düzeni kullanan bir .exe dosyası olarak oluşturulmuş Denetim Masası öğesiyle daha basit bir yaklaşım önerir.

Denetim Masası bir .dll (veya .cpl) dosyası yüklediğinde, CPlApplet işlevini çağırarak, dosya konaklarının denetim masası öğelerinin sayısı ve her öğe hakkındaki bilgiler gibi bilgileri alır. Denetim Masası, öğenin penceresi başlatıldığında, açıldığında veya kapatıldığında işlevi de çağırır.

Windows Denetim Masası öğesini ilk kez yüklediğinde, CPlApplet işlevinin adresini alır ve ardından işlevi çağırmak ve ileti iletmek için bu adresi kullanır. Aşağıdaki iletileri gönderebilir.

İleti Açıklama
CPL_DBLCLK CPlApplet kullanıcının belirli bir Denetim Masası öğesiyle ilişkili simgeyi seçtiğini bildirmek için gönderilir. CPlApplet belirtilen öğenin iletişim kutusunu görüntülemeli ve kullanıcı tarafından belirtilen görevleri gerçekleştirmelidir. CPlAppletlParam1 parametresi, Denetim Masası öğesinin sıfır tabanlı dizinini temsil eden bir tamsayıdır. lParam2 parametresi, CPL_INQUIRE veya CPL_NEWINQUIRE iletisindeki CPLINFO veya NEWCPLINFO yapısında döndürülen lpData işaretçisidir. Dönüş değeri yoksayılır.
CPL_EXIT Son CPL_STOP iletisinden sonra ve Windows'un FreeLibrary işlevini kullanarak Denetim Masası öğesini içeren DLL'yi boşaltmadan hemen önce gönderilir. CPlApplet kalan tüm belleği boşaltmalı ve kapatmaya hazırlamalıdır. Dönüş değeri yoksayılır.
CPL_GETCOUNT CPL_INIT iletisinden sonra gönderilen CPlApplet kaç alt program desteklediğini belirten bir sayı döndürmesini ister.
CPL_INIT Denetim Masası öğesini içeren DLL yüklendikten hemen sonra gönderilir. İleti, CPlApplet'ten bellek ayırma gibi başlatma işlemlerini gerçekleştirmesini ister.
CPL_INQUIRE CPL_GETCOUNT iletisinden sonra, CPlApplet'ün belirtilen bir alt program hakkında bilgi sağlaması istenir. lParam1 değeri, hangi bilgilerin istendiğiyle ilgili alt birimin sıfır tabanlı dizinini temsil eden bir tamsayıdır. CPlAppletlParam2 parametresi bir CPLINFO yapısına işaret eder. Geri dönüş değeri göz ardı edilir.
CPL_NEWINQUIRE CPL_GETCOUNT iletisinden sonra, CPlApplet belirtilen Denetim Masası öğesi hakkında bilgi talep etmek amacıyla gönderilir. lParam1 değeri, hangi bilgilerin istendiğiyle ilgili alt birimin sıfır tabanlı dizinini temsil eden bir tamsayıdır. lParam2 parametresi, NEWCPLINFO yapısının işaretçisidir. CPL_NEWINQUIRE normalde yoksayılmalıdır. Uygulamanız, Denetim Masası performansı CPL_NEWINQUIRE kullanıldığında azaldığı için, yalnızca Windows 95, Microsoft Windows NT 4.0 ve daha yeni sistemlerde CPL_INQUIRE işlemelidir. Bunun nedeni, döndürülen dizelerin ve simgelerin önbelleğe alınamamasıdır. Dönüş değeri yoksayılır.
CPL_SELECT Eskimiş. Windows'un geçerli sürümleri bu iletiyi göndermez.
CPL_STARTWPARMS CPlApplet kullanıcının belirli bir iletişim kutusuyla ilişkili simgeyi seçtiğini bildirmek için gönderilir. CPlApplet ilgili iletişim kutusunu görüntülemeli ve kullanıcı tarafından belirtilen görevleri gerçekleştirmelidir. Bu ileti CPL_DBLCLK benzer, ancak bazı ek bilgiler olabilir. lParam1 parametresi Denetim Masası öğe numarasıdır ve lParam2, gerekli olabilecek ek talimatlara LPCTSTR. İleti işlenirse TRUE döndür; aksi takdirde FALSE. Bu ileti, sürüm 5.00 ve üzeri Shell32.dlliçin geçerlidir.
CPL_STOP Windows Denetim Masası uzantısını kaldırmadan önce .cpl dosyasındaki her Denetim Masası öğesi için bir kez gönderilir. CPlApplet, lParam1içinde sağlanan öğe numarasıyla ilişkili tüm belleği boşaltmalıdır. lParam2 parametresi, CPL_INQUIRE veya CPL_NEWINQUIRE iletisinde, CPLINFO veya NEWCPLINFO yapısında döndürülen lpData işaretçisidir. Dönüş değeri yoksayılır.

 

Denetim Masası Öğeleri

Kullanıcı Deneyimi Yönergeleri

Denetim Masası Öğelerini Kaydetme

Denetim Masası İleti İşleme

Kontrol Paneli Öğelerinin Yürütülmesi

Sistem Denetim Masası Öğelerini Genişletme

Denetim Masası Kategorilerini 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