Metodo ITextRangeProvider::MoveEndpointByUnit (uiautomationcore.h)

  • Articolo

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

Sintassi

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

Parametri

[in] endpoint

Tipo: TextPatternRangeEndpoint

Endpoint da spostare.

[in] unit

Tipo: TextUnit

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

[in] count

Tipo: int

Numero di unità da spostare. Un valore positivo sposta l'endpoint in avanti. Un valore negativo si sposta all'indietro. Il valore 0 non ha alcun 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.

Osservazioni

L'endpoint viene spostato in avanti o indietro, come specificato, al limite dell'unità disponibile successivo. 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.

Illustrazione che mostra gli endpoint di un intervallo di testo in movimento Se l'endpoint spostato attraversa l'altro endpoint dello stesso intervallo di testo, viene spostato anche l'altro endpoint , generando un intervallo degenerato e garantendo l'ordinamento corretto del dell'endpoint (ovvero, che l'inizio è sempre minore o uguale alla fine).

ITextRangeProvider::MoveEndpointByUnit deprecate 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
  • paragrafo
  • pagina
  • documento

Comportamento intervallo quando unità è TextUnit::Format

TextUnit::Format come unità di valore posiziona il limite di un intervallo di testo per espandere o spostare l'intervallo in base agli attributi di testo condivisi (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 informazioni, vedere unità di testo di automazione interfaccia utente o modelli di controllo Text e TextRange.

Fabbisogno

Requisito Valore
client minimo supportato Windows XP [app desktop | App UWP]
server minimo supportato Windows Server 2003 [app desktop | App UWP]
piattaforma di destinazione Finestre
intestazione uiautomationcore.h (include UIAutomation.h)

Vedere anche

concettuale

ITextProvider

ITextRangeProvider

riferimento

modelli di controllo Text e TextRange

Panoramica dei provider di automazione interfaccia utente