Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Feljegyzés
Ez a dokumentáció .NET-keretrendszer fejlesztőknek készült, akik a névtérben System.Windows.Automation meghatározott felügyelt UI-automatizálás osztályokat szeretnék használni. A UI-automatizálás kapcsolatos legfrissebb információkért lásd: Windows Automation API: UI-automatizálás.
Ez a cikk a megvalósításra IScrollProvidervonatkozó irányelveket és konvenciókat ismerteti, beleértve az eseményekre és tulajdonságokra vonatkozó információkat is. A további hivatkozásokra mutató hivatkozások a témakör végén jelennek meg.
A ScrollPattern vezérlőminta olyan vezérlők támogatására szolgál, amelyek görgethető tárolóként szolgálnak a gyermekobjektumok gyűjteményéhez. A vezérlő nem szükséges a görgetősávok használatához a görgetési funkció támogatásához, bár általában igen.
Példa görgető vezérlőelemre, amely nem használ görgetősávokat
A vezérlőt megvalósító vezérlők példáiért lásd: Vezérlőminta-megfeleltetés UI-automatizálás ügyfelek számára.
Végrehajtási irányelvek és egyezmények
A görgetésvezérlési minta megvalósításakor vegye figyelembe az alábbi irányelveket és konvenciókat:
Az ellenőrzés gyermekeinek végre kell hajtaniuk IScrollItemProvider.
A tárolóvezérlő görgetősávjai nem támogatják a ScrollPattern vezérlőmintát. Ehelyett támogatniuk kell a RangeValuePattern vezérlőmintát.
Ha a görgetést százalékban mérik, a görgetéssel kapcsolatos összes értéket vagy összeget 0 és 100 közötti tartományra kell normalizálni.
HorizontallyScrollableProperty és VerticallyScrollableProperty függetlenek a IsEnabledProperty.
Ha HorizontallyScrollableProperty =
falseezt követően HorizontalViewSizeProperty 100%-ra kell állítani, és HorizontalScrollPercentProperty a következőre kell állítani: NoScroll. Hasonlóképpen, ha VerticallyScrollableProperty =falseakkor VerticalViewSizeProperty 100%-ra kell állítani, és VerticalScrollPercentProperty a következőre kell állítani: NoScroll. Ez lehetővé teszi, hogy egy UI-automatizálás ügyfél a metóduson belül használja ezeket a SetScrollPercent tulajdonságértékeket, miközben elkerüli a versenyfeltételeket, ha az ügyfél nem érdekelt a görgetésben, aktiválódik.HorizontalScrollPercent területi beállítás. A HorizontalScrollPercent = 100.0 beállításnak a vezérlőelem görgetési helyét a jobb szélső helyzetének megfelelőre kell állítania az olyan nyelvek esetében, mint az angol, amelyek balról jobbra olvasnak. Másik megoldásként az olyan nyelveknél, mint az arab, amelyek jobbról balra olvasnak, a HorizontalScrollPercent = 100.0 beállításnak a görgetési helyet a bal szélső helyre kell állítania.
Az IScrollProviderhez szükséges tagok
A megvalósításhoz IScrollProvidera következő tulajdonságokra és metódusokra van szükség.
| Kötelező tag | Tagtípus | Jegyzetek |
|---|---|---|
| HorizontalScrollPercent | Tulajdonság | Egyik sem |
| VerticalScrollPercent | Tulajdonság | Egyik sem |
| HorizontalViewSize | Tulajdonság | Egyik sem |
| VerticalViewSize | Tulajdonság | Egyik sem |
| HorizontallyScrollable | Tulajdonság | Egyik sem |
| VerticallyScrollable | Tulajdonság | Egyik sem |
| Scroll | Metódus | Egyik sem |
| SetScrollPercent | Metódus | Egyik sem |
Ez a vezérlőminta nem rendelkezik társított eseményekkel.
Kivételek
A szolgáltatóknak a következő kivételeket kell megadniuk.
| Kivétel típusa | Feltétel |
|---|---|
| ArgumentException | Scroll Ez a kivétel akkor jelenik meg, ha egy vezérlőelem kizárólag vízszintes vagy függőleges görgetéshez támogatja SmallIncrement az értékeket, de a rendszer átad egy LargeIncrement értéket. |
| ArgumentException | SetScrollPercent ez a kivétel akkor jelenik meg, ha egy dupla értékre nem konvertálható érték kerül átadásra. |
| ArgumentOutOfRangeException | SetScrollPercent ez a kivétel akkor jelentkezik, ha egy 100-nál vagy 0-nál kisebb értéket ad át (kivéve a -1 értéket, amely egyenértékű a NoScrollértékkel). |
| InvalidOperationException | Mindkettőt Scroll , és SetScrollPercent ezt a kivételt akkor dobja ki, ha nem támogatott irányba próbál görgetni. |