Partilhar via


Nomes, Assistente de propriedade

Use este assistente para adicionar uma propriedade a uma interface.

  • Tipo de propriedade
    Define o tipo da propriedade que você está adicionando.MFC dispinterfaces, fornecer seu próprio tipo ou selecionar da lista predefinida.Se você fornecer uma implementação das ações de uma propriedade, Tipo de propriedade é conjunto ao tipo de ações e não disponível para a alterar.

  • Nome de propriedade
    Define o nome da propriedade.Para o MFC dispinterfaces associados a controles ActiveX, você pode fornecer seu próprio nome ou selecionar um nome de propriedade das ações da lista predefinida.Se você fornecer seu próprio nome de propriedade, a Estoque tipo de implementação não disponível.See Propriedades de ações para uma descrição das propriedades da lista.

    Tipo de interface

    Descrição

    ATL dual interface, interface personalizada e interface local personalizado

    Forneça um nome de propriedade.

    Dispinterface de MFC, dispinterface de controle ActiveX MFC ActiveX

    Forneça um nome de propriedade ou selecionar uma propriedade das ações da lista.Se você selecionar uma propriedade na lista, o valor apropriado é exibido na Tipo de propriedade box.Você pode alterar esse tipo, dependendo da sua seleção em Tipo de implementação.

  • Tipo de retorno
    Somente interfaces ATL.Define o tipo de retorno da propriedade.Para interfaces duas, HRESULT sempre é o tipo de retorno e essa caixa não estiver disponível. Para interfaces personalizadas, você pode selecionar um tipo de retorno da lista.HRESULT é ainda recomendável, pois ele fornece um meio padrão para retornar erros.

  • Nome da variável
    Somente dispinterfaces MFC.Disponível somente se você especificar Variável de membro under Tipo de implementação.Define o nome da variável de membro ao qual a propriedade está associada.Por padrão, o nome da variável é conjunto m_ PropertyName.Você pode edição esse nome.

  • Função de notificação
    Somente dispinterfaces MFC.Disponível somente se você especificar Variável de membro under Tipo de implementação.Define o nome da notificação função chamada se as alterações de propriedades.Por padrão, o nome da função de notificação é conjunto on a PropertyNameAlterado.Você pode edição esse nome.

  • Obter função
    Para dispinterfaces MFC.Disponível somente se você especificar Obter / conjunto métodos under Tipo de implementação.Define o nome da função para obter a propriedade.Por padrão, o nome da função get é definido como GetPropertyName.Você pode edição esse nome.Se você excluir o nome, a função GetNotSupported é inserido no MAP de despacho de interface.O Get PropertyName função especifica que a propriedade sistema autônomo legível.

  • Função de conjunto
    Somente dispinterfaces MFC.Disponível somente se você especificar Obter / conjunto métodos under Tipo de implementação.Define o nome da função para conjunto a propriedade.Por padrão, o nome da função conjunto é definido como definir PropertyName.Você pode edição esse nome.Se você excluir o nome, a função SetNotSupported é inserido no MAP de despacho de interface.O conjunto de PropertyName função especifica que a propriedade é gravável.

  • Tipo de implementação
    Somente dispinterfaces MFC.Especifica como implementar a propriedade que você está adicionando.

    Tipo de implementação

    Descrição

    Estoque

    Especifica uma implementação de estoque para a propriedade selecionada em Nome de propriedade.O padrão.See Propriedades de ações para obter mais informações.

    Se você especificar Estoque, then Tipo de propriedade, Tipo de parâmetro, and Nome do parâmetro ficam esmaecidos.

    Variável de membro

    Especifica que a propriedade é adicionada sistema autônomo uma variável de membro.Você pode adicionar propriedades personalizadas ou a maioria das propriedades de ações sistema autônomo variáveis de membro.Não é possível especificar Variável de membro for Legenda, hWnd, and Texto propriedades.

    Fornece nomes padrão em Nome da variável and Função de notificação.Você pode edição esse nome.

    Obter / conjunto métodos

    Especifica que a propriedade é adicionada sistema autônomo Get PropertyName and conjuntoPropertyName funções, por padrão.Esses nomes aparecerão em Obter função and Função de conjunto.

    Você pode alterar o padrão de Tipo de propriedade, que transmite um valor para a função get.Você pode especificar parâmetros para o Obter and Set funções.

  • Obter função
    Para interfaces ATL.Define a propriedade sistema autônomo legível; ou seja, ele cria o Obtermétodo para recuperar esta propriedade do objeto.Você deve selecionar Obter, Put, ou ambos.

  • Inserir função
    Somente interfaces ATL.Define a propriedade gravável; ou seja, ele cria o Putmétodo de configuração, ou "colocar", essa propriedade do objeto. Você deve selecionar Obter, Put, ou ambos. Se você selecionar essa opção, você pode escolher entre duas maneiras para implementar o método a seguir:

    Opção

    Descrição

    PropPut

    The PropPut função retorna uma cópia do objeto.Este é o padrão e a maneira mais comum para tornar a propriedade gravável.

    PropPutRef

    The PropPutRef função retorna uma referência para o objeto, em vez de retornar a cópia do próprio objeto.Utilize esta opção para objetos, sistema autônomo estruturas grandes ou conjuntos, que podem ter sobrecarga de inicialização.

  • Atributos de parâmetro
    Somente interfaces ATL.Define se o parâmetro especificado por Nome do parâmetro is em, check-out, ambos ou nenhum.

    Opção

    Descrição

    Em

    Indica que o parâmetro é passado do procedimento de chamada para o procedimento chamado.

    Limite

    Indica que o parâmetro de ponteiro é retornado pelo procedimento chamado para o procedimento de chamada (do servidor para o cliente).

  • Tipo de parâmetro
    Define o tipo de dados do parâmetro.selecionar o tipo da lista.

  • Nome do parâmetro
    Define o nome de um parâmetro que você está adicionando a propriedade, se a propriedade tem parâmetros.Depois de clicar em Adicionar, o nome do parâmetro é exibido em Lista de parâmetros.

  • Lista de parâmetros
    Exibe a lista de atributos para ser adicionado à propriedade.Cada item na lista consiste em nome do parâmetro, tipo de parâmetro e atributos.Use Adicionar and Remover para atualizar a lista.

  • Adicionar
    Adiciona o parâmetro especificado no Nome do parâmetro and Tipo de parâmetro to the Lista de parâmetros.clicar Adicionar para adicionar um parâmetro à lista.

  • Remove
    Remove o parâmetro que você seleciona em Lista de parâmetros.

  • Propriedade padrão
    Dispinterface de MFC somente.Define esta propriedade sistema autônomo o padrão para a interface.Uma interface pode ter apenas um padrão propriedade; depois de você especificar a propriedade padrão, para quaisquer outras propriedades que você adicionar a interface do, essa caixa não estiver disponível.

Consulte também

Tarefas

Adicionar uma propriedade

Implementando uma interface

Referência

Propriedade atributos IDL, Assistente