CDialog sınıfı

Makale
02/26/2013

İletişim kutuları ekranda görüntülenmesi için kullanılan temel sınıf.

class CDialog : public CWnd

Üyeler

Ortak Oluşturucusu

Ad	Description
CDialog::CDialog	Yapıları bir CDialog nesnesi.

Public yöntemler

Ad	Description
CDialog::Create	Başlatan CDialog nesnesi. Kalıcı olmayan bir iletişim kutusu oluşturur ve ekler CDialog nesnesi.
CDialog::CreateIndirect	(Olmayan kaynak tabanlı) iletişim kutusunda şablon bellekte kalıcı olmayan bir iletişim kutusu oluşturur.
CDialog::DoModal	Kalıcı bir iletişim kutusu çağırır ve işiniz bittiğinde döndürür.
CDialog::EndDialog	Kalıcı bir iletişim kutusu kapanır.
CDialog::GetDefID	Varsayılan pushbutton denetim kimliği için bir iletişim kutusu alır.
CDialog::GotoDlgCtrl	İletişim kutusunda belirtilen iletişim kutusu denetim odağı taşır.
CDialog::InitModalIndirect	(Olmayan kaynak tabanlı) iletişim kutusunda şablon bellekte kalıcı bir iletişim kutusu oluşturur. Parametreleri işlevi kadar saklanır DoModal olarak adlandırılır.
CDialog::MapDialogRect	Bir dikdörtgen iletişim birimleri ekran birimlerini dönüştürür.
CDialog::NextDlgCtrl	Odağı iletişim kutusunda bir sonraki iletişim kutusunda denetime taşır.
CDialog::OnInitDialog	İletişim kutusu başlatma destekleyebilen geçersiz kılar.
CDialog::OnSetFont	Bir iletişim kutusu kontrolü metin çizdiğinde kullanmaktır yazı tipini belirtmek için geçersiz kılar.
CDialog::PrevDlgCtrl	İletişim kutusundaki önceki iletişim kutusunda denetim odağı taşır.
CDialog::SetDefID	Varsayılan pushbutton denetim iletişim kutusu için belirtilen ı pushbutton olarak değiştirir.
CDialog::SetHelpID	İçerik duyarlı Yardım Kimliği iletişim kutusu için ayarlar.

Korumalı yöntemleri

Ad	Description
CDialog::OnCancel	İptal düğmesi veya esc anahtar eylemi gerçekleştirmek için geçersiz kılar. Varsayılan iletişim kutusunu kapatır ve DoModal döndüren IDCANCEL.
CDialog::OnOK	Modal iletişim kutusunda Tamam düğmesini eylemi gerçekleştirmek için geçersiz kılar. Varsayılan iletişim kutusunu kapatır ve DoModal döndüren IDOK.

Notlar

İletişim kutuları olmak üzere iki tür: kalıcı ve kalıcı olmayan. Uygulama devam etmeden önce bir kalıcı iletişim kutusu kullanıcı tarafından kapatılması gerekir. Kullanıcı iletişim kutusunu görüntülemek ve iptal etme veya iletişim kutusunu kaldırma başka bir göreve dönmek kalıcı olmayan bir iletişim kutusu sağlar.

A CDialog iletişim şablonu birleşimi bir nesnedir ve bir CDialog-türetilmiş sınıf. İletişim kutusu Düzenleyicisi iletişim şablonu oluşturabilir ve bir kaynak olarak saklayabilirsiniz ve sonra türetilen bir sınıfı oluşturmak için sınıf Ekleme Sihirbazı'nı kullanın CDialog.

Diğer pencere gibi bir iletişim kutusu iletileri Windows'dan alır. İletişim kutusunda, kullanıcı iletişim kutusu ile nasıl etkileşim kurduğu olduğu iletişim kutusunun denetimler bildirim iletilerini işleme özellikle ilgilenen. Seçmek istediğiniz iletileri tanıtıcı ve bunu uygun ileti eşleme girdilerini ve ileti işleyicisi üye işlevlerini sınıf sizin için ekler için Properties penceresini kullanın. Uygulamaya özgü kod işleyicisi üye işlevler yazmak yeterlidir.

İsterseniz, her zaman ileti eşleme girdilerini ve üye işlevlerini el ile yazabilirsiniz.

Tüm ama en Önemsiz iletişim kutusu, size üye değişkenlerine türetilmiş iletişim sınıf iletişim kutusunun denetimleri kullanıcı tarafından girilen verileri depolamak için veya kullanıcı verilerini görüntülemek için ekleyin. Üye değişkenleri oluşturma ve denetimleri ile ilişkilendirmek için değişken Ekle Sihirbazı'nı kullanabilirsiniz. Aynı zamanda, bir değişken türü ve bulunmadığı değerleri her değişkenin aralığını seçin. Kod Sihirbazı üye değişkenleri iletişim türetilmiş sınıfa ekler.

Veri eşleme üye değişkenler iletişim kutusunun denetimler arasındaki veri değişimini otomatik olarak işlemek için oluşturulur. Veri eşleme iletişim kutusunda uygun değerlerle denetimlerini başlatmak işlevleri sağlar, veri almak ve verileri doğrulayın.

Kalıcı bir iletişim kutusu oluşturmak için türetilmiş iletişim sınıfı için Oluşturucu kullanarak yığın üzerinde bir nesne oluşturmak ve sonra call DoModal iletişim penceresini ve diğer denetimler oluşturmak için. Kalıcı olmayan bir iletişim oluşturmak istiyorsanız, arama Create iletişim sınıf oluşturucusunun içinde.

Kullanarak bellekte bir şablon oluşturabilirsiniz bir dlgtemplate veri yapısı içinde açıklandığı gibi Windows SDK. Oluşturun, sonra bir CDialog nesne, çağrı CreateIndirect bir engelleyici olmayan oluşturmak için iletişim kutusu ya da çağrı InitModalIndirect ve DoModal bir kalıcı iletişim kutusu oluşturmak için.

Exchange ve doğrulama veri eşleme geçersiz kılma yazılmış CWnd::DoDataExchange yeni iletişim sýnýfýna eklenir. Bkz: DoDataExchange üye işlev CWnd değişimi ve doğrulaması işlevi hakkında daha fazla bilgi için.

Programcı ve framework çağrısı DoDataExchange çağrısı üzerinden dolaylı olarak CWnd::UpdateData.

Framework çağrıları UpdateData kullanıcı bir kalıcı iletişim kutusunu kapatmak için Tamam düğmesini tıkladığında. (İptal düğmesi tıklatıldığında, veriler alınmaz.) Varsayılan uygulama olarak OnInitDialog de çağırır UpdateData denetimlerin ilk değerleri ayarlamak için. Tipik olarak geçersiz kılma OnInitDialog daha fazla denetimlerini başlatmak üzere. OnInitDialogiletişim Denetim oluşturulduktan sonra hemen önce iletişim kutusunda görüntülenen adı verilir.

Arayabileceğiniz CWnd::UpdateData kalıcı veya kalıcı olmayan bir iletişim kutusu yürütülmesi sırasında istediğiniz zaman.

İletişim kutusuna el ile geliştirirseniz, size gerekli üye değişkenleri türetilmiş iletişim kutusu sınıfa kendiniz eklemek ve ayarlamak veya bu değerleri almak için üye işlevleri ekleyin.

Kullanıcı Tamam veya iptal düğmesi basar veya kodunuzu çağırdığında kalıcı bir iletişim kutusu kapanır EndDialog üye işlevi.

Kalıcı olmayan bir iletişim kutusu geliştirdiğinizde, her zaman geçersiz kılar OnCancel üye işlev ve çağrı DestroyWindow karşı içindeki. Temel sınıf çağrısı yok CDialog::OnCancel, onu çağıran EndDialog, iletişim kutusu görünmez hale getirir ama onu yok etmez. Ayrıca geçersiz kılıp kılmayacağını PostNcDestroy silmek için kalıcı olmayan iletişim kutuları için Bu, kalıcı olmayan iletişim kutuları genellikle ile ayrılan bu yana Yeni. Kalıcı iletişim kutularının genellikle çerçeve üzerinde oluşturulur ve ihtiyaç PostNcDestroy temizleme.

Daha fazla bilgi için CDialog, bkz: