Metodo NamedRange.NoteText

Articolo
08/11/2011

Ottiene o imposta la nota associata alla cella nell'angolo superiore sinistro del controllo NamedRange.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
Function NoteText ( _
    Text As Object, _
    Start As Object, _
    Length As Object _
) As String

string NoteText(
    Object Text,
    Object Start,
    Object Length
)

Parametri

Text
Tipo: System.Object
Testo da aggiungere alla nota (massimo 255 caratteri).Il testo viene inserito a partire dalla posizione Start e sostituisce i caratteri Length della nota esistente.Se si omette questo argomento, questo metodo restituirà il testo corrente della nota a partire dalla posizione Start per i caratteri Length.

Start
Tipo: System.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
Tipo: System.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 il numero di caratteri compresi tra la posizione Start e la fine della nota è superiore a 255, il metodo restituirà solo 255 caratteri.

Valore restituito

Tipo: System.String

Note

Le note della cella sono state sostituite dai commenti dell'intervallo. Per ulteriori informazioni, vedere l'oggetto Comment.

Per aggiungere una nota costituita da più di 255 caratteri, utilizzare questo metodo una volta per specificare i primi 255 caratteri, quindi utilizzarlo nuovamente per aggiungere il resto della nota (mai più di 255 caratteri alla volta).

Parametri facoltativi

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

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come impostare diverse caratteristiche di formattazione e visualizzazione di un controllo NamedRange denominato NamedRange1. In particolare, viene utilizzato il metodo NoteText per aggiungere a NamedRange1 una nota contenente il testo This is a Formatting test.

Questo esempio è valido per una personalizzazione a livello di documento.

' <Snippet36>
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

' </Snippet35>

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

    namedRange1.NoteText("This is a Formatting test", missing, missing);
    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, missing);
    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();
    }
}
// </Snippet35>

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite