Dela via


Implementera UI Automation-växlingskontrollmönstret

Kommentar

Den här dokumentationen System.Windows.Automation är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i namnområdet. 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 som rör direktinställningen för en tri-state CheckBox utan att cykla genom lämplig ToggleState sekvens.

  • RadioButton-kontrollen implementerar IToggleProviderinte , 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 Kommentar
Toggle Metod Ingen
ToggleStateProperty Property Ingen

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

Undantag

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

Se även