Método ISelectionContainer.SelectObjects (UInt32, Object , UInt32)

Artigo
08/03/2016

Publicado: abril de 2016

Retorna um ou mais objetos selecionados a partir de um grupo de objetos.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

int SelectObjects(
    uint cSelect,
    object[] apUnkSelect,
    uint dwFlags
)

int SelectObjects(
    unsigned int cSelect,
    array<Object^>^ apUnkSelect,
    unsigned int dwFlags
)

abstract SelectObjects : 
        cSelect:uint32 *
        apUnkSelect:Object[] *
        dwFlags:uint32 -> int

Function SelectObjects (
    cSelect As UInteger,
    apUnkSelect As Object(),
    dwFlags As UInteger
) As Integer

Parâmetros

cSelect
[in] Especifica o número de itens selecionados — o número de elementos na matriz de objetos retornados por GetObjects e salvo em apUnkSelect.

apUnkSelect
[in][out] Ponteiro para a matriz de objetos retornados por meio de GetObjects.

dwFlags
[in] Sinalizadores que modificar a seleção.Se definido como SELOBJS_ACTIVATEWINDOW, o chamador está solicitando que a janela mostrando os objetos selecionados deve ser ativada.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De designer.idl:

HRESULT ISelectionContainer::SelectObjects(
   [in] ULONG cSelect,
   [in, size_is(cSelect)] IUnknown ** apUnkSelect,
   [in] DWORD dwFlags
);

Esse método torna possível a qualquer um dos objetos selecionáveis retornados por GetObjects a ser selecionado.Antes de retornar, SelectObjects salva uma cópia local do seu ISelectionContainer ponteiro chamando ISelectionContainer.AddRef e, em seguida, emissão de relatórios a seleção alterada para o ambiente com uma chamada para OnSelectChange.

Como o suportam de objetos retornados IDispatch, o chamador pode obter informações, como seu nome, chamando um IDispatch.Invoke com um identificador de despacho predefinidos (DISPID) que representa as informações desejadas.Os DISPIDs declarados são negativos para garantir que eles não entrem em conflito com os identificadores definidos pelo usuário.

A tabela a seguir descreve algumas dessas informações e onde partir e como ele é obtido.Esses DISPIDs são definidos no arquivo de cabeçalho Typelib2.h.

Informações	Obtido
Nome do objeto	IDispatch.Invokeusando o identificador de despacho DISPID_NAME
Índice do objeto	IDispatch.Invokeusando o identificador de despacho DISPID_OBJECT
Tipo de objeto	IProvideClassInfo.QueryInterface

Consulte também

Interface ISelectionContainer
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via