Compartilhar via


Nomes, Assistente para Adicionar Propriedade

Use este assistente para adicionar uma propriedade a uma interface.

  • Tipo de propriedade
    Define o tipo de propriedade que você está adicionando.Para dispinterfaces do MFC, fornecer seu próprio tipo ou selecione da lista predefinida.Se você fornecer uma implementação de estoque de uma propriedade, tipo de propriedade é definido como o tipo de ações e não está disponível para a alteração.

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

    Tipo de interface

    Descrição

    Interface dupla da ATL, interface personalizada e interface personalizada local

    Forneça um nome de propriedade.

    Dispinterface MFC, dispinterface de controle de ActiveX do MFC

    Forneça um nome de propriedade ou selecione uma propriedade das ações da lista.Se você selecionar uma propriedade da lista, o valor apropriado aparece no tipo de propriedade caixa.Você pode alterar esse tipo, dependendo da 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 está disponível.Para interfaces personalizadas, você pode selecionar um tipo de retorno da lista.HRESULTé recomendado, pois oferece uma maneira padrão para retornar erros.

  • Nome da variável
    Somente dispinterfaces do MFC.Disponível somente se você especificar variável de membro em 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 é definido como m _PropertyName.Você pode editar este nome.

  • Função de notificação
    Somente dispinterfaces do MFC.Disponível somente se você especificar variável de membro em tipo de implementação.Define o nome do notificação função chamada se as alterações de propriedade.Por padrão, o nome da função de notificação é definido emPropertyNameChanged.Você pode editar este nome.

  • Obter a função
    Para dispinterfaces do MFC.Disponível somente se você especificar métodos Get/Set em tipo de implementação.Define o nome da função para obter a propriedade.Por padrão, o nome da função Get é definido para GetPropertyName.Você pode editar este nome.Se você excluir o nome, a função GetNotSupported é inserido no mapa de despacho de interface.GetPropertyName função especifica que a propriedade como legível.

  • Função de conjunto
    Somente dispinterfaces do MFC.Disponível somente se você especificar métodos Get/Set em tipo de implementação.Define o nome da função para definir a propriedade.Por padrão, o nome da função conjunto é definido para o conjunto dePropertyName.Você pode editar este nome.Se você excluir o nome, a função SetNotSupported é inserido no mapa de despacho de interface.O conjunto dePropertyName função especifica que a propriedade é gravável.

  • Tipo de implementação
    Somente dispinterfaces do 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 na o nome da propriedade.O padrão.Consulte Propriedades de ações para obter mais informações.

    Se você especificar Stock, em seguida, tipo de propriedade, tipo de parâmetro, e o nome do parâmetro estão esmaecidos.

    Variável de membro

    Especifica que a propriedade é adicionada como uma variável de membro.Você pode adicionar propriedades personalizadas ou a maioria das propriedades de ações como variáveis de membro.Não é possível especificar variável de membro para legenda, hWnd, e texto propriedades.

    Fornece nomes padrão em o nome da variável e a função de notificação.Você pode editar este nome.

    Métodos de Get/Set

    Especifica a propriedade é adicionada como GetPropertyName e definirPropertyName funções, por padrão.Esses nomes são exibidos sob obter a função e definir a função.

    Você pode alterar o padrão tipo de propriedade, que passa um valor para a função Get.Você pode especificar parâmetros para o obter e Set funções.

  • Obter a função
    Para interfaces ATL.Define a propriedade como legíveis; ou seja, ele cria o obter método para recuperar esta propriedade do objeto.Você deve selecionar obter, Put, ou ambos.

  • Coloque a função
    Somente interfaces ATL.Define a propriedade gravável; ou seja, ele cria o Put método para definir ou "colocar", essa propriedade do objeto.Você deve selecionar obter, Put, ou ambos.Se você selecionar essa opção, você pode escolher entre as duas formas de implementar o método a seguintes:

    Opção

    Descrição

    PropPut

    O 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

    O PropPutRef função retorna uma referência ao objeto, em vez de retornar a cópia do próprio objeto.Considere usar esta opção para objetos, como, por exemplo, grandes estruturas ou arrays, que podem ter a sobrecarga de inicialização.

  • Atributos de parâmetro
    Somente interfaces ATL.Define se o parâmetro especificado por o nome do parâmetro é na, 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 do procedimento chamado ao procedimento de chamada (a partir do servidor para o cliente).

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

  • Nome do parâmetro
    Define o nome de um parâmetro que você está adicionando para a propriedade, se a propriedade tiver parâmetros.Depois de clicar em Add, o nome do parâmetro aparece no lista de parâmetros.

  • Lista de parâmetros
    Exibe a lista de atributos a serem adicionados à propriedade.Cada item na lista consiste no nome do parâmetro, tipo de parâmetro e atributos.Use Add e Remover para atualizar a lista.

  • Add
    Adiciona o parâmetro especificado em o nome do parâmetro e tipo de parâmetro para o lista de parâmetros.Você deve clicar em Add para adicionar um parâmetro à lista.

  • Remove
    Remove o parâmetro que você seleciona na lista de parâmetros.

  • Propriedade padrão
    Somente dispinterface MFC.Define essa propriedade como o padrão para a interface.Uma interface pode ter a propriedade de apenas um padrão; Depois de especificar a propriedade padrão, de quaisquer outras propriedades que você adiciona à interface, esta caixa está disponível.

Consulte também

Tarefas

Adicionando uma propriedade (Visual C++)

Implementando uma interface (Visual C++)

Referência

Atributos IDL, Assistente para Adicionar Propriedade