DialogBoxParam

DialogBoxParam işlevi, bir iletişim kutusunda şablon kaynaktan için kalıcı bir iletişim kutusu oluşturur. İletişim kutusu görüntülemeden önce işlevi bir uygulama tanımlı değeri iletişim kutusunu yordama WM_INITDIALOG iletisinin lParam parametresinin geçirir. Uygulama iletişim kutusu denetimlerini başlatmak için bu değeri kullanın.

int DialogBoxParam) HINSTANCE  HINSTANCE, / / işlemek için uygulama örneğilpctstrlpTemplateName, / / iletişim kutusunda şablonu tanımlarhwndhWndParent, / / ele sahip pencereyedlgproclpDialogFunc, / / iletişim için İşaretçi kutu yordamılparamdwInitParam / / başlatma değeri);
 

Parametreleri

hINSTANCE

Olan yürütülebilir dosya iletişim kutusunda şablonu içeren modülünün bir örneğini tanımlar.

lpTemplateName

İletişim kutusunda şablonu tanımlar. Bu parametre, bir boş sonlandırılmış karakter dizesi iletişim kutusuna şablonun adını belirtir işaretçi, ya da iletişim kutusunda şablon kaynak tanımlayıcısını belirtir bir tamsayı değeri olur. Bir kaynak tanımlayıcısı parametresi belirtir, onun yüksek sıralı sözcük sıfır olmalıdır ve onun alt sıra sözcük tanımlayıcı içermesi gerekir. Sen-ebilmek kullanma MAKEINTRESOURCE makro bu değer yaratmak.

hWndParent

İletişim kutusu sahibi pencereyi tanımlar.

lpDialogFunc

İşaretçiyi iletişim kutusunun prosedür. İletişim kutusu yordamı hakkında daha fazla bilgi için bkz: DialogProc.

dwInitParam

İletişim kutusuna WM_INITDIALOG iletisinin lParam parametresinde geçmesine değeri belirtir.

Dönüş değerleri

İşlev başarılı olursa, dönüş değeri iletişim kutusunu sonlandırmak için kullanılan EndDialog işlevi çağrısında belirtilen nResult parametresi değeridir.

İşlev başarısız olursa, dönüş değeri 1 ' dir. Genişletilmiş hata bilgilerini için GetLastError.

Açıklamalar

DialogBoxParam işlevi, iletişim kutusu oluşturmak için CreateWindowEx işlevini kullanır. ds_setfont stil şablonunu belirtir DialogBoxParam sonra bir WM_INITDIALOG iletisi (ve wm_setfont iletisi) iletişim kutusu yordama gönderir. İşlev (bakılmaksızın, ister WS_VISIBLE stil şablonunu belirtir) iletişim kutusunu görüntüler, sahibi pencere devre dışı bırakır ve iletişim kutusu iletileri göndermek ve almak için kendi ileti döngüsü başlar.

İletişim kutusu yordamı EndDialog işlevini çağırdığında DialogBoxParam iletişim kutusu yok, ileti döngüsü biter, (önceden etkinleştirilmişse) sahibi pencereyi etkinleştirir ve EndDialog çağrıldığında iletişim kutusu yordam tarafından belirtilen nResult parametresi döndürür.

Windows 95 ve sonraki sürümler:Sistem, en çok 255 denetimleri iletişim kutusunda şablonu başına destekleyebilir. İletişim kutusu içinde 255'ten fazla denetimleri yerleştirmek için denetimler onları koyarak şablon yerine WM_INITDIALOG ileti işleyicisi oluşturun.

Windows ce: . LpTemplateName parametresi tarafından başvurulan iletişim şablonda dlgtemplate yapısındaki tüm stilleri desteklenir

QuickInfo

nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Sürüm 1.0 veya daha ilerisini gerektirir.
Header:WINUSER.h ilan etti.
İçe Library:User32.lib kullanın.
Unicode:Unicode ve ANSI sürümleri Windows NT olarak uygulanır.

Ayrıca bkz:

İletişim kutuları genel bakış, iletişim kutusundaki işlevler, CreateWindowEx, iletişim kutusu, DialogBoxIndirect, DialogBoxIndirectParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, wm_setfont

Index