Condividi tramite

Pattern di controllo Stili

  • Articolo

Vengono descritte le linee guida e le convenzioni per l'implementazione di IStylesProvider, incluse informazioni sulle proprietà e sui metodi. Il pattern di controllo Styles viene usato per descrivere un elemento dell'interfaccia utente con uno stile specifico, un colore di riempimento, un motivo di riempimento o una forma.

Il pattern di controllo Stili è particolarmente utile per descrivere gli elementi in un documento, che spesso hanno tali stili. Gli stili in genere contengono informazioni utili per i clienti con disabilità; Ad esempio, uno stile può descrivere una determinata stringa come titolo di un documento o un determinato oggetto diagramma di flusso come rombo o cerchio. Per esempi di controlli che implementano questo pattern di controllo, vedere Tipi di controllo e i relativi pattern di controllo supportati.

In questo argomento sono contenute le sezioni seguenti.

Linee guida e convenzioni di implementazione

Quando si implementa il pattern di controllo Stili , tenere presenti le linee guida e le convenzioni seguenti:

  • Il file di intestazione UIAutomationClient.h definisce un set di valori costanti denominati usati per identificare diversi stili comuni. Per altre informazioni, vedere Identificatori di stile.
  • Se si usa StyleId_Custom, è necessario implementare la proprietà IStylesProvider::StyleName per consentire ai client di individuare il nome dello stile. Non è necessario implementare la proprietà StyleName per uno stile standard perché Microsoft Automazione interfaccia utente fornisce un nome predefinito, ma è possibile implementarlo se è necessario eseguire l'override del nome predefinito.
  • Le altre proprietà nel modello Styles sono facoltative; il provider può restituire UIA_E_NOTSUPPORTED per una proprietà non supportata.
  • Gli stili in un intervallo di testo possono essere rappresentati tramite gli attributi di testo seguenti:
    • Quando si risponde a una richiesta per l'attributo di testo StyleId , l'intervallo di testo deve restituire uno degli identificatori di stile descritti in Identificatori di stile.
    • Se si utilizza StyleId_Custom , l'intervallo di testo deve restituire un valore stringa per l'attributo di testo StyleName per consentire ai client di individuare il nome dello stile.
    • Un intervallo di testo con più stili, ad esempio intestazione e testo normale, deve restituire la proprietà speciale Automazione interfaccia utente ReservedMixedAttributeValue per entrambe le proprietà StyleId e StyleName. Un client che riceve questa risposta può suddividere l'intervallo di testo per trovare dove iniziano e terminano gli stili.
  • Le applicazioni possono usare un'ampia gamma di stili per descrivere gli oggetti, ma Automazione interfaccia utente rappresenta solo quelli più comuni. Per rappresentare attributi di stile aggiuntivi, ad esempio il colore del bordo, un provider può restituire un elenco di attributi aggiuntivi nella proprietà ExtendedProperties . Si tratta fondamentalmente di un contenitore di proprietà con un set di proprietà estese, ad esempio "BorderColor=0xFF0000; BorderStyle=punteggiato". I valori delle proprietà estese possono essere specifici dell'applicazione.

Membri obbligatori per IStylesProvider

Per implementare l'interfaccia IStylesProvider sono necessarie le proprietà seguenti.

Membri obbligatori Tipo di membro Note
ExtendedProperties Proprietà Nessuno
Fillcolor Proprietà Nessuno
FillPatternColor Proprietà Nessuno
FillPatternStyle Proprietà Nessuno
Forma Proprietà Nessuno
StyleId Proprietà Nessuno
Nome stile Proprietà Nessuno

 

Questo pattern di controllo non è associato a metodi o eventi.

Tipi di controllo e modelli di controllo supportati

Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente

Panoramica dell'albero di automazione dell'interfaccia utente