Partilhar via

Classe COleChangeIconDialog

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Usado para a caixa de diálogo OLE Change Icon.

Sintaxe

class COleChangeIconDialog : public COleDialog

Membros

Construtores Públicos

Nome Description
ColeChangeIconDialog::COleChangeIconDialog Constrói um COleChangeIconDialog objeto.

Métodos Públicos

Nome Description
Diálogo COleChangeIcon::D oChangeIcon Realiza a alteração especificada na caixa de diálogo.
COleChangeIconDialog::D oModal Mostra a caixa de diálogo Ícone de Mudança OLE 2.
ColeChangeIconDialog::GetIconicMetafile Percebe o metaficheiro associado à forma icónica deste item.

Membros de Dados Públicos

Nome Description
ColeChangeIconDialog::m_ci Uma estrutura que controla o comportamento da caixa de diálogo.

Observações

Cria um objeto de classe COleChangeIconDialog quando quiseres chamar esta caixa de diálogo. Depois de um COleChangeIconDialog objeto ter sido construído, pode usar a estrutura m_ci para inicializar os valores ou estados dos controlos na caixa de diálogo. A m_ci estrutura é do tipo OLEUICHANGEICON. Para mais informações sobre a utilização desta classe de diálogo, consulte a função membro DoModal .

Para mais informações, consulte a estrutura OLEUICHANGEICON no SDK do Windows.

Para mais informações sobre caixas de diálogo específicas de OLE, consulte o artigo Caixas de Diálogo em OLE.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleChangeIconDialog

Requerimentos

Cabeçalho: afxodlgs.h

ColeChangeIconDialog::COleChangeIconDialog

Esta função constrói apenas um COleChangeIconDialog objeto.

explicit COleChangeIconDialog(
    COleClientItem* pItem,
    DWORD dwFlags = CIF_SELECTCURRENT,
    CWnd* pParentWnd = NULL);

Parâmetros

pItem
Aponta para o item a converter.

dwBandeiras
Flag de criação, que contém qualquer número dos seguintes valores combinados usando o operador bitwise-or:

  • CIF_SELECTCURRENT Especifica que o botão de opção Corrente será selecionado inicialmente quando a caixa de diálogo for chamada. Este é o padrão.

  • CIF_SELECTDEFAULT Especifica que o botão de opção Default será selecionado inicialmente quando a caixa de diálogo for chamada.

  • CIF_SELECTFROMFILE Especifica que o botão de opção Do ficheiro será selecionado inicialmente quando a caixa de diálogo for chamada.

  • CIF_SHOWHELP Especifica que o botão Ajuda será exibido quando a caixa de diálogo for chamada.

  • CIF_USEICONEXE Especifica que o ícone deve ser extraído do executável especificado no szIconExe campo de m_ci em vez de ser recuperado do tipo. Isto é útil para incorporar ou ligar ficheiros que não sejam OLE.

pParentWnd
Aponta para o objeto janela pai ou proprietário (do tipo CWnd) ao qual pertence o objeto de diálogo. Se for NULL, a janela principal da caixa de diálogo será definida como a janela principal da aplicação.

Observações

Para mostrar a caixa de diálogo, chame a função DoModal .

Para mais informações, consulte a estrutura OLEUICHANGEICON no SDK do Windows.

Diálogo COleChangeIcon::D oChangeIcon

Chame esta função para alterar o ícone que representa o item para o selecionado na caixa de diálogo após o DoModal devolver IDOK.

BOOL DoChangeIcon(COleClientItem* pItem);

Parâmetros

pItem
Aponta para o item cujo ícone está a mudar.

Valor de retorno

Não nulo se a mudança for bem-sucedida; caso contrário, 0.

COleChangeIconDialog::D oModal

Chame esta função para mostrar a caixa de diálogo OLE Change Icon.

virtual INT_PTR DoModal();

Valor de retorno

Estado de conclusão da caixa de diálogo. Um dos seguintes valores:

  • Não sei se a caixa de diálogo foi exibida com sucesso.

  • IDCANCEL se o utilizador cancelou a caixa de diálogo.

  • IDABORT se ocorresse um erro. Se o IDABORT for devolvido, chame a COleDialog::GetLastError função membro para obter mais informações sobre o tipo de erro que ocorreu. Para uma lista de possíveis erros, consulte a função OleUIChangeIcon no SDK do Windows.

Observações

Se quiseres inicializar os vários controlos das caixas de diálogo definindo membros da estrutura m_ci , deves fazer isto antes de chamar DoModal, mas depois de o objeto de diálogo estar construído.

Se DoModal devolver IDOK, pode chamar outras funções membros para recuperar as definições ou informações introduzidas pelo utilizador na caixa de diálogo.

ColeChangeIconDialog::GetIconicMetafile

Chame esta função para obter um endereço para o metaficheiro que contém o aspeto icónico do item selecionado.

HGLOBAL GetIconicMetafile() const;

Valor de retorno

O handle do metaficheiro contendo o aspeto icónico do novo ícone, se a caixa de diálogo fosse ignorada ao escolher OK; caso contrário, o ícone como estava antes do diálogo ser exibido.

ColeChangeIconDialog::m_ci

Estrutura do tipo OLEUICHANGEICON usada para controlar o comportamento da caixa de diálogo Change Icon.

OLEUICHANGEICON m_ci;

Observações

Os membros desta estrutura podem ser modificados diretamente ou através de funções membros.

Para mais informações, consulte a estrutura OLEUICHANGEICON no SDK do Windows.

Consulte também

Classe COleDialog
Gráfico de Hierarquia
Classe COleDialog

  • Last updated on