NamedRange.NoteText(Object, Object, Object) Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

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 la nota associata alla cella nell'angolo superiore sinistro del controllo NamedRange.

public string NoteText (object Text, object Start, object Length);

abstract member NoteText : obj * obj * obj -> string

Public Function NoteText (Optional Text As Object, Optional Start As Object, Optional Length As Object) As String

Parametri

Text: Object

Testo da aggiungere alla nota (massimo 255 caratteri). Il testo viene inserito a partire dalla posizione Start, sostituendo Length i caratteri della nota esistente. Se questo argomento viene omesso, questo metodo restituisce il testo corrente della nota a partire dalla posizione Start, per Length i caratteri.

Start: Object

Posizione iniziale del testo impostato o restituito. Se si omette questo argomento, questo metodo verrà avviato in corrispondenza del primo carattere. Per aggiungere testo alla nota, specificare un numero superiore al numero di caratteri inclusi nella nota esistente.

Length: Object

Numero di caratteri da impostare o da restituire. Se si omette questo argomento, in Microsoft Office Excel verranno impostati o restituiti caratteri dalla posizione iniziale fino alla fine della nota (massimo 255 caratteri). Se sono presenti più di 255 caratteri dalla Start fine della nota, questo metodo restituisce solo 255 caratteri.

Restituisce

String

Esempio

Nell'esempio di codice seguente viene illustrato come impostare un'ampia gamma di caratteristiche di formattazione e visualizzazione di un NamedRange controllo denominato NamedRange1. In particolare, questo esempio usa il NoteText metodo per aggiungere una nota a NamedRange1 con il testo This is a Formatting test.

Questo esempio è relativo a una personalizzazione a livello di documento.

private void SetRangeFormats()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    namedRange1.NoteText("This is a Formatting test");
    namedRange1.Value2 = "Martha";
    namedRange1.Font.Name = "Verdana";
    namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter;
    namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter;
    namedRange1.BorderAround(missing, Excel.XlBorderWeight.xlThick, 
        Excel.XlColorIndex.xlColorIndexAutomatic);
    namedRange1.AutoFormat(Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1,
        true, false, true, false, true, true);

    if (MessageBox.Show("Clear the formatting and notes?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        namedRange1.ClearFormats();
        namedRange1.ClearNotes();
    }
}

Private Sub SetRangeFormats()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    namedRange1.NoteText("This is a Formatting test", , )
    namedRange1.Value2 = "Martha"
    namedRange1.Font.Name = "Verdana"
    namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter
    namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter
    namedRange1.BorderAround(, Excel.XlBorderWeight.xlThick, _
        Excel.XlColorIndex.xlColorIndexAutomatic, )
    namedRange1.AutoFormat( _
        Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1, _
        True, False, True, False, True, True)

    If MessageBox.Show("Clear the formatting and notes?", _
        "Test", MessageBoxButtons.YesNo) = DialogResult.Yes Then
        namedRange1.ClearFormats()
        namedRange1.ClearNotes()
    End If
End Sub

Commenti

Le note delle celle sono state sostituite dai commenti di intervallo. Per ulteriori informazioni, vedere l' Comment oggetto.

Per aggiungere una nota contenente più di 255 caratteri, utilizzare questo metodo una volta per specificare i primi 255 caratteri, quindi utilizzarlo di nuovo per aggiungere la parte rimanente della nota (non più di 255 caratteri alla volta).

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere parametri facoltativi nelle soluzioni Office.

Si applica a

Condividi tramite