HtmlForm.DefaultFocus Свойство

Определение

Возвращает или задает на форме элемент управления для отображения в качестве элемента управления с фокусом ввода при загрузке элемента управления HtmlForm.Gets or sets the control on the form to display as the control with input focus when the HtmlForm control is loaded.

public:
 property System::String ^ DefaultFocus { System::String ^ get(); void set(System::String ^ value); };
public string DefaultFocus { get; set; }
member this.DefaultFocus : string with get, set
Public Property DefaultFocus As String

Значение свойства

Свойство ClientID элемента управления на форме, чтобы отобразить в качестве элемента управления с фокусом ввода при загрузке элемента управления HtmlForm.The ClientID of the control on the form to display as the control with input focus when the HtmlForm is loaded. Значением по умолчанию является пустая строка ("").The default value is an empty string ("").

Примеры

В следующем примере кода показано, как задать свойство DefaultFocus для отображения указанного элемента управления в форме в качестве элемента управления с фокусом ввода при загрузке формы.The following code example demonstrates how to set the DefaultFocus property to display a specified control on a form as the control with input focus when the form loads. При отображении Form1 обратите внимание, что точка вставки располагается в TextBox1, что означает, что TextBox1 — это элемент управления с фокусом.When Form1 renders, notice that the insertion point is positioned in TextBox1, indicating that TextBox1 is the control with focus.

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">     
   
  void Page_Load(object sender, System.EventArgs e)
  {
    
    // Set the text of the two label controls.
    Label1.Text = "The DefaultButton property is set to "
                + Form1.DefaultButton.ToString() + "<br/>";
    Label2.Text = "The DefaultFocus property is set to "
                + Form1.DefaultFocus.ToString();
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>

    <title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>

</head>

<body>

  <form id="Form1"
        defaultbutton="SubmitButton"
        defaultfocus="TextBox1"
        runat="server">
    
    <h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>        
  
    TextBox1:
    <asp:textbox id="TextBox1"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br />
  
    TextBox2:
    <asp:textbox id="TextBox2"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br /><br />
  
    <asp:button id="SubmitButton"
                text="Submit" 
                runat="server">
    </asp:button>
  
    <asp:button id="CancelButton" 
                text="Cancel"
                runat="server">
    </asp:button>
  
    <hr />
  
    <asp:label id="Label1"
               runat="Server">
    </asp:label>
  
    <asp:label id="Label2"
               runat="Server">
    </asp:label>

  </form>

</body>

</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="Server">
       
  Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    
    ' Set the text of the two label controls.
    Label1.Text = "The DefaultButton property is set to " _
                  & Form1.DefaultButton.ToString & "<br/>"
    Label2.Text = "The DefaultFocus property is set to " _
                  & Form1.DefaultFocus.ToString
  End Sub
     
 </script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>

    <title>HtmlForm DefaultButton and DefaultFocus Properties Example</title>

</head>

<body>

  <form id="Form1"
        defaultbutton="SubmitButton"
        defaultfocus="TextBox1"
        runat="server">
    
    <h3>HtmlForm DefaultButton and DefaultFocus Properties Example</h3>        
  
    TextBox1:
    <asp:textbox id="TextBox1"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br />
  
    TextBox2:
    <asp:textbox id="TextBox2"
                 autopostback="true" 
                 runat="server">
    </asp:textbox>
  
    <br /><br />
  
    <asp:button id="SubmitButton"
                text="Submit" 
                runat="server">
    </asp:button>
  
    <asp:button id="CancelButton" 
                text="Cancel"
                runat="server">
    </asp:button>
  
    <hr />
  
    <asp:label id="Label1"
               runat="Server">
    </asp:label>
  
    <asp:label id="Label2"
               runat="Server">
    </asp:label>

  </form>

</body>

</html>

Комментарии

Используйте свойство DefaultFocus для доступа к элементу управления в форме, который отображается как элемент управления с фокусом ввода при загрузке элемента управления HtmlForm.Use the DefaultFocus property to access the control on the form to display as the control with input focus when the HtmlForm control is loaded. Элементы управления, которые могут быть выбраны, отображаются с визуальной подсказкой, указывающей на то, что они имеют фокус.Controls that can be selected are displayed with a visual cue indicating that they have the focus. Например, элемент управления TextBox с фокусом отображается с точкой вставки, расположенной внутри нее.For example, a TextBox control with focus is displayed with the insertion point positioned inside of it.

Элемент управления с фокусом также можно задать с помощью методов Focus или SetFocus.The control with focus can also be set using the Focus or SetFocus methods. Эти методы имеют приоритет над свойством DefaultFocus.These methods have precedence over the DefaultFocus property. Если один из этих методов вызывается для установки фокуса на элемент управления, значение свойства DefaultFocus игнорируется.If either of these methods are called to set the control with focus, the value of the DefaultFocus property is ignored.

Применяется к

Дополнительно