IVsUserContextUpdate.UpdateUserContext(IVsUserContext, UInt32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Envia a notificação de que o contexto está sendo atualizado. Esse método também limpa o sinalizador sujo do recipiente de contexto.
public:
int UpdateUserContext(Microsoft::VisualStudio::Shell::Interop::IVsUserContext ^ pCtx, System::UInt32 dwCookie);
public:
int UpdateUserContext(Microsoft::VisualStudio::Shell::Interop::IVsUserContext ^ pCtx, unsigned int dwCookie);
int UpdateUserContext(Microsoft::VisualStudio::Shell::Interop::IVsUserContext const & pCtx, unsigned int dwCookie);
public int UpdateUserContext (Microsoft.VisualStudio.Shell.Interop.IVsUserContext pCtx, uint dwCookie);
abstract member UpdateUserContext : Microsoft.VisualStudio.Shell.Interop.IVsUserContext * uint32 -> int
Public Function UpdateUserContext (pCtx As IVsUserContext, dwCookie As UInteger) As Integer
Parâmetros
- pCtx
- IVsUserContext
no Ponteiro para a IVsUserContextUpdate interface (o recipiente de contexto) a ser atualizado.
- dwCookie
- UInt32
no O parâmetro não é usado no momento.
Retornos
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Comentários
Assinatura COM
De Context. idl:
HRESULT IVsUserContextUpdate::UpdateUserContext(
[in] IVsUserContext * pCtx,
[in] VSCOOKIE dwCookie
);
Quando você cria um recipiente de contexto para um editor ou designer, chame AdviseUpdate e passe um ponteiro para seu provedor de contexto. Quando Update é chamado internamente pelo ambiente, cada recipiente de contexto na seleção ativa é atualizado. Para cada recipiente de contexto chamado AdviseUpdate e implementado IVsUserContextUpdate , o ambiente chama UpdateUserContext para informar ao provedor de contexto que o recipiente de contexto será atualizado. Você pode usar essa chamada para alterar os atributos e palavras-chave no recipiente de contexto antes que ocorra a atualização.
Se necessário, um provedor de contexto pode fornecer uma notificação de que o contexto precisa ser atualizado chamando SetDirty no recipiente de contexto. Usando essa abordagem, você não precisa fornecer o contexto até que Update tenha sido chamado.
Observação
O sinalizador SetDirty é definido automaticamente para true sempre que o contexto é adicionado ou removido do recipiente de contexto.