Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Notitie
Deze documentatie is bedoeld voor .NET Framework-ontwikkelaars die de beheerde UI Automation-klassen willen gebruiken die zijn gedefinieerd in de System.Windows.Automation naamruimte. Zie Windows Automation-API: UI Automation voor de meest recente informatie over UI Automation.
In dit artikel worden richtlijnen en conventies geïntroduceerd voor de implementatie IScrollProvider, inclusief informatie over gebeurtenissen en eigenschappen. Koppelingen naar aanvullende verwijzingen worden aan het einde van het onderwerp weergegeven.
Het ScrollPattern besturingspatroon wordt gebruikt ter ondersteuning van een besturingselement dat fungeert als een schuifbare container voor een verzameling onderliggende objecten. Het besturingselement is niet vereist om schuifbalken te gebruiken om de schuiffunctionaliteit te ondersteunen, hoewel dit vaak wel het geval is.
Voorbeeld van een besturingselement schuiven dat geen schuifbalken gebruikt
Zie Beheerpatroontoewijzing voor UI Automation-clients voor voorbeelden van besturingselementen die dit besturingselement implementeren.
Implementatierichtlijnen en conventies
Let bij het implementeren van het schuifbeheerpatroon op de volgende richtlijnen en conventies:
De onderliggende elementen van dit besturingselement moeten worden geïmplementeerd IScrollItemProvider.
De schuifbalken van een containerbesturing ondersteunen het ScrollPattern besturingspatroon niet. Ze moeten in plaats daarvan het RangeValuePattern besturingspatroon ondersteunen.
Wanneer schuiven wordt gemeten in percentages, moeten alle waarden of bedragen die betrekking hebben op het schuiven, worden genormaliseerd tot een bereik van 0 tot 100.
HorizontallyScrollableProperty en VerticallyScrollableProperty onafhankelijk zijn van de IsEnabledProperty.
Als HorizontallyScrollableProperty =
falsedit moet HorizontalViewSizeProperty worden ingesteld op 100% en HorizontalScrollPercentProperty moet worden ingesteld op NoScroll. En als VerticallyScrollableProperty =falsedit moet VerticalViewSizeProperty worden ingesteld op 100 procent en VerticalScrollPercentProperty moet worden ingesteld op .NoScroll Hierdoor kan een UI Automation-client deze eigenschapswaarden binnen de SetScrollPercent methode gebruiken terwijl een racevoorwaarde wordt vermeden als de client niet geïnteresseerd is in schuiven, wordt geactiveerd.HorizontalScrollPercent is landinstellingenspecifiek. Als u HorizontalScrollPercent = 100,0 instelt, moet u de schuiflocatie van het besturingselement instellen op het equivalent van de meest rechtse positie voor talen zoals Engels die van links naar rechts worden gelezen. Voor talen zoals Arabisch die van rechts naar links worden gelezen, moet u de schuiflocatie instellen op de meest linkse positie als u HorizontalScrollPercent = 100,0 instelt.
Vereiste leden voor IScrollProvider
De volgende eigenschappen en methoden zijn vereist voor de implementatie IScrollProvider.
| Vereist lid | Type lid | Opmerkingen |
|---|---|---|
| HorizontalScrollPercent | Eigenschappen | Geen |
| VerticalScrollPercent | Eigenschappen | Geen |
| HorizontalViewSize | Eigenschappen | Geen |
| VerticalViewSize | Eigenschappen | Geen |
| HorizontallyScrollable | Eigenschappen | Geen |
| VerticallyScrollable | Eigenschappen | Geen |
| Scroll | Wijze | Geen |
| SetScrollPercent | Wijze | Geen |
Dit besturingspatroon heeft geen gekoppelde gebeurtenissen.
Uitzonderingen
Providers moeten de volgende uitzonderingen genereren.
| Type uitzondering | Conditie |
|---|---|
| ArgumentException | Scroll genereert deze uitzondering als een besturingselement uitsluitend waarden ondersteunt SmallIncrement voor horizontaal of verticaal schuiven, maar een LargeIncrement waarde wordt doorgegeven. |
| ArgumentException | SetScrollPercent genereert deze uitzondering wanneer een waarde die niet kan worden geconverteerd naar een dubbele waarde wordt doorgegeven. |
| ArgumentOutOfRangeException | SetScrollPercent genereert deze uitzondering wanneer een waarde groter dan 100 of minder dan 0 wordt doorgegeven (behalve -1 die gelijk is aan NoScroll). |
| InvalidOperationException | Scroll Deze uitzondering wordt beide SetScrollPercent gegenereerd wanneer er een poging wordt gedaan om in een niet-ondersteunde richting te schuiven. |