UI Otomasyon ve Ekran Ölçeklendirme

Windows Vista'dan başlayarak, Windows kullanıcıların inç başına nokta (dpi) ayarını değiştirerek ekrandaki kullanıcı arabirimi (UI) öğelerinin çoğunun daha büyük görünmesini sağlar. Bu özellik uzun süredir Windows'ta kullanılabilse de, önceki sürümlerde ölçeklendirmenin uygulamalar tarafından uygulanması gerekiyordu. Windows Vista'dan başlayarak, Masaüstü Pencere Yöneticisi kendi ölçeklendirmesini işlemeyen tüm uygulamalar için varsayılan ölçeklendirme gerçekleştirir. UI Otomasyonu istemci uygulamalarının bu özelliği hesaba katması gerekir.

Windows Vista'da ölçeklendirme

Varsayılan dpi ayarı 96'dır ve bu da 96 pikselin bir nota inç genişliğinde veya yüksekliğinde yer kapladığı anlamına gelir. Bir "inç"in tam ölçüsü, monitörün boyutuna ve fiziksel çözünürlüğüne bağlıdır. Örneğin, 12 inç genişliğindeki bir monitörde, 1280 piksellik yatay çözünürlükte, 96 piksellik yatay çizgi bir inçin yaklaşık 9/10'unda uzanır.

Dpi ayarını değiştirmek, ekran çözünürlüğünü değiştirmekle aynı değildir. Dpi ölçeklendirme ile ekrandaki fiziksel piksel sayısı aynı kalır. Ancak ölçeklendirme, kullanıcı arabirimi öğelerinin boyutuna ve konumuna uygulanır. Bu ölçeklendirme, masaüstü için Masaüstü Pencere Yöneticisi (DWM) tarafından ve açıkça ölçeklendirilmemesi istenmeyen uygulamalar için otomatik olarak gerçekleştirilebilir.

Kullanıcı ölçek faktörünü 120 dpi olarak belirlediğinde ekranda dikey veya yatay bir inç yüzde 25 büyür. Tüm boyutlar buna göre ölçeklendirilir. Bir uygulama penceresinin ekranın üst ve sol kenarlarından uzaklığı yüzde 25 artar. Uygulama ölçeklendirme etkinse ve uygulama dpi algılamalı değilse, pencerenin boyutu, içerdiği tüm kullanıcı arabirimi öğelerinin uzaklıkları ve boyutlarıyla birlikte aynı oranda artar.

Ekran ölçeklendirme, ekran koordinatlarıyla herhangi bir şekilde ilgilenen uygulamalar için yeni zorluklar oluşturur. Ekranda artık iki koordinat sistemi vardır: fiziksel ve mantıksal. Bir noktanın fiziksel koordinatları, kaynağın sol üst köşesinden piksel cinsinden gerçek uzaklıktır. Mantıksal koordinatlar, piksellerin kendileri ölçeklendirildiyse olduğu gibi uzaklıklardır.

Koordinatlarda bir düğme (100, 48) bulunan bir iletişim kutusu tasarladığınız varsayıldığında. Bu iletişim kutusu varsayılan 96 dpi'de görüntülendiğinde, düğme (100, 48) fiziksel koordinatlarında bulunur. 120 dpi'de fiziksel koordinatlarında bulunur (125, 60). Ancak mantıksal koordinatlar herhangi bir dpi ayarında aynıdır: (100, 48).

Mantıksal koordinatlar önemlidir çünkü işletim sisteminin ve uygulamaların davranışını dpi ayarından bağımsız olarak tutarlı hale getirir. Örneğin, Cursor.Position normalde mantıksal koordinatları döndürür. İmleci iletişim kutusundaki bir öğenin üzerine taşırsanız, dpi ayarından bağımsız olarak aynı koordinatlar döndürülür. (100, 100) konumunda bir denetim çizerseniz, bu mantıksal koordinatlara çizilir ve herhangi bir dpi ayarında aynı göreli konumu kaplar.

UI Otomasyonu İstemcilerinde Ölçeklendirme

UI Otomasyonu API'sinde mantıksal koordinatlar kullanılmaz. Aşağıdaki yöntemler ve özellikler fiziksel koordinatlar döndürür veya bunları parametre olarak alır.

• GetClickablePoint

• TryGetClickablePoint

• ClickablePointProperty

• FromPoint

• BoundingRectangle

Varsayılan olarak, 96 dpi olmayan bir ortamda çalışan bir UI Otomasyonu istemci uygulaması bu yöntem ve özelliklerden doğru sonuçları alamaz. Örneğin, imleç konumu mantıksal koordinatlarda olduğundan, istemci imlecin altındaki öğeyi almak için bu koordinatları doğrudan 'a FromPoint geçiremez. Buna ek olarak, uygulama pencereleri istemci alanının dışına doğru yerleştiremeyecektir.

Çözüm iki bölümden oluşur.

1. İlk olarak, istemci uygulamasını dpi'ye duyarlı hale getirin. Bunu yapmak için başlangıçta Win32 işlevini SetProcessDPIAware çağırın. Yönetilen kodda, aşağıdaki bildirim bu işlevi kullanılabilir hale getirir.

   [System.Runtime.InteropServices.DllImport("user32.dll")]
   internal static extern bool SetProcessDPIAware();
   

   <System.Runtime.InteropServices.DllImport("user32.dll")> _
   Friend Shared Function SetProcessDPIAware() As Boolean
   End Function
   

   Bu işlev sürecin tamamını dpi'ye duyarlı hale getirir; başka bir deyişle işleme ait olan tüm pencereler ölçeklendirilmemiş olur. Örneğin Vurgulayıcı Örneğinde, vurgu dikdörtgenini oluşturan dört pencere mantıksal koordinatlardan değil, UI Otomasyonu elde edilen fiziksel koordinatlarda bulunur. Örnek dpi algılamalı değilse, vurgu masaüstündeki mantıksal koordinatlarda çizilir ve bu da 96 dpi olmayan bir ortamda yanlış yerleştirmeye neden olur.

2. İmleç koordinatlarını almak için Win32 işlevini GetPhysicalCursorPosçağırın. Aşağıdaki örnekte bu işlevin nasıl bildirilip kullanılacağı gösterilmektedir.

   public struct CursorPoint
   {
       public int X;
       public int Y;
   }
   
   [System.Runtime.InteropServices.DllImport("user32.dll")]
   internal static extern bool GetPhysicalCursorPos(ref CursorPoint lpPoint);
   
   private bool ShowUsage()
   {
       CursorPoint cursorPos = new CursorPoint();
       try
       {
           return GetPhysicalCursorPos(ref cursorPos);
       }
       catch (EntryPointNotFoundException) // Not Windows Vista
       {
           return false;
       }
   }
   

   Structure CursorPoint
       Public X As Integer
       Public Y As Integer
   End Structure
   
   <System.Runtime.InteropServices.DllImport("user32.dll")> _
   Friend Shared Function GetPhysicalCursorPos(ByRef lpPoint As CursorPoint) As Boolean
   End Function
   
   Private Function ShowUsage() As Boolean
   
       Dim cursorPos As New CursorPoint()
       Try
           Return GetPhysicalCursorPos(cursorPos)
       Catch e As EntryPointNotFoundException ' Not Windows Vista
           Return False
       End Try
   
   End Function
   

Uygulamanız dpi algılamalı olmayan uygulamalarla doğrudan çapraz işlem iletişimi gerçekleştiriyorsa Win32 işlevlerini PhysicalToLogicalPoint ve LogicalToPhysicalPointkullanarak mantıksal ve fiziksel koordinatlar arasında dönüştürme yapmış olabilirsiniz.

Ayrıca bkz.

• Vurgulayıcı Örneği