Implementera UI Automation-växlingskontrollmönstret

Anmärkning

Den här dokumentationen är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i System.Windows.Automation namnrymd. Den senaste informationen om UI Automation finns i Windows Automation API: UI Automation.

Det här avsnittet innehåller riktlinjer och konventioner för att implementera IToggleProvider, inklusive information om metoder och egenskaper. Länkar till ytterligare referenser visas i slutet av ämnet.

Kontrollmönstret TogglePattern används för att stödja kontroller som kan växla genom en uppsättning tillstånd och upprätthålla ett tillstånd när de har angetts. Exempel på kontroller som implementerar det här kontrollmönstret finns i Kontrollmönstermappning för UI Automation-klienter.

Riktlinjer och konventioner för implementering

Observera följande riktlinjer och konventioner när du implementerar växlingskontrollmönstret:

  • Kontroller som inte behåller tillståndet när de aktiveras, till exempel knappar, verktygsfältsknappar och hyperlänkar, måste implementeras IInvokeProvider i stället.

  • En kontroll måste gå igenom dess ToggleState i följande ordning: On, Off och, om den stöds, Indeterminate.

  • TogglePattern tillhandahåller inte en SetState-metod (newState) på grund av problem med att ställa in en tri-state CheckBox direkt, utan att gå igenom dess lämpliga ToggleState-sekvens.

  • RadioButton-kontrollen implementerar inte IToggleProvider, eftersom den inte kan cykla genom sina giltiga tillstånd.

Obligatoriska medlemmar för IToggleProvider

Följande egenskaper och metoder krävs för att implementera IToggleProvider.

Obligatorisk medlem Medlemstyp Noteringar
Toggle Metod Ingen
ToggleStateProperty Fastighet Ingen

Det här kontrollmönstret har inga associerade händelser.

Undantag

Det här kontrollmönstret har inga associerade undantag.

Se även