NamedRange.Characters Свойство (2007 System)

Статья
11/16/2008

Обновлен: Июль 2008

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

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
<BrowsableAttribute(False)> _
Public ReadOnly Property Characters As NamedRange..::._CharactersType
'Применение
Dim instance As NamedRange
Dim value As NamedRange..::._CharactersType

value = instance.Characters

[BrowsableAttribute(false)]
public 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 Tools for Office и не предназначен для использования непосредственно из кода.

Объект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 vstoWorksheet As Worksheet = CType( _
        Me.Application.ActiveWorkbook.Worksheets(1),  _
        Excel.Worksheet).GetVstoObject()
    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 = ((Excel.Worksheet)
        this.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
    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;
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

NamedRange Класс

NamedRange - члены

Microsoft.Office.Tools.Excel - пространство имен

Журнал изменений

Дата	Журнал событий	Причина
Июль 2008	Добавлена версия кода для надстройки уровня приложения.	Изменение функции SP1.

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