Assistente de propriedade para adicionar nomes,

Use este assistente para adicionar uma propriedade para uma interface.

  • Property type
    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, o tipo de propriedade é definido como o tipo de ações e não está disponível para a alteração.

  • Nome de 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

    Description

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

  • Nome da variável
    Somente dispinterfaces do MFC. Disponível somente se você especificar a 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 esse nome.

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

  • Obtenha a função
    Para dispinterfaces do MFC. Disponível somente se você especificar os 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 esse 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 os 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 conjuntoPropertyName. Você pode editar esse 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

    Description

    Estoque

    Especifica uma implementação de estoque para a propriedade selecionada na nome da propriedade. O padrão. Consulte Propriedades de ações para obter mais informações.

    Se você especificar Stock, em seguida, o tipo de propriedade, o tipo de parâmetro, e 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 a variável de membro para legenda, hWnd, e texto propriedades.

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

    Métodos de Get/Set

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

    Você pode alterar o padrão 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.

  • Obtenha 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 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 a seguir para implementar o método:

    Option

    Description

    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 essa opção para objetos, como, por exemplo, grandes estruturas ou arrays, o que podem ter a sobrecarga de inicialização.

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

    Option

    Description

    in

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

    out

    Indica que o parâmetro de ponteiro é retornado a partir 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 a propriedade, se a propriedade tem parâmetros. Depois de clicar em Add, o nome do parâmetro aparece na a lista de parâmetro.

  • 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 que você especificar na nome do parâmetro e o tipo de parâmetro para o a lista de parâmetro. Você deve clicar em Add para adicionar um parâmetro à lista.

  • Remove
    Remove o parâmetro que você selecionar na a lista de parâmetro.

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

Consulte também

Tarefas

Adicionar uma propriedade

Implementação de uma Interface

Referência

Assistente de propriedade para adicionar atributos IDL