NamedRange.Characters Свойство

Определение

Возвращает объект Characters, представляющий диапазон символов в тексте элемента управления NamedRange.Gets a Characters object that represents a range of characters within the text of the NamedRange control.

public Microsoft.Office.Tools.Excel.NamedRange_CharactersType Characters { get; }

Значение свойства

NamedRange_CharactersType

Объект Characters, представляющий диапазон символов в тексте элемента управления NamedRange.A Characters object that represents a range of characters within the text of the NamedRange control.

Примеры

В следующем примере кода создается NamedRange и заполняется словом Smith.The following code example creates a NamedRange and populates it with the word Smith. Затем он изменяет первый символ в слове, сделав его полужирным и устанавливая размер равным 14.It then changes the first character in the word by making it bold and setting the size to 14.

Эта версия предназначена для настройки на уровне документа.This version is for a document-level customization.

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

Эта версия предназначена для надстройки уровня приложения.This version is for an application-level add-in.

Комментарии

CharactersСвойство предназначено для использования со следующими параметрами.The Characters property is intended to be used with the following parameters.

ПараметрParameter ОписаниеDescription
Start Первый возвращаемый символ.The first character to be returned. Если этот аргумент имеет значение 1 или не указан, это свойство возвращает диапазон символов, начиная с первого символа.If this argument is either 1 or omitted, this property returns a range of characters starting with the first character.
Length Число возвращаемых символов.The number of characters to be returned. Если этот аргумент опущен, это свойство возвращает оставшуюся часть строки (все Start символы после символа).If this argument is omitted, this property returns the remainder of the string (everything after the Start character).

Если вы попытаетесь использовать Characters без указания каких-либо параметров, Characters получит NamedRange_CharactersType объект, который является частью инфраструктуры Visual Studio и не предназначен для использования непосредственно из кода.If you attempt to use Characters without specifying any parameters, Characters will get a NamedRange_CharactersType object that is part of the Visual Studio infrastructure and is not intended to be used directly from your code.

Объект можно использовать Microsoft.Office.Interop.Excel.Characters для форматирования символов в текстовой строке.You can use the Microsoft.Office.Interop.Excel.Characters object to format characters within a text string. Microsoft.Office.Interop.Excel.CharactersОбъект не является коллекцией.The Microsoft.Office.Interop.Excel.Characters object is not a collection.

Необязательные параметрыOptional Parameters

Дополнительные сведения о необязательных параметрах см. в разделе необязательные параметры в решениях Office.For information on optional parameters, see Optional Parameters in Office Solutions.

Применяется к