ToolTip.AutoPopDelay Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il periodo di tempo in cui la descrizione comando rimane visibile se il puntatore è stazionario su un controllo con il testo della descrizione comando specificato.
public:
property int AutoPopDelay { int get(); void set(int value); };public int AutoPopDelay { get; set; }member this.AutoPopDelay : int with get, setPublic Property AutoPopDelay As IntegerValore della proprietà
Periodo di tempo, in millisecondi, che rimane ToolTip visibile quando il puntatore è stazionario su un controllo. In Windows 11, il valore predefinito fa sì che la descrizione comando rimanga visibile per un periodo illimitato.
Esempio
Nell'esempio di codice seguente viene creata un'istanza della ToolTip classe e viene associata l'istanza all'oggetto Form in cui viene creata l'istanza. Il codice inizializza quindi le proprietà AutoPopDelaydi ritardo , InitialDelaye ReshowDelay. Inoltre, l'istanza della ToolTip classe imposta la ShowAlways proprietà su true per consentire la visualizzazione del testo della descrizione comando indipendentemente dal fatto che la maschera sia attiva. Infine, nell'esempio viene associato il testo della descrizione comando a due controlli di una maschera, un Button oggetto e un oggetto CheckBox. L'esempio di codice richiede che il metodo definito nell'esempio si trovi all'interno di un Form oggetto che contiene un Button controllo denominato e un CheckBox controllo denominato button1checkBox1, e che il metodo viene chiamato dal costruttore di Form.
// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
void Form1_Load( Object^ sender, System::EventArgs^ e )
{
// Create the ToolTip and associate with the Form container.
ToolTip^ toolTip1 = gcnew ToolTip;
// Set up the delays for the ToolTip.
toolTip1->AutoPopDelay = 5000;
toolTip1->InitialDelay = 1000;
toolTip1->ReshowDelay = 500;
// Force the ToolTip text to be displayed whether or not the form is active.
toolTip1->ShowAlways = true;
// Set up the ToolTip text for the Button and Checkbox.
toolTip1->SetToolTip( this->button1, "My button1" );
toolTip1->SetToolTip( this->checkBox1, "My checkBox1" );
}
// This example assumes that the Form_Load event handling method
// is connected to the Load event of the form.
private void Form1_Load(object sender, System.EventArgs e)
{
// Create the ToolTip and associate with the Form container.
ToolTip toolTip1 = new ToolTip();
// Set up the delays for the ToolTip.
toolTip1.AutoPopDelay = 5000;
toolTip1.InitialDelay = 1000;
toolTip1.ReshowDelay = 500;
// Force the ToolTip text to be displayed whether or not the form is active.
toolTip1.ShowAlways = true;
// Set up the ToolTip text for the Button and Checkbox.
toolTip1.SetToolTip(this.button1, "My button1");
toolTip1.SetToolTip(this.checkBox1, "My checkBox1");
}
' This example assumes that the Form_Load event handling method
' is connected to the Load event of the form.
Private Sub Form1_Load(sender As Object, e As System.EventArgs) Handles MyBase.Load
' Create the ToolTip and associate with the Form container.
Dim toolTip1 As New ToolTip()
' Set up the delays for the ToolTip.
toolTip1.AutoPopDelay = 5000
toolTip1.InitialDelay = 1000
toolTip1.ReshowDelay = 500
' Force the ToolTip text to be displayed whether or not the form is active.
toolTip1.ShowAlways = True
' Set up the ToolTip text for the Button and Checkbox.
toolTip1.SetToolTip(Me.button1, "My button1")
toolTip1.SetToolTip(Me.checkBox1, "My checkBox1")
End Sub
Commenti
La AutoPopDelay proprietà consente di abbreviare o ridurre il tempo di visualizzazione della ToolTip finestra quando il puntatore si trova su un controllo. Ad esempio, se si visualizza un'ampia Guida in una finestra Descrizione comando, è possibile aumentare il valore di questa proprietà per assicurarsi che l'utente abbia tempo sufficiente per leggere il testo.
Se si vuole avere un modello di ritardo coerente per le finestre della descrizione comando, è possibile impostare la AutomaticDelay proprietà . La AutomaticDelay proprietà imposta le AutoPopDelayproprietà , ReshowDelaye InitialDelay sui valori iniziali in base a un singolo valore. Ogni volta che la AutomaticDelay proprietà viene impostata, la AutoPopDelay proprietà viene impostata su 10 volte il valore della AutomaticDelay proprietà. Dopo aver impostato la AutomaticDelay proprietà, è possibile impostare in modo indipendente la AutoPopDelay proprietà, sostituendo il valore predefinito.
Il comportamento di questa proprietà varia in base alla versione di Windows:
- In Windows 10, il tempo massimo che puoi ritardare un popup è di 5000 millisecondi. I valori maggiori di 5000 ms sono bloccati a 5000 ms.
- In Windows 11 il valore predefinito fa sì che le descrizioni comando rimangano visibili per un periodo illimitato. Se impostato su un valore personalizzato, non è previsto alcun limite di 5000 ms e la descrizione comando viene visualizzata per la durata specificata.
Per durate più lunghe o un controllo preciso su quando viene visualizzata la descrizione comando, usare il Show metodo .
