Metodo IUIAutomationTextRange::ExpandToEnclosingUnit (uiautomationclient.h)

Normalizza l'intervallo di testo dall'unità di testo specificata. L'intervallo viene espanso se è più piccolo dell'unità specificata o abbreviato se è più lungo dell'unità specificata.

Sintassi

HRESULT ExpandToEnclosingUnit(
  [in] TextUnit textUnit
);

Parametri

[in] textUnit

Tipo: TextUnit

Unità di testo, ad esempio riga o paragrafo.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT.

Commenti

Le applicazioni client, ad esempio le utilità per la lettura dello schermo, usano questo metodo per recuperare la parola, la frase o il paragrafo che esiste nel punto di inserimento o nella posizione del caret.

Nonostante il nome, il metodo ExpandToEnclosingUnit non espande necessariamente un intervallo di testo. Invece, "normalizza" un intervallo di testo spostando gli endpoint in modo che l'intervallo includa l'unità di testo specificata. L'intervallo viene espanso se è più piccolo dell'unità specificata o abbreviato se è più lungo dell'unità specificata. Se l'intervallo è già una quantità esatta delle unità specificate, rimane invariata. Il diagramma seguente illustra come ExpandToEnclosingUnit normalizza un intervallo di testo spostando gli endpoint dell'intervallo.

Diagramma che mostra gli endpoint prima e dopo ExpandToEnclosingUnit

EspandiToEnclosingUnit per impostazione predefinita all'unità di testo più grande successiva supportata se l'unità di testo specificata non è supportata dal controllo.

L'ordine, dalla più piccola unità alla più grande, è il seguente:

• Carattere
• Formato
• Word
• Grafico a linee
• Paragraph
• Pagina
• Documento

ExpandToEnclosingUnit rispetta sia testo visibile che nascosto.

Comportamento dell'intervallo quando l'unità è TextUnit::Format

TextUnit::Format, come valore di unità , posiziona il limite di un intervallo di testo per espandere o spostare l'intervallo in base agli attributi di testo condivisi (o al formato) del testo all'interno dell'intervallo. Tuttavia, l'unità Format di testo non sposta o espande un intervallo di testo oltre il limite di un oggetto incorporato, ad esempio un'immagine o un collegamento ipertestuale. Per altre informazioni, vedere Automazione interfaccia utente unità di testo o Automazione interfaccia utente supporto per il contenuto testuale.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista, Windows XP con SP3 e Platform Update per Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008, Windows Server 2003 con SP2 e Platform Update per Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uiautomationclient.h (includere UIAutomation.h)

Vedi anche

Interfaccia IUIAutomationTextRange, Automazione interfaccia utente Supporto per il contenuto testuale