Pattern di controllo scroll
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 usare le barre di scorrimento per supportare la funzionalità di scorrimento, anche se in genere. L'immagine seguente mostra un controllo di scorrimento che non usa 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.
Questo argomento contiene le sezioni seguenti.
- linee guida e convenzioni di implementazione
- membri obbligatori per IScrollProvider
- argomenti correlati
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 viene misurato in percentuali, tutti i valori o gli importi correlati alla graduazione di scorrimento devono essere normalizzati in un intervallo compreso tra 0 e 100.
- La proprietà IScrollProvider::HorizontallyScrollable e proprietà VerticallyScrollable sono indipendenti dalla proprietà IsEnabled.
- Se la proprietà IScrollProvider::HorizontallyScrollable è FALSE, la proprietàHorizontalViewSizedeve essere impostata su 100 (100%) e 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 Automazione interfaccia utente Microsoft di usare questi valori di proprietà all'interno del metodo SetScrollPercent evitando una race condition se una direzione del client non è interessata allo scorrimento diventa 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 le lingue come l'inglese letto da sinistra a destra. In alternativa, per le lingue come l'arabo che legge da destra a sinistra, impostare 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 |
scroll | Metodo | Nessuno |
SetScrollPercent | Metodo | Nessuno |
Questo pattern di controllo non ha eventi associati.
Argomenti correlati
-
tipi di controllo e i relativi modelli di controllo supportati
-
Panoramica modelli di controllo di automazione interfaccia utente