Form.IsMdiContainer Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se o formulário é um contêiner para formulários filho de interface MDI.
public:
property bool IsMdiContainer { bool get(); void set(bool value); };
public bool IsMdiContainer { get; set; }
member this.IsMdiContainer : bool with get, set
Public Property IsMdiContainer As Boolean
Valor da propriedade
true
se o formulário for um contêiner para os formulários filho MDI; caso contrário, false
. O padrão é false
.
Exemplos
O exemplo a seguir demonstra o uso da IsMdiContainer propriedade, bem como a alteração da BackColor
propriedade de um Formulário MDI. Para executar este exemplo, cole o código a seguir em um novo formulário.
// Create a new form.
Form mdiChildForm = new Form();
private void Form1_Load(object sender, System.EventArgs e)
{
// Set the IsMdiContainer property to true.
IsMdiContainer = true;
// Set the child form's MdiParent property to
// the current form.
mdiChildForm.MdiParent = this;
// Call the method that changes the background color.
SetBackGroundColorOfMDIForm();
}
private void SetBackGroundColorOfMDIForm()
{
foreach ( Control ctl in this.Controls )
{
if ((ctl) is MdiClient)
// If the control is the correct type,
// change the color.
{
ctl.BackColor = System.Drawing.Color.PaleGreen;
}
}
}
' Create a new form.
Dim mdiChildForm As New Form
Private Sub Form1_Load(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles MyBase.Load
' Set the IsMdiContainer property to true.
IsMdiContainer = True
' Set the child form's MdiParent property to
' the current form.
mdiChildForm.MdiParent = Me
'Call the method that changes the background color.
SetBackGroundColorOfMDIForm()
End Sub
Private Sub SetBackGroundColorOfMDIForm()
Dim ctl As Control
' Loop through controls,
' looking for controls of MdiClient type.
For Each ctl In Me.Controls
If TypeOf (ctl) Is MdiClient Then
' If the control is the correct type,
' change the color.
ctl.BackColor = System.Drawing.Color.PaleGreen
End If
Next
End Sub
Comentários
Essa propriedade altera a exibição e o comportamento do formulário para um formulário pai MDI. Quando essa propriedade é definida como true
, o formulário exibe uma área de cliente submersa com uma borda elevada. Todos os formulários filho MDI atribuídos ao formulário pai são exibidos em sua área de cliente.
Quando um formulário pai MDI é fechado, os Closing eventos de todos os formulários filho MDI são gerados antes que o evento do formulário pai da Closing MDI seja gerado. Além disso, os Closed eventos de todos os formulários filho MDI são gerados antes que o Closed evento do formulário pai da MDI seja gerado.
Observação
Se houver dois MenuStrip controles em um formulário filho MDI, a configuração IsMdiContainer como true
para o formulário pai mescla o conteúdo de apenas um dos MenuStrip controles. Use Merge para mesclar o conteúdo de controles filho MenuStrip adicionais no formulário pai do MDI.