Padding Estrutura

Definição

Espaço de Nomes:

System.Windows.Forms

Assemblagem:

System.Windows.Forms.dll

Representa informação de preenchimento ou margem associada a um elemento da interface de utilizador (UI).

public value class Padding

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.PaddingConverter))]
[System.Serializable]
public struct Padding

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.PaddingConverter))>]
[<System.Serializable>]
type Padding = struct

Public Structure Padding

Herança

Object

ValueType

Padding

Atributos

TypeConverterAttribute SerializableAttribute

Exemplos

O exemplo de código seguinte demonstra como usar a propriedade Padding para criar um contorno em torno de um RichTextBox controlo.

Para uma listagem completa do código, consulte Como: Criar uma Borda em Torno de um Controlo Windows Forms Usando Padding.

// This code example demonstrates using the Padding property to 
// create a border around a RichTextBox control.
public Form1()
{
    InitializeComponent();

    this.panel1.BackColor = System.Drawing.Color.Blue;
    this.panel1.Padding = new System.Windows.Forms.Padding(5);
    this.panel1.Dock = System.Windows.Forms.DockStyle.Fill;

    this.richTextBox1.BorderStyle = System.Windows.Forms.BorderStyle.None;
    this.richTextBox1.Dock = System.Windows.Forms.DockStyle.Fill;
}

' This code example demonstrates using the Padding property to 
' create a border around a RichTextBox control.
Public Sub New()
     InitializeComponent()

     Me.panel1.BackColor = System.Drawing.Color.Blue
     Me.panel1.Padding = New System.Windows.Forms.Padding(5)
     Me.panel1.Dock = System.Windows.Forms.DockStyle.Fill

     Me.richTextBox1.BorderStyle = System.Windows.Forms.BorderStyle.None
     Me.richTextBox1.Dock = System.Windows.Forms.DockStyle.Fill
 End Sub

Observações

A Padding estrutura representa o preenchimento ou margem associada a um elemento retangular da interface, como um controlo. O preenchimento é o espaço interno entre o corpo do elemento da interface e a sua borda. Em contraste, uma margem é a distância que separa as arestas adjacentes de dois elementos UI adjacentes. Devido a semelhanças estruturais, Padding é usado para representar tanto o enchimento como as margens.

Para um diagrama que ilustra as propriedades Padding e Margin num controlo, veja Margin e Padding em Windows Forms Controls.

O enchimento tem um efeito diferente nos controlos que são containers do que nos controlos que não são. Por exemplo, num Panel controlo, a Padding propriedade define o espaçamento entre a borda dos controlos e Panel os seus controlos filhos. Para um Button controlo, a Padding propriedade define o espaçamento entre a borda do Button controlo e o texto contido.

Para além dos métodos e propriedades típicas, Padding define também os seguintes membros ao nível do tipo:

• O Empty campo, que representa um predefinido Padding sem preenchimento (enched).

• Um conjunto de operadores para realizar operações aritméticas comuns para a classe, como adicionar dois Padding objetos. Para linguagens que não suportam sobrecarga de operadores, pode invocar estes membros usando sintaxe alternativa de método.

• As Horizontalpropriedades , Vertical, e Size , que fornecem valores combinados convenientes para uso em cálculos personalizados de layout.

Construtores

Name	Description
Padding(Int32, Int32, Int32, Int32)	Inicializa uma nova instância da Padding classe usando um tamanho de preenchimento separado para cada aresta.
Padding(Int32)	Inicializa uma nova instância da Padding classe usando o tamanho de preenchimento fornecido para todas as arestas.

Campos

Name	Description
Empty	Fornece um Padding objeto sem acolchoamento.

Propriedades

Name	Description
All	Obtém ou define o valor de enchimento para todas as arestas.
Bottom	Obtém ou define o valor de enchimento para a aresta inferior.
Horizontal	Obtém o acolchoamento combinado para as bordas direita e esquerda.
Left	Obtém ou define o valor de preenchimento para a aresta esquerda.
Right	Obtém ou define o valor de enchimento para a aresta direita.
Size	Obtém a informação de enchimento sob a forma de um Size.
Top	Obtém ou define o valor de preenchimento para a aresta superior.
Vertical	Obtém o acolchoamento combinado para as bordas superior e inferior.

Métodos

Name	Description
Add(Padding, Padding)	Calcula a soma dos dois valores especificados Padding .
Equals(Object)	Determina se o valor do objeto especificado é equivalente à corrente Padding.
GetHashCode()	Gera um código de hash para o atual Padding.
Subtract(Padding, Padding)	Subtrai um valor especificado Padding a outro.
ToString()	Devolve uma cadeia que representa a corrente Padding.

Operadores

Name	Description
Addition(Padding, Padding)	Realiza adição vetorial nos dois objetos especificados Padding , resultando num novo Padding.
Equality(Padding, Padding)	Testa se dois objetos especificados Padding são equivalentes.
Inequality(Padding, Padding)	Testa se dois objetos especificados Padding não são equivalentes.
Subtraction(Padding, Padding)	Realiza subtração vetorial nos dois objetos especificados Padding , resultando num novo Padding.

Ver também

• Padding
• e preenchimento nos controlos Windows Forms