WM_POINTERENTER iletisi

Yeni bir işaretçi pencerenin üzerinde algılama aralığına girdiğinde (üzerine gelindiğinde) veya var olan bir işaretçi pencerenin sınırları içinde hareket ettiğinde pencereye gönderilir.

Bir pencere bu iletiyi WindowProc işlevi aracılığıyla alır.

! [Önemli]
Masaüstü uygulamaları DPI'ye duyarlı olmalıdır. Uygulamanız DPI farkında değilse, DPI sanallaştırması nedeniyle işaretçi iletilerinde ve ilgili yapılarda bulunan ekran koordinatları yanlış görünebilir. DPI sanallaştırma, DPI farkında olmayan ve varsayılan olarak etkin olan uygulamalara otomatik ölçeklendirme desteği sağlar (kullanıcılar bunu kapatabilir). Daha fazla bilgi için bkz. Yazma High-DPI Win32 Uygulamaları.

#define WM_POINTERENTER                 0x0249

Parametre

wParam

İşaretçi tanımlayıcısını ve ek bilgileri içerir. wParam parametresindeki belirli bilgileri almak için aşağıdaki makroları kullanın.

• GET_POINTERID_WPARAM(wParam): işaretçi tanımlayıcısı.
• IS_POINTER_NEW_WPARAM(wParam): Bu iletinin algılama aralığına giren yeni bir işaretçi tarafından oluşturulan ilk ileti olup olmadığını gösterir (üzerine gelin).
• IS_POINTER_INRANGE_WPARAM(wParam): Bu iletinin algılama aralığını terk etmemiş bir işaretçi tarafından oluşturulup oluşturulmadığını gösterir. Bu bayrak her zaman WM_POINTERENTER iletileri için ayarlanır.
• IS_POINTER_INCONTACT_WPARAM(wParam): Bu iletinin kişideki bir işaretçi tarafından oluşturulup oluşturulmadığını gösteren bir bayrak. Bu bayrak algılama aralığındaki bir işaretçi için ayarlanmadı (vurgulama).

lParam

İşaretçinin nokta konumunu içerir.

Not

İşaretçi önemsiz olmayan bir alan üzerinden cihazla iletişim kurabileceğinden, bu nokta konumu daha karmaşık bir işaretçi alanının basitleştirilmesi olabilir. Mümkün olduğunda, bir uygulama nokta konumu yerine tam işaretçi alanı bilgilerini kullanmalıdır.

Noktanın fiziksel ekran koordinatlarını almak için aşağıdaki makroları kullanın.

• GET_X_LPARAM(lParam): x (yatay nokta) koordinatı.
• GET_Y_LPARAM(lParam): y (dikey nokta) koordinatı.

Dönüş değeri

Bir uygulama bu iletiyi işlerse sıfır döndürmelidir.

Uygulama bu iletiyi işlemezse, DefWindowProcçağırmalıdır.

Açıklamalar

WM_POINTERENTER bildirimi, işaretçi yüzeyi üzerindeyken kullanıcıya geri bildirim sağlamak veya işaretçinin yüzeyi üzerinde bulunmasına başka bir şekilde tepki vermek için bir pencere tarafından kullanılabilir.

Bu bildirim yalnızca işaretçi için giriş alan pencereye gönderilir. Aşağıdaki tabloda, bu bildirimin gönderildiği bazı durumlar listeleniyor.

! [Önemli]
Bir pencere bir işaretçinin yakalanmasını kaybettiğinde ve WM_POINTERCAPTURECHANGED bildirimini aldığında, genellikle başka bildirim almaz. Bu nedenle, eşit olarak eşleştirilmiş WM_POINTERDOWN/WM_POINTERUP veya WM_POINTERENTER/WM_POINTERLEAVE bildirimlerine dayalı hiçbir varsayımda bulunmamanız önemlidir.

Girişler fareden geldiğinde, fare ve işaretçi iletisi tümleştirmesi sonucunda WM_POINTERENTER gönderilmez.

Gereksinim -leri

Ayrıca bkz.

İletileri

Başvuru

GET_POINTERID_WPARAM

IS_POINTER_NEW_WPARAM

IS_POINTER_INRANGE_WPARAM

IS_POINTER_INCONTACT_WPARAM