NamedRange.NoteText 메서드

아티클
08/10/2011

NamedRange 컨트롤의 왼쪽 위 모퉁이에 있는 셀과 관련된 셀 메모를 가져오거나 설정합니다.

네임스페이스: Microsoft.Office.Tools.Excel
어셈블리: Microsoft.Office.Tools.Excel(Microsoft.Office.Tools.Excel.dll)

구문

‘선언
Function NoteText ( _
    Text As Object, _
    Start As Object, _
    Length As Object _
) As String

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

매개 변수

Text
형식: System.Object
메모에 추가할 텍스트입니다(최대 255자).이 텍스트는 Start 위치부터 삽입되며, 기존 메모의 Length자를 대체합니다.이 인수를 생략하면 이 메서드는 Length자에 대해 Start 위치부터 메모의 현재 텍스트를 반환합니다.

Start
형식: System.Object
설정되거나 반환되는 텍스트의 시작 위치입니다.이 인수를 생략하면 이 메서드는 첫째 문자에서 시작합니다.메모에 텍스트를 추가하려면 기존 메모에 있는 문자 수보다 큰 수를 지정합니다.

Length
형식: System.Object
설정되거나 반환될 문자 수입니다.이 인수를 생략하면 Microsoft Office Excel에서는 시작 위치부터 메모의 끝까지의 문자를 설정하거나 반환합니다(최대 255자).Start 위치부터 메모의 끝 사이에 255자보다 많은 문자가 있으면 이 메서드는 255자만 반환합니다.

반환 값

형식: System.String

설명

셀 메모는 범위 주석으로 대체되었습니다. 자세한 내용은 Comment 개체를 참조하십시오.

256자 이상이 포함된 메모를 추가하려면 이 메서드를 사용하여 처음 255자를 지정한 다음 메서드를 다시 사용하여 메모의 나머지 부분을 추가합니다(한 번에 255자를 초과할 수 없음).

선택적 매개 변수

선택적 매개 변수에 대한 자세한 내용은 Office 솔루션의 선택적 매개 변수를 참조하십시오.

예제

다음 코드 예제에서는 다양한 서식을 설정하고 NamedRange1이라는 NamedRange 컨트롤의 특징을 표시하는 방법을 보여 줍니다. 특히 이 예제에서는 NoteText 메서드를 사용하여 This is a Formatting test라는 텍스트로 NamedRange1에 메모를 추가합니다.

이 예제는 문서 수준 사용자 지정을 위한 것입니다.

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

.NET Framework 보안

직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

NamedRange 인터페이스

Microsoft.Office.Tools.Excel 네임스페이스

Share via