ITextRangeProvider.Move(TextUnit, Int32) Yöntem

Tanım

Ad Alanı:

System.Windows.Automation.Provider

Bütünleştirilmiş Kod:

UIAutomationTypes.dll

Metin aralığını belirtilen sayıda metin birimine taşır.

public:
 int Move(System::Windows::Automation::Text::TextUnit unit, int count);

public int Move (System.Windows.Automation.Text.TextUnit unit, int count);

abstract member Move : System.Windows.Automation.Text.TextUnit * int -> int

Public Function Move (unit As TextUnit, count As Integer) As Integer

Parametreler

unit

TextUnit

Metin birimi sınırı.

count

Int32

Taşınacak metin birimi sayısı.

Pozitif bir değer metin aralığını ileri taşır, negatif bir değer metin aralığını geriye taşır ve 0'ın hiçbir etkisi olmaz.

Döndürülenler

Int32

Gerçekte taşınan birim sayısı. Bu, yeni metin aralığı uç noktalarının biri uç noktalardan büyük veya daha küçükse istenen sayıdan DocumentRange küçük olabilir.

Açıklamalar

Bir metin aralığının içeriğinde gezinmek gerektiğinde, yöntemin başarıyla yürütülmesi için Move arka planda bir dizi adım uygulanır.

1. Metin aralığı normalleştirilir; yani metin aralığı uç noktadaki bozuk bir aralığa Start daraltılır ve bu da uç noktayı gereksiz hale getirir End . Bu adım, bir metin aralığının sınırları yaydığı unit durumlarda belirsizliği kaldırmak için gereklidir; örneğin, "{U}RL https://www.microsoft.com/ metne eklenmiş" ve burada "{" ve "}" metin aralığı uç noktalarıdır.

2. Elde edilen aralık, istenen unit sınırın başına geri DocumentRange taşınır.

3. Aralık, istenen sınır sayısına unit göre içinde DocumentRange ileri veya geri taşınır.

4. Daha sonra uç nokta istenen unit bir sınıra taşınarak aralık bozuk aralık durumundan End genişletilir.

Metin aralığının Move() ve ExpandToEnclosingUnit() için nasıl ayarlandığına ilişkin örnekler

Metin kapsayıcısının ve köprü veya tablo hücresi gibi eklenmiş bir nesnenin metin içeriği (veya iç metni), hem denetim görünümünde hem de UI Otomasyonu ağacının içerik görünümünde tek, sürekli metin akışı olarak gösterilir; nesne sınırları yoksayılır.

Eklenmiş nesneler ve bunların aralık aralıkları ile metin akışı örneği

Move hem gizli hem de görünür metne saygı duyar.

Move, verilen TextUnit denetim tarafından desteklenmiyorsa desteklenen sonraki en büyük TextUnit sunucuya saptırılır.

En küçük üniteden en büyüğe sipariş aşağıda listelenmiştir.

• Character

• Format

• Word

• Line

• Paragraph

• Page

• Document

Metin hiçbir şekilde değiştirilmez, metin aralığı metnin farklı bir bölümüne yayılır.