NamedRange.Characters 속성

NamedRange 컨트롤의 텍스트에 포함된 문자의 범위를 나타내는 Microsoft.Office.Interop.Excel.Characters 개체를 가져옵니다.

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

구문

‘선언
ReadOnly Property Characters As NamedRange_CharactersType
    Get

NamedRange_CharactersType Characters { get; }

속성 값

형식: Microsoft.Office.Tools.Excel.NamedRange_CharactersType
NamedRange 컨트롤의 텍스트에 포함된 문자의 범위를 나타내는 Microsoft.Office.Interop.Excel.Characters 개체입니다.

설명

Characters 속성은 다음 매개 변수와 함께 사용할 수 있습니다.

Parameter	설명
Start	반환될 첫째 문자입니다. 이 인수가 1이거나 생략된 경우 이 속성은 첫째 문자로 시작하는 문자의 범위를 반환합니다.
Length	반환할 문자 수입니다. 이 인수를 생략하면 이 속성은 문자열의 나머지(Start 문자 다음의 모든 문자)를 반환합니다.

매개 변수를 지정하지 않고 Characters을 사용하려고 하면 Characters은 Visual Studio 인프라에 속하며 사용자 코드에서 직접 사용할 수 없는 NamedRange_CharactersType 개체를 가져옵니다.

Microsoft.Office.Interop.Excel.Characters 개체를 사용하여 텍스트 문자열에 포함된 문자의 서식을 지정할 수 있습니다. Microsoft.Office.Interop.Excel.Characters 개체는 컬렉션이 아닙니다.

선택적 매개 변수

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

예제

다음 코드 예제에서는 NamedRange를 만들고 Smith라는 단어로 채웁니다. 그런 다음 단어의 첫 번째 문자를 굵게 만들고 크기를 14로 설정하여 변경합니다.

이 버전은 문서 수준 사용자 지정을 위한 것입니다.

Private charactersRange As Microsoft.Office.Tools.Excel.NamedRange

Private Sub FormatCharacters()
    charactersRange = Me.Controls.AddNamedRange( _
        Me.Range("A1", "A1"), "charactersRange")
    Me.charactersRange.Value2 = "Smith"
    Me.charactersRange.Characters(1, 1).Font.Bold = True
    Me.charactersRange.Characters(1, 1).Font.Size = 14
End Sub

Microsoft.Office.Tools.Excel.NamedRange charactersRange;
private void FormatCharacters()
{
    charactersRange = this.Controls.AddNamedRange(
        this.Range["A1", "A1"], "charactersRange");
    this.charactersRange.Value2 = "Smith";
    this.charactersRange.Characters[1, 1].Font.Bold = true;
    this.charactersRange.Characters[1, 1].Font.Size = 14;
}

이 버전은 응용 프로그램 수준 추가 기능을 위한 것입니다.

Private charactersRange As NamedRange

Private Sub FormatCharacters()

    Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
Globals.ThisAddIn.Application.ActiveSheet

    Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
            Globals.Factory.GetVstoObject(NativeWorksheet)

    charactersRange = vstoWorksheet.Controls.AddNamedRange( _
        vstoWorksheet.Range("A1", "A1"), "charactersRange")
    Me.charactersRange.Value2 = "Smith"
    Me.charactersRange.Characters(1, 1).Font.Bold = True
    Me.charactersRange.Characters(1, 1).Font.Size = 14
End Sub

NamedRange charactersRange;
private void FormatCharacters()
{
    Worksheet vstoWorksheet =
        Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook.Worksheets[1]); ;
    charactersRange = vstoWorksheet.Controls.AddNamedRange(
        vstoWorksheet.Range["A1", "A1"], "charactersRange");
    charactersRange.Value2 = "Smith";
    charactersRange.Characters[1, 1].Font.Bold = true;
    charactersRange.Characters[1, 1].Font.Size = 14;
}

.NET Framework 보안

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

참고 항목

참조

NamedRange 인터페이스

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