ControlExtensions.AddHScrollBar Método

Definição

Sobrecargas

AddHScrollBar(ControlCollection, Range, Single, Single, String)

Adiciona um novo controle HScrollBar ao documento no tamanho e local especificados.

AddHScrollBar(ControlCollection, Single, Single, Single, Single, String)

Adiciona um novo controle HScrollBar ao documento no tamanho e local especificados.

AddHScrollBar(ControlCollection, Range, Single, Single, String)

Adiciona um novo controle HScrollBar ao documento no tamanho e local especificados.

public static Microsoft.Office.Tools.Word.Controls.HScrollBar AddHScrollBar (this Microsoft.Office.Tools.Word.ControlCollection controls, Microsoft.Office.Interop.Word.Range range, float width, float height, string name);

Parâmetros

controls
ControlCollection

A coleção a ser adicionada ao controle. Não forneça esse parâmetro. Quando você chama esse método na coleção retornada pela propriedade Controls (em um projeto no nível de aplicativo) ou Controls (em um projeto no nível de documento), esse parâmetro é fornecido automaticamente.

range
Range

O local do controle.

width
Single

A largura do controle em pontos.

height
Single

A altura do controle em pontos.

name
String

O nome que pode ser usado para indexar o controle na instância de ControlCollection.

Retornos

HScrollBar

O controle que foi adicionado ao documento.

Exceções

O argumento name ou range é null ou o argumento name tem tamanho zero.

Um controle com o mesmo nome já está na instância de ControlCollection.

O intervalo que foi especificado não é válido.

Exemplos

O exemplo de código a seguir adiciona um HScrollBar controle ao primeiro parágrafo no documento e, em seguida, move a caixa de rolagem para o centro da barra de rolagem. Para usar esse exemplo, execute-o na classe ThisDocument em um projeto no nível de documento.

private void WordRangeAddHScrollBar()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.HScrollBar
        hScrollBar1 = this.Controls.AddHScrollBar(
        this.Paragraphs[1].Range, 100, 15, "hScrollBar1");
    hScrollBar1.Value = 50;
}
Private Sub WordRangeAddHScrollBar()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim HScrollBar1 As Microsoft.Office.Tools.Word.Controls. _
        HScrollBar = Me.Controls.AddHScrollBar(Me.Paragraphs(1). _
        Range, 100, 15, "HScrollBar1")
    HScrollBar1.Value = 50
End Sub 

Comentários

Esse método permite que você adicione HScrollBar objetos ao final do ControlCollection .

Para remover um HScrollBar controle que foi adicionado programaticamente, use o Remove método.

Aplica-se a

AddHScrollBar(ControlCollection, Single, Single, Single, Single, String)

Adiciona um novo controle HScrollBar ao documento no tamanho e local especificados.

public static Microsoft.Office.Tools.Word.Controls.HScrollBar AddHScrollBar (this Microsoft.Office.Tools.Word.ControlCollection controls, float left, float top, float width, float height, string name);

Parâmetros

controls
ControlCollection

A coleção a ser adicionada ao controle. Não forneça esse parâmetro. Quando você chama esse método na coleção retornada pela propriedade Controls (em um projeto no nível de aplicativo) ou Controls (em um projeto no nível de documento), esse parâmetro é fornecido automaticamente.

left
Single

A distância em pontos entre a borda esquerda do controle e a borda esquerda do documento.

top
Single

A distância em pontos entre a borda superior do controle e a borda superior do documento.

width
Single

A largura do controle em pontos.

height
Single

A altura do controle em pontos.

name
String

O nome que pode ser usado para indexar o controle na instância de ControlCollection.

Retornos

HScrollBar

O controle que foi adicionado ao documento.

Exceções

O argumento name é null ou tem tamanho zero.

Um controle com o mesmo nome já está na instância de ControlCollection.

Exemplos

O exemplo de código a seguir adiciona um HScrollBar controle ao início do documento e, em seguida, move a caixa de rolagem para o centro da barra de rolagem. Para usar esse exemplo, execute-o na classe ThisDocument em um projeto no nível de documento.

private void WordAddHScrollBar()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.HScrollBar
        hScrollBar1 = this.Controls.AddHScrollBar(
        0, 0, 100, 15, "hScrollBar1");
    hScrollBar1.Value = 50;
}
Private Sub WordAddHScrollBar()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim HScrollBar1 As Microsoft.Office.Tools.Word.Controls. _
        HScrollBar = Me.Controls.AddHScrollBar(0, 0, 100, 15, _
        "HScrollBar1")
    HScrollBar1.Value = 50
End Sub 

Comentários

Esse método permite que você adicione HScrollBar objetos ao final do ControlCollection .

Para remover um HScrollBar controle que foi adicionado programaticamente, use o Remove método.

Aplica-se a