Metodo ITextRangeProvider::ExpandToEnclosingUnit (uiautomationcore.h)

Normalizza l'intervallo di testo in base all'unità di testo specificata. L'intervallo viene espanso se è minore dell'unità specificata o abbreviato se è più lungo dell'unità specificata.

Sintassi

HRESULT ExpandToEnclosingUnit(
  [in] TextUnit unit
);

Parametri

[in] unit

Tipo: TextUnit

Tipo di unità di testo, ad esempio carattere, parola, paragrafo e così via.

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 completa, la frase o il paragrafo esistente nel punto di inserimento o nella posizione del cursore.

Nonostante il nome, il metodo ITextRangeProvider::ExpandToEnclosingUnit non espande necessariamente un intervallo di testo. Al contrario, "normalizza" un intervallo di testo spostando gli endpoint in modo che l'intervallo includa l'unità di testo specificata. L'intervallo viene espanso se è minore dell'unità specificata o abbreviato se è più lungo dell'unità specificata. Se l'intervallo è già una quantità esatta delle unità specificate, rimane invariato. È fondamentale che il metodo ExpandToEnclosingUnit normalizzi sempre gli intervalli di testo in modo coerente; in caso contrario, altri aspetti della manipolazione dell'intervallo di testo da parte dell'unità di testo sarebbero imprevedibili. Il diagramma seguente mostra come ExpandToEnclosingUnit normalizza un intervallo di testo spostando gli endpoint dell'intervallo.

Diagramma che mostra le posizioni degli endpoint prima e dopo una chiamata a ExpandToEnclosingUnitExpandToEnclosingUnit viene predefinito per l'unità di testo più grande successiva supportata se l'unità di testo specificata non è supportata dal controllo. L'ordine, dall'unità più piccola alla più grande, è il seguente:
  • Carattere
  • Formato
  • Word
  • Linea
  • Paragraph
  • Page
  • Documento
ExpandToEnclosingUnit rispetta sia il testo visibile che quello nascosto.

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

TextUnit::Format come valore unitario posiziona il limite di un intervallo di testo per espandere o spostare l'intervallo in base agli attributi di testo condiviso (formato) del testo all'interno dell'intervallo. Tuttavia, l'uso dell'unità di testo di formato non deve spostare o espandere un intervallo di testo oltre il limite di un oggetto incorporato, ad esempio un'immagine o un collegamento ipertestuale. Per altre info, vedi Automazione interfaccia utente unità di testo o Modelli di controllo Text e TextRange.

Requisiti

   
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione uiautomationcore.h (include UIAutomation.h)

Vedi anche

Informazioni concettuali

ITextProvider

ITextRangeProvider

Riferimento

Modelli di controllo Text e TextRange

Cenni preliminari sui provider di automazione interfaccia utente