CMFCDesktopAlertWnd Sınıfı
sınıfı, CMFCDesktopAlertWnd kullanıcıyı bir olay hakkında bilgilendirmek için ekranda görüntülenen modsuz bir iletişim kutusunun işlevselliğini uygular.
Daha fazla ayrıntı için Visual Studio yüklemenizin VC\atlmfc\src\mfc klasöründe bulunan kaynak koduna bakın.
Sözdizimi
class CMFCDesktopAlertWnd : public CWnd
Üyeler
Genel Yöntemler
| Adı | Açıklama |
|---|---|
| CMFCDesktopAlertWnd::Create | Masaüstü uyarı penceresini oluşturur ve başlatır. |
| CMFCDesktopAlertWnd::GetAnimationSpeed | Animasyon hızını döndürür. |
| CMFCDesktopAlertWnd::GetAnimationType | Animasyon türünü döndürür. |
| CMFCDesktopAlertWnd::GetAutoCloseTime | Otomatik kapatma zaman aşımını döndürür. |
| CMFCDesktopAlertWnd::GetCaptionHeight | başlık yüksekliğini döndürür. |
| CMFCDesktopAlertWnd::GetDialogSize | |
| CMFCDesktopAlertWnd::GetLastPos | Masaüstü uyarı penceresinin ekrandaki son geçerli konumunu döndürür. |
| CMFCDesktopAlertWnd::GetTransparency | Saydamlık düzeyini döndürür. |
| CMFCDesktopAlertWnd::HasSmallCaption | Masaüstü uyarı penceresinin küçük başlık görüntülenip görüntülenmeyeceğini belirler. |
| CMFCDesktopAlertWnd::OnBeforeShow | |
| CMFCDesktopAlertWnd::OnClickLinkButton | Kullanıcı masaüstü uyarı menüsünde bulunan bir bağlantı düğmesine tıkladığında çerçeve tarafından çağrılır. |
| CMFCDesktopAlertWnd::OnCommand | Çerçeve, kullanıcı menüden bir öğe seçtiğinde, bir alt denetim bildirim iletisi gönderdiğinde veya hızlandırıcı tuş vuruşu çevrildiğinde bu üye işlevini çağırır. (Geçersiz Kılmalar CWnd::OnCommand.) |
| CMFCDesktopAlertWnd::OnDraw | |
| CMFCDesktopAlertWnd::P rocessCommand | |
| CMFCDesktopAlertWnd::SetAnimationSpeed | Yeni animasyon hızını ayarlar. |
| CMFCDesktopAlertWnd::SetAnimationType | Animasyon türünü ayarlar. |
| CMFCDesktopAlertWnd::SetAutoCloseTime | Otomatik kapatma zaman aşımını ayarlar. |
| CMFCDesktopAlertWnd::SetSmallCaption | Küçük ve normal başlık arasında geçiş yapar. |
| CMFCDesktopAlertWnd::SetTransparency | Saydamlık düzeyini ayarlar. |
Açıklamalar
Masaüstü uyarı penceresi saydam olabilir, animasyon efektleriyle birlikte görünebilir ve kaybolabilir (belirtilen bir gecikmeden sonra veya kullanıcı kapat düğmesine tıklayarak kapattığında).
Masaüstü uyarı penceresi ayrıca simge, ileti metni (etiket) ve bağlantı içeren varsayılan bir iletişim kutusu da içerebilir. Alternatif olarak, masaüstü uyarı penceresi uygulamanın kaynaklarından özel bir iletişim kutusu içerebilir.
İki adımda bir masaüstü uyarı penceresi oluşturursunuz. İlk olarak, nesnesini oluşturmak için oluşturucuyu çağırın CMFCDesktopAlertWnd . İkincisi, pencereyi oluşturmak ve nesneye eklemek için CMFCDesktopAlertWnd::Create member işlevini çağırın.CMFCDesktopAlertWnd
nesnesi, CMFCDesktopAlertWnd masaüstü uyarı penceresinin istemci alanını dolduran özel bir alt iletişim kutusu oluşturur. İletişim kutusu, üzerinde konumlandırılan tüm denetimlerin sahibidir.
Açılan pencerede özel bir iletişim kutusu görüntülemek için şu adımları izleyin:
sınıfından bir sınıf türetme
CMFCDesktopAlertDialog.Kaynaklarda bir alt iletişim kutusu şablonu oluşturun.
İletişim kutusu şablonunun kaynak kimliğini ve türetilmiş sınıfın çalışma zamanı sınıf bilgilerini içeren bir işaretçi kullanarak CMFCDesktopAlertWnd::Create öğesini çağırın.
Barındırılan denetimlerden gelen tüm bildirimleri işlemek için özel iletişim kutusunu programla veya barındırılan denetimleri bu bildirimleri doğrudan işleyecek şekilde programla.
Masaüstü uyarı penceresinin davranışını denetlemek için aşağıdaki işlevleri kullanın:
CMFCDesktopAlertWnd::SetAnimationType çağrısı yaparak animasyon türünü ayarlayın. Geçerli seçenekler arasında açma, slayt ve solma yer alır.
CMFCDesktopAlertWnd::SetAnimationSpeed çağrısı yaparak animasyon çerçevesi hızını ayarlayın.
CMFCDesktopAlertWnd::SetTransparency çağrısı yaparak saydamlık düzeyini ayarlayın.
CMFCDesktopAlertWnd::SetSmallCaption çağrısı yaparak başlık boyutunu küçük olarak değiştirin. Küçük başlık 7 piksel yüksekliğindedir.
Örnek
Aşağıdaki örnekte, bir CMFCDesktopAlertWnd nesneyi yapılandırmak için sınıftaki çeşitli yöntemlerin CMFCDesktopAlertWnd nasıl kullanılacağı gösterilmektedir. Örnekte animasyon türünün nasıl ayarlanacağı, açılır pencerenin saydamlığının nasıl ayarlanacağı, uyarı penceresinin küçük bir başlık görüntüleneceğini belirtme ve uyarı penceresinin otomatik olarak kapanmadan önce geçmesi gereken süreyi ayarlama gösterilmektedir. Örnekte ayrıca masaüstü uyarı penceresinin nasıl oluşturulacağı ve başlatacağı gösterilmektedir. Bu kod parçacığı, Masaüstü Uyarı Tanıtımı örneğinin bir parçasıdır.
CMFCDesktopAlertWnd *pPopup = new CMFCDesktopAlertWnd;
// int m_nAnimation
pPopup->SetAnimationType((CMFCPopupMenu::ANIMATION_TYPE)m_nAnimation);
// int m_nAnimationSpeed
pPopup->SetAnimationSpeed(m_nAnimationSpeed);
// int m_nTransparency
pPopup->SetTransparency((BYTE)m_nTransparency);
// BOOL m_bSmallCaption
pPopup->SetSmallCaption(m_bSmallCaption);
// BOOL m_bAutoClose, int m_nAutoCloseTime
pPopup->SetAutoCloseTime(m_bAutoClose ? m_nAutoCloseTime * 1000 : 0);
// int m_nPopupSource
if (m_nPopupSource == 0)
{
// int m_nVisualMngr
// CPoint m_ptPopup
// The this pointer points to a CDesktopAlertDemoDlg class which extends the CDialogEx class.
if (m_nVisualMngr == 5) // MSN-style
{
pPopup->Create(this, IDD_DIALOG2, NULL,
m_ptPopup, RUNTIME_CLASS(CMSNDlg));
}
else
{
pPopup->Create(this, IDD_DIALOG1,
m_menuPopup.GetSubMenu(0)->GetSafeHmenu(),
m_ptPopup, RUNTIME_CLASS(CMyPopupDlg));
}
}
Devralma Hiyerarşisi
Gereksinimler
Üst bilgi: afxDesktopAlertWnd.h
CMFCDesktopAlertWnd::Create
Masaüstü uyarı penceresini oluşturur ve başlatır.
virtual BOOL Create(
CWnd* pWndOwner,
UINT uiDlgResID,
HMENU hMenu = NULL,
CPoint ptPos = CPoint(-1,-1),
CRuntimeClass* pRTIDlgBar = RUNTIME_CLASS(CMFCDesktopAlertDialog));
virtual BOOL Create(
CWnd* pWndOwner,
CMFCDesktopAlertWndInfo& params,
HMENU hMenu = NULL,
CPoint ptPos = CPoint(-1,-1));
Parametreler
pWndOwner
[in, out] Uyarı penceresinin sahibini belirtir. Ardından bu sahip, masaüstü uyarı penceresi için tüm bildirimleri alır. Bu değer NULL olamaz.
uiDlgResID
[in] Uyarı penceresinin kaynak kimliğini belirtir.
Hmenu
[in] Kullanıcı menü düğmesine tıkladığında görüntülenen menüyü belirtir. NULL ise, menü düğmesi görüntülenmez.
ptPos
[in] Ekran koordinatlarını kullanarak uyarı penceresinin görüntülendiği ilk konumu belirtir. Bu parametre (-1, -1) ise, uyarı penceresi ekranın sağ alt köşesinde görüntülenir.
pRTIDlgBar
[in] Uyarı penceresinin istemci alanını kapsayan özel bir iletişim kutusu sınıfı için çalışma zamanı sınıfı bilgileri.
params
[in] Uyarı penceresi oluşturmak için kullanılan parametreleri belirtir.
İade Değeri
Uyarı penceresi başarıyla oluşturulduysa TRUE; aksi takdirde YANLIŞ.
Açıklamalar
Uyarı penceresi oluşturmak için bu yöntemi çağırabilirsiniz. Uyarı penceresinin istemci alanı, kullanıcıya görüntülenen tüm denetimleri barındıran bir alt iletişim kutusu içerir.
İlk yöntem aşırı yüklemesi, uygulamanın kaynaklarından yüklenen bir alt iletişim kutusu içeren bir uyarı penceresi oluşturur. İlk yöntem aşırı yüklemesi, özel bir iletişim kutusu sınıfı için çalışma zamanı sınıf bilgilerini de belirtebilir.
İkinci yöntem aşırı yüklemesi, varsayılan denetimleri içeren bir uyarı penceresi oluşturur. CMFCDesktopAlertWndInfo Sınıfını değiştirerek hangi denetimlerin görüntüleneceğini belirtebilirsiniz.
CMFCDesktopAlertWnd::GetAnimationSpeed
Animasyon hızını döndürür.
UINT GetAnimationSpeed() const;
İade Değeri
Uyarı penceresinin milisaniye cinsinden animasyon hızı.
Açıklamalar
Animasyon hızı uyarı penceresinin ne kadar hızlı açılıp kapandığı açıklanmaktadır.
CMFCDesktopAlertWnd::GetAnimationType
Animasyon türünü döndürür.
CMFCPopupMenu::ANIMATION_TYPE GetAnimationType();
İade Değeri
Aşağıdaki animasyon türlerinden biri:
NO_ANIMATION
AÇILMAK
SLAYT
FADE
SYSTEM_DEFAULT_ANIMATION
CMFCDesktopAlertWnd::GetAutoCloseTime
Otomatik kapatma zaman aşımını döndürür.
int GetAutoCloseTime() const;
İade Değeri
Milisaniye cinsinden uyarı penceresinin otomatik olarak kapatılacağı süre.
Açıklamalar
Uyarı penceresi otomatik olarak kapanmadan önce geçmesi gereken süreyi belirlemek için bu yöntemi kullanın.
CMFCDesktopAlertWnd::GetCaptionHeight
başlık yüksekliğini döndürür.
virtual int GetCaptionHeight();
İade Değeri
başlık piksel cinsinden yüksekliği.
Açıklamalar
Bu yöntem türetilmiş bir sınıfta geçersiz kılınabilir. Açılan pencerenin küçük başlık veya Windows API işlevinden GetSystemMetrics(SM_CYSMCAPTION)alınan değeri görüntülemesi gerekiyorsa, varsayılan uygulama küçük başlık yükseklik değerini (7 piksel) döndürür.
CMFCDesktopAlertWnd::GetLastPos
Masaüstü uyarı penceresinin ekrandaki son konumunu döndürür.
CPoint GetLastPos() const;
İade Değeri
Ekran koordinatlarında bir nokta.
Açıklamalar
Bu yöntem, uyarı penceresinin ekrandaki son geçerli konumunu döndürür.
CMFCDesktopAlertWnd::GetTransparency
Saydamlık düzeyini döndürür.
BYTE GetTransparency() const;
İade Değeri
0 ile 255 (dahil) arasında bir saydamlık düzeyi. Değer ne kadar büyükse, pencere o kadar opak olur.
Açıklamalar
Uyarı penceresinin geçerli saydamlık düzeyini almak için bu yöntemi kullanın.
CMFCDesktopAlertWnd::HasSmallCaption
Masaüstü uyarı penceresinin küçük bir başlık mi yoksa normal boyutlu başlık mi olduğunu belirler.
BOOL HasSmallCaption() const;
İade Değeri
Açılan pencere küçük bir başlık görüntülenirse TRUE; Açılan pencere normal boyutlu bir başlık görüntülenirse YANLIŞ.
Açıklamalar
Açılan pencerenin küçük bir başlık mı yoksa normal boyutlu bir başlık mı olduğunu belirlemek için bu yöntemi kullanın. Varsayılan olarak, küçük başlık 7 piksel yüksekliğindedir. Windows API işlevini GetSystemMetrics(SM_CYCAPTION)çağırarak normal boyut başlık yüksekliğini elde edebilirsiniz.
CMFCDesktopAlertWnd::OnBeforeShow
virtual BOOL OnBeforeShow(CPoint&);
Parametreler
[in] CPoint &
İade Değeri
Açıklamalar
CMFCDesktopAlertWnd::OnClickLinkButton
Kullanıcı masaüstü uyarı menüsünde bulunan bir bağlantı düğmesine tıkladığında çerçeve tarafından çağrılır.
virtual BOOL OnClickLinkButton(UINT uiCmdID);
Parametreler
uiCmdID
[in] Bu parametre kullanılmaz.
İade Değeri
Her zaman YANLIŞ.
Açıklamalar
Kullanıcı uyarı penceresindeki bağlantıya tıkladığında bildirim almak istiyorsanız, türetilmiş bir sınıfta bu yöntemi geçersiz kılın.
CMFCDesktopAlertWnd::OnCommand
virtual BOOL OnCommand(
WPARAM wParam,
LPARAM lParam);
Parametreler
[in] Wparam
[in] Lparam
İade Değeri
Açıklamalar
CMFCDesktopAlertWnd::OnDraw
virtual void OnDraw(CDC* pDC);
Parametreler
[in] Pdc
Açıklamalar
CMFCDesktopAlertWnd::P rocessCommand
BOOL ProcessCommand(HWND hwnd);
Parametreler
[in] Hwnd
İade Değeri
Açıklamalar
CMFCDesktopAlertWnd::SetAnimationSpeed
Yeni animasyon hızını ayarlar.
void SetAnimationSpeed(UINT nSpeed);
Parametreler
nSpeed
[in] Yeni animasyon hızını milisaniye cinsinden belirtir.
Açıklamalar
Uyarı penceresi için animasyon hızını ayarlamak için bu yöntemi çağırın. Varsayılan animasyon hızı 30 milisaniyedir.
CMFCDesktopAlertWnd::SetAnimationType
Animasyon türünü ayarlar.
void SetAnimationType(CMFCPopupMenu::ANIMATION_TYPE type);
Parametreler
type
[in] Animasyon türünü belirtir.
Açıklamalar
Animasyon türünü ayarlamak için bu yöntemi çağır. Aşağıdaki değerlerden birini belirtebilirsiniz:
NO_ANIMATION
AÇILMAK
SLAYT
FADE
SYSTEM_DEFAULT_ANIMATION
CMFCDesktopAlertWnd::SetAutoCloseTime
Otomatik kapatma zaman aşımını ayarlar.
void SetAutoCloseTime(int nTime);
Parametreler
nTime
[in] Uyarı penceresi otomatik olarak kapanmadan önce geçen milisaniye cinsinden süre.
Açıklamalar
Kullanıcı pencereyle etkileşim kurmazsa uyarı penceresi belirtilen süreden sonra otomatik olarak kapatılır.
CMFCDesktopAlertWnd::SetSmallCaption
Küçük ve normal boyutlu başlık arasında geçiş yapar.
void SetSmallCaption(BOOL bSmallCaption = TRUE);
Parametreler
bSmallCaption
[in] Doğru, uyarı penceresinin küçük bir başlık görüntüleneceğini belirtmek için, aksi takdirde, uyarı penceresinin normal boyutta bir başlık görüntüleneceğini belirtmek için YANLIŞ.
Açıklamalar
Küçük veya normal boyutlu başlık görüntülemek için bu yöntemi çağırın. Varsayılan olarak, küçük başlık 7 piksel yüksekliğindedir. Windows API işlevini GetSystemMetrics(SM_CYCAPTION)çağırarak normal başlık boyutunu elde edebilirsiniz.
CMFCDesktopAlertWnd::SetTransparency
Açılan pencerenin saydamlık düzeyini ayarlar.
void SetTransparency(BYTE nTransparency);
Parametreler
nTransparency
[in] Saydamlık düzeyini belirtir. Bu değer 0 ile 255 (dahil) arasında olmalıdır. Değer ne kadar büyükse, pencere o kadar opak olur.
Açıklamalar
Açılan pencerenin saydamlık düzeyini ayarlamak için bu işlevi çağırın.
CMFCDesktopAlertWnd::GetDialogSize
virtual CSize GetDialogSize();
İade Değeri
Açıklamalar
Ayrıca bkz.
Hiyerarşi Grafiği
Sınıflar
CMFCDesktopAlertWndInfo Sınıfı
CMFCDesktopAlertDialog Sınıfı
CWnd Sınıfı
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin