Form.ActiveForm Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe o formulário atualmente ativo para esta candidatura.
public:
static property System::Windows::Forms::Form ^ ActiveForm { System::Windows::Forms::Form ^ get(); };
public static System.Windows.Forms.Form ActiveForm { get; }
static member ActiveForm : System.Windows.Forms.Form
Public Shared ReadOnly Property ActiveForm As Form
Valor de Propriedade
A Form que representa a forma atualmente ativa, ou null se não existir forma ativa.
Exemplos
O exemplo seguinte obtém a forma ativa e desativa todos os controlos da forma. O exemplo utiliza a Controls coleção do formulário para iterar por cada controlo no formulário e desativar os controlos.
void DisableActiveFormControls()
{
// Create an instance of a form and assign it the currently active form.
Form^ currentForm = Form::ActiveForm;
// Loop through all the controls on the active form.
for ( int i = 0; i < currentForm->Controls->Count; i++ )
{
// Disable each control in the active form's control collection.
currentForm->Controls[ i ]->Enabled = false;
}
}
public void DisableActiveFormControls()
{
// Create an instance of a form and assign it the currently active form.
Form currentForm = Form.ActiveForm;
// Loop through all the controls on the active form.
for (int i = 0; i < currentForm.Controls.Count; i++)
{
// Disable each control in the active form's control collection.
currentForm.Controls[i].Enabled = false;
}
}
Public Sub DisableActiveFormControls()
' Create an instance of a form and assign it the currently active form.
Dim currentForm As Form = Form.ActiveForm
' Loop through all the controls on the active form.
Dim i As Integer
For i = 0 To currentForm.Controls.Count - 1
' Disable each control in the active form's control collection.
currentForm.Controls(i).Enabled = False
Next i
End Sub
Observações
Pode usar este método para obter uma referência ao formulário atualmente ativo para realizar ações no formulário ou nos seus controlos.
Se a sua aplicação for uma aplicação de interface de múltiplos documentos (MDI), use a ActiveMdiChild propriedade para obter o formulário filho MDI atualmente ativo.