NamedRange.Characters - свойство

Статья
08/11/2011

Возвращает объект Microsoft.Office.Interop.Excel.Characters, представляющий диапазон символов в тексте элемента управления NamedRange.

Пространство имен: 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
Объект Microsoft.Office.Interop.Excel.Characters, представляющий диапазон символов в тексте элемента управления NamedRange.

Заметки

Свойство Characters должно использоваться с указанными ниже параметрами.

Параметр	Описание
Start	Первый возвращаемый символ. Если этот аргумент не указан или имеет значение 1, данное свойство возвращает диапазон символов, начиная с первого символа.
Length	Число возвращаемых символов. Если этот аргумент не указан, данное свойство возвращает оставшуюся часть строки (все, что находится после символа Start).

При попытке использования свойства Characters без указания каких-либо параметров свойство Characters получит объект NamedRange_CharactersType, который является частью инфраструктуры Visual Studio и не предназначен для использования непосредственно из кода.

Объект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 - пространство имен

Поделиться через