Control.Focus Método
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.
Define o foco de entrada para o controle.
public:
bool Focus();
public bool Focus ();
member this.Focus : unit -> bool
Public Function Focus () As Boolean
Retornos
true
se a solicitação de foco de entrada tiver sido bem-sucedida; caso contrário, false
.
Exemplos
O exemplo de código a seguir define o foco como o especificado Control, se ele puder receber o foco.
public:
void ControlSetFocus( Control^ control )
{
// Set focus to the control, if it can receive focus.
if ( control->CanFocus )
{
control->Focus();
}
}
public void ControlSetFocus(Control control)
{
// Set focus to the control, if it can receive focus.
if(control.CanFocus)
{
control.Focus();
}
}
Public Sub ControlSetFocus(control As Control)
' Set focus to the control, if it can receive focus.
If control.CanFocus Then
control.Focus()
End If
End Sub
Comentários
O Focus método retornará true
se o controle tiver recebido com êxito o foco de entrada. O controle pode ter o foco de entrada enquanto não exibe nenhuma indicação visual de ter o foco. Esse comportamento é observado principalmente pelos controles não reelecionáveis listados abaixo ou por quaisquer controles derivados deles.
Um controle poderá ser selecionado e receber o foco de entrada se todos os seguintes forem verdadeiros: o Selectable
valor de ControlStyles é definido como true
, ele está contido em outro controle e todos os seus controles pai estão visíveis e habilitados.
Os controles de Windows Forms na lista a seguir não são selecionáveis. Os controles derivados desses controles também não são selecionáveis.
LinkLabel (quando não há nenhum link presente no controle)
Observação
Focus é um método de baixo nível destinado principalmente a autores de controle personalizado. Em vez disso, os programadores de aplicativos devem usar o Select método ou a ActiveControl propriedade para controles filho ou o Activate método para formulários.