Pattern di controllo scorrimento

  • Articolo

Vengono descritte le linee guida e le convenzioni per l'implementazione di IScrollProvider, incluse informazioni sulle proprietà e sui metodi. Il pattern di controllo Scroll viene usato per supportare un controllo che funge da contenitore scorrevole per una raccolta di oggetti figlio.

Il controllo non è necessario per utilizzare le barre di scorrimento per supportare la funzionalità di scorrimento, anche se in genere. L'immagine seguente mostra un controllo di scorrimento che non utilizza le barre di scorrimento. Per esempi di controlli che implementano questo pattern di controllo, vedere Tipi di controllo e i relativi pattern di controllo supportati.

screenshot che mostra un controllo di scorrimento senza barre di scorrimento

In questo argomento sono contenute le sezioni seguenti.

Linee guida e convenzioni di implementazione

Quando si implementa il pattern di controllo Scroll , tenere presenti le linee guida e le convenzioni seguenti:

  • Gli elementi figlio di questo controllo devono implementare IScrollItemProvider.
  • Le barre di scorrimento di un controllo contenitore non supportano il pattern di controllo Scroll . Devono invece supportare il pattern di controllo RangeValue .
  • Quando lo scorrimento è misurato in percentuali, tutti i valori o gli importi relativi alla scala di scorrimento devono essere normalizzati in base a un intervallo compreso tra 0 e 100.
  • La proprietà IScrollProvider::HorizontallyScrollable e VerticallyScrollable sono indipendenti dalla proprietà IsEnabled .
  • Se la proprietà IScrollProvider::HorizontallyScrollable è FALSE, la proprietà HorizontalViewSize deve essere impostata su 100 (100%) e la proprietà HorizontalScrollPercent deve essere impostata su UIA_ScrollPatternNoScroll (-1). Analogamente, se la proprietà VerticallyScrollable è FALSE, la proprietà VerticalViewSize deve essere impostata su 100 (100%) e la proprietà VerticalScrollPercent deve essere impostata su UIA_ScrollPatternNoScroll (-1). Ciò consente a un client di microsoft Automazione interfaccia utente di usare questi valori di proprietà all'interno del metodo SetScrollPercent evitando una race condition se una direzione del client non è interessata allo scorrimento viene attivata.
  • La proprietà IScrollProvider::HorizontalScrollPercent è specifica delle impostazioni locali. L'impostazione di HorizontalScrollPercent su 100 deve impostare la posizione di scorrimento del controllo sull'equivalente della posizione più a destra per lingue come l'inglese letto da sinistra a destra. In alternativa, per le lingue come arabo che leggono da destra a sinistra, l'impostazione di HorizontalScrollPercent su 100 deve impostare la posizione di scorrimento sulla posizione più a sinistra.

Membri obbligatori per IScrollProvider

Per implementare l'interfaccia IScrollProvider sono necessari i metodi e le proprietà seguenti.

Membri obbligatori Tipo di membro Note
HorizontalScrollPercent Proprietà Nessuno
VerticalScrollPercent Proprietà Nessuno
HorizontalViewSize Proprietà Nessuno
VerticalViewSize Proprietà Nessuno
HorizontallyScrollable Proprietà Nessuno
VerticallyScrollable Proprietà Nessuno
Scorrere Metodo Nessuno
SetScrollPercent Metodo Nessuno

 

Questo pattern di controllo non è associato a eventi.

Tipi di controllo e modelli di controllo supportati

Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente

Panoramica dell'albero di automazione dell'interfaccia utente