funzione TextRange_ExpandToEnclosingUnit (uiautomationcoreapi.h)

Articolo
03/03/2024

Nota Questa funzione è deprecata. Le applicazioni client devono usare invece le interfacce COM (Component Object Model) di Microsoft Automazione interfaccia utente.

Espande l'intervallo di testo in un'unità più grande o più piccola, ad esempio Character, Word, Line o Page.

Sintassi

HRESULT TextRange_ExpandToEnclosingUnit(
  [in] HUIATEXTRANGE hobj,
  [in] TextUnit      unit
);

Parametri

[in] hobj

Tipo: HUIATEXTRANGE

Oggetto intervallo di testo.

[in] unit

Tipo: TextUnit

Unità in cui il provider deve espandere l'intervallo di testo.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario.

Commenti

Se l'intervallo è già un numero integrale delle unità specificate, rimane invariato.

Se l'endpoint iniziale non si trova in corrispondenza di un limite TextUnit , viene spostato all'indietro fino a quando non si trova a un limite. Successivamente, se l'endpoint finale non si trova in un limite o se si trova allo stesso limite dell'endpoint iniziale, l'endpoint finale viene spostato in avanti fino a quando non si trova a un limite.

Nota È comune che un'utilità per la lettura dello schermo legga una parola intera, un intero paragrafo e così via, nel punto di inserimento o in qualsiasi posizione del cursore virtuale.

TextRange_ExpandToEnclosingUnit rispetta sia il testo nascosto che quello visibile. Automationclient dell'interfaccia utente può controllare l'attributo nascosto (Text_IsHidden_Attribute_GUID) per la visibilità del testo.

TextRange_ExpandToEnclosingUnit impostazione predefinita fino al successivo textUnit supportato se il valore TextUnit specificato non è supportato dal controllo .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcoreapi.h
Libreria	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Condividi tramite