DialogContainer Classe

Costruttore

DialogContainer(dialog_id: str = None)

Parametri

Nome Descrizione
dialog_id
Valore predefinito: None

Metodi

check_for_version_change_async

Verifica se i dialoghi figlio di un contenitore sono stati modificati dopo l'avvio dell'istanza corrente della finestra di dialogo.

Deve essere chiamato all'inizio di beginDialog(), continueDialog()e resumeDialog().

create_child_context
find_dialog
get_internal_version

GetInternalVersion: restituisce l'identificatore di versione interno per questo contenitore. DialogContainers rileva le modifiche di tutti i componenti secondari nel contenitore e ne esegue il mapping a un evento DialogChanged. Poiché lo fanno, DialogContainers "nasconde" le modifiche interne e hanno solo l'ID. In questo modo vengono isolate le modifiche apportate al livello del contenitore, a meno che non venga gestito da un contenitore. Per supportare questo DialogContainers, definire un metodo virtuale protetto GetInternalVersion() che calcola se questa finestra di dialogo o i dialoghi figlio sono stati modificati, che vengono quindi esaminati tramite chiamate a check_for_version_change_async(). :return: versione che rappresenta la modifica degli elementi interni di questo contenitore.

on_dialog_event

Chiamato quando è stato generato un evento, utilizzando DialogContext.emitEvent(), dalla finestra di dialogo corrente o da una finestra di dialogo avviata dalla finestra di dialogo corrente.

check_for_version_change_async

Verifica se i dialoghi figlio di un contenitore sono stati modificati dopo l'avvio dell'istanza corrente della finestra di dialogo.

Deve essere chiamato all'inizio di beginDialog(), continueDialog()e resumeDialog().

async check_for_version_change_async(dialog_context: DialogContext)

Parametri

Nome Descrizione
dialog_context
Necessario

contesto del dialogo.

Restituisce

Tipo Descrizione

compito.

create_child_context

abstract create_child_context(dialog_context: DialogContext) -> DialogContext

Parametri

Nome Descrizione
dialog_context
Necessario

find_dialog

find_dialog(dialog_id: str) -> Dialog

Parametri

Nome Descrizione
dialog_id
Necessario

get_internal_version

GetInternalVersion: restituisce l'identificatore di versione interno per questo contenitore. DialogContainers rileva le modifiche di tutti i componenti secondari nel contenitore e ne esegue il mapping a un evento DialogChanged. Poiché lo fanno, DialogContainers "nasconde" le modifiche interne e hanno solo l'ID. In questo modo vengono isolate le modifiche apportate al livello del contenitore, a meno che non venga gestito da un contenitore. Per supportare questo DialogContainers, definire un metodo virtuale protetto GetInternalVersion() che calcola se questa finestra di dialogo o i dialoghi figlio sono stati modificati, che vengono quindi esaminati tramite chiamate a check_for_version_change_async(). :return: versione che rappresenta la modifica degli elementi interni di questo contenitore.

get_internal_version() -> str

on_dialog_event

Chiamato quando è stato generato un evento, utilizzando DialogContext.emitEvent(), dalla finestra di dialogo corrente o da una finestra di dialogo avviata dalla finestra di dialogo corrente.

async on_dialog_event(dialog_context: DialogContext, dialog_event: DialogEvent) -> bool

Parametri

Nome Descrizione
dialog_context
Necessario

Contesto del dialogo per il turno corrente della conversazione.

dialog_event
Necessario

Evento generato.

Restituisce

Tipo Descrizione

True se l'evento viene gestito dalla finestra di dialogo corrente e il bubbling deve essere arrestato.

Attributi

telemetry_client

Ottiene il client di telemetria per la registrazione degli eventi.