ITextProvider.GetVisibleRanges Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Načte pole oddělených oblastí textu z textového kontejneru, kde každá oblast textu začíná prvním částečně viditelným řádkem až na konec posledního částečně viditelného řádku.
public:
cli::array <System::Windows::Automation::Provider::ITextRangeProvider ^> ^ GetVisibleRanges();
public System.Windows.Automation.Provider.ITextRangeProvider[] GetVisibleRanges ();
abstract member GetVisibleRanges : unit -> System.Windows.Automation.Provider.ITextRangeProvider[]
Public Function GetVisibleRanges () As ITextRangeProvider()
Návraty
Kolekce viditelných oblastí textu v kontejneru nebo prázdném poli Odkaz null (Nothing
v Visual Basic) se nikdy nevrátí.
Poznámky
model UI Automation poskytovatelé by měli zajistit, aby vrátily maximálně rozsahy textu, které jsou viditelné v rámci kontejneru.
Nesouvislé rozsahy textu mohou nastat, když je jakýkoli obsah textového kontejneru zakrytý překrývajícím se oknem nebo jiným objektem nebo když textový kontejner s rozložením s více sloupci má jeden nebo více sloupců částečně posunutý mimo zobrazení.
Pokud není žádný text viditelný, vrátí se degenerovaná (prázdná) oblast textu. Tato prázdná oblast se dá vrátit, pokud je textový kontejner prázdný nebo když se veškerý text posune mimo zobrazení.