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.
ExpandToEnclosingUnit 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
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
Riferimento
Modelli di controllo Text e TextRange
Cenni preliminari sui provider di automazione interfaccia utente