Compartilhar via


Como: Use os modificadores e as propriedades de GenerateMember

Quando você coloca um componente em um Windows Form, duas propriedades são fornecidas pelo ambiente de design: GenerateMember e Modifiers. A propriedade GenerateMember especifica quando o Windows Forms Designer gera um variável de membro de um componente. A propriedade Modifiers é o modificador de acesso atribuído a que variável de membro. Se o valor da propriedade GenerateMember for false, o valor da propriedade Modifiers não tem efeito.

ObservaçãoObservação

As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

Para especificar se um componente é um membro do formulário

  1. Abra o formulário no Windows Forms Designer.

  2. Abra a Caixa de Ferramentas e no formulário, coloque três controles Button.

  3. Defina as propriedades GenerateMember e Modifiers para cada controle Button de acordo com a tabela a seguir.

    Nome do botão

    Valor GenerateMember

    Valor modificadores

    button1

    true

    private

    button2

    true

    protected

    button3

    false

    Nenhuma alteração

  4. Crie a solução.

  5. Em Solution Explorer, clique na Mostrar todos os arquivos botão.

  6. Abra o nó Form1 e no Editor de códigos , abra o arquivo Form1.Designer.vb ou Form1.Designer.cs. Este arquivo contém o código emitido pelo Windows Forms Designer.

  7. Localize as declarações dos três botões. O código exemplo a seguir mostra as diferenças especificadas pelas propriedades GenerateMember e Modifiers.

    Private Sub InitializeComponent()
    
        ' button3 is declared in a local scope, because 
        ' its GenerateMember property is false.
        Dim button3 As System.Windows.Forms.Button
        Me.button1 = New System.Windows.Forms.Button()
        Me.button2 = New System.Windows.Forms.Button()
        button3 = New System.Windows.Forms.Button()
    
    private void InitializeComponent()
    {   
        // button3 is declared in a local scope, because 
        // its GenerateMember property is false.
        System.Windows.Forms.Button button3;
        this.button1 = new System.Windows.Forms.Button();
        this.button2 = new System.Windows.Forms.Button();
        button3 = new System.Windows.Forms.Button();
    
     ' The Modifiers property for button1 is "Private".
     Private button1 As Button
    
     ' The Modifiers property for button2 is "Protected".
     Protected button2 As Button
    
    ' button3 is not a member, because 
    ' its GenerateMember property is false.
    
    // The Modifiers property for button1 is "private".
    private Button button1;
    
    // The Modifiers property for button2 is "protected".
    protected Button button2;
    
    // button3 is not a member, because 
    // its GenerateMember property is false.
    
ObservaçãoObservação

Por padrão, o Windows Forms Designer atribui o modificador private (Friend no Visual Basic) para controles recipientes, como Panel. Se seu UserControl ou Form base possui em controle recipiente, ele não aceitará novos filhos em controles em formulários herdados. A solução é alterar o modificador do controle recipente base para protected ou public.

Consulte também

Tarefas

Demonstra Passo a passo: Demonstrando a herança Visual

Como: Herdar de Windows Forms

Referência

Button

Outros recursos

Herança visual Formulários do Windows