Metodo ITextRangeProvider::MoveEndpointByUnit (uiautomationcore.h)

Sposta un endpoint dell'intervallo di testo il numero specificato di unità TextUnit all'interno dell'intervallo di documenti.

Sintassi

HRESULT MoveEndpointByUnit(
                TextPatternRangeEndpoint endpoint,
                TextUnit                 unit,
  [in]          int                      count,
  [out, retval] int                      *pRetVal
);

Parametri

endpoint

unit

[in] count

Tipo: int

Numero di unità da spostare. Un valore positivo comporta lo spostamento in avanti dell'endpoint. Un valore negativo comporta lo spostamento indietro. Un valore pari a 0 non ha effetto.

[out, retval] pRetVal

Tipo: int*

Riceve il numero di unità effettivamente spostate, che possono essere inferiori al numero richiesto se lo spostamento dell'endpoint viene eseguito all'inizio o alla fine del documento.

Valore restituito

Tipo: HRESULT

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

Commenti

L'endpoint viene spostato in avanti o indietro, come specificato, al limite successivo dell'unità disponibile. Se l'endpoint originale si trovava al limite dell'unità di testo specificata, l'endpoint viene spostato al limite successivo dell'unità di testo disponibile, come illustrato nella figura seguente.

Se l'endpoint spostato attraversa l'altro endpoint dello stesso intervallo di testo, viene spostato anche l'altro endpoint , generando un intervallo degenerato e assicurando l'ordinamento corretto dell'endpoint , ovvero che l'inizio è sempre minore o uguale alla fine.

ITextRangeProvider::MoveEndpointByUnit depreca fino all'unità di testo supportata successiva se l'unità di testo specificata non è supportata dal controllo.

L'ordine, dall'unità più piccola alla più grande, è elencato qui.

• 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

Requisito	Valore
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