ToolTip.AutoPopDelay Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta l'intervallo di visibilità della descrizione comando quando il puntatore è fermo su un controllo che contiene il testo specificato della descrizione comando.

public:
 property int AutoPopDelay { int get(); void set(int value); };

public int AutoPopDelay { get; set; }

member this.AutoPopDelay : int with get, set

Public Property AutoPopDelay As Integer

Valore della proprietà

Int32

Intervallo di visibilità espresso in millisecondi dell'oggetto ToolTip quando il puntatore è fermo su un controllo. Il valore predefinito è 5000.

Esempio

Nell'esempio di codice seguente viene creata un'istanza della ToolTip classe e viene associata l'istanza all'interno Form dell'istanza. Il codice inizializza quindi le proprietà AutoPopDelaydi ritardo , , InitialDelaye ReshowDelay. Inoltre, l'istanza della classe imposta la proprietà su per true abilitare la ShowAlways visualizzazione del ToolTip testo della descrizione comando indipendentemente dal fatto che il modulo sia attivo. Infine, l'esempio associa il testo della descrizione comando a due controlli in un modulo, a e Button a CheckBox. L'esempio di codice richiede che il metodo definito nell'esempio si trovi all'interno di un Form oggetto contenente un controllo denominato e un CheckBoxButton 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 ridurre o ridurre il tempo di visualizzazione della ToolTip finestra quando il puntatore è in 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 proprietà è impostata, la AutomaticDelayAutoPopDelay proprietà viene impostata su 10 volte il valore della AutomaticDelay proprietà. Dopo aver impostato la proprietà, è possibile impostare in modo indipendente la AutomaticDelayAutoPopDelay proprietà, sovrascrivendo il valore predefinito.

Il tempo massimo per cui è possibile ritardare un popup è di 5000 millisecondi. Per durate più lunghe, usare il Show metodo per controllare il momento esatto in cui viene visualizzata la descrizione comando.

Vedi anche

• AutomaticDelay
• InitialDelay
• ReshowDelay
• UseFading
• Popup