NamedRange.NoteText 메서드

아티클
05/08/2013

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");
    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();
    }
}
// </Snippet35>

.NET Framework 보안

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

참고 항목

참조

NamedRange 인터페이스

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

다음을 통해 공유