Classe COleChangeIconDialog

  • Artigo

Usado para a caixa de diálogo Ícone de Alteração OLE.

Sintaxe

class COleChangeIconDialog : public COleDialog

Membros

Construtores públicos

Nome Descrição
COleChangeIconDialog::COleChangeIconDialog Constrói um objeto COleChangeIconDialog.

Métodos públicos

Nome Descrição
COleChangeIconDialog::DoChangeIcon Executa a alteração especificada na caixa de diálogo.
COleChangeIconDialog::DoModal Exibe a caixa de diálogo Ícone de Alteração OLE 2.
COleChangeIconDialog::GetIconicMetafile Obtém um identificador para o metarquivo associado à forma icônica deste item.

Membros de Dados Públicos

Nome Descrição
COleChangeIconDialog::m_ci Uma estrutura que controla o comportamento da caixa de diálogo.

Comentários

Crie um objeto da classe COleChangeIconDialog quando quiser chamar essa caixa de diálogo. Depois que um objeto COleChangeIconDialog for construído, você poderá usar a estrutura m_ci para inicializar os valores ou estados dos controles na caixa de diálogo. A estrutura m_ci é do tipo OLEUICHANGEICON. Para mais informações sobre como usar essa classe de diálogo, confira a função membro DoModal.

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

Para mais informações sobre caixas de diálogo específicas do OLE, confira o artigo Caixas de diálogo no OLE.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleChangeIconDialog

Requisitos

Cabeçalho: afxodlgs.h

COleChangeIconDialog::COleChangeIconDialog

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

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

Parâmetros

pItem
Aponta para o item a ser convertido.

dwFlags
O sinalizador de criação que contém qualquer número dos seguintes valores a serem combinados usando o operador bit a bit OR:

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

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

  • CIF_SELECTFROMFILE Especifica que o botão de opção Do arquivo 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 campo szIconExe de m_ci em vez de recuperado do tipo. Isso é útil para inserir ou vincular a arquivos não OLE.

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

Comentários

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

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

COleChangeIconDialog::DoChangeIcon

Chame essa função para alterar o ícone que representa o item para aquele selecionado na caixa de diálogo depois que DoModal retornar IDOK.

BOOL DoChangeIcon(COleClientItem* pItem);

Parâmetros

pItem
Aponta para o item cujo ícone está sendo alterado.

Valor de retorno

Diferente de zero se a alteração for bem-sucedida; caso contrário, 0.

COleChangeIconDialog::DoModal

Chame essa função para exibir a caixa de diálogo OLE Alterar ícone.

virtual INT_PTR DoModal();

Valor de retorno

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

  • IDOK se a caixa de diálogo foi exibida com êxito.

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

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

Comentários

Se você quiser inicializar os vários controles da caixa de diálogo definindo membros da estrutura m_ci, faça isso antes de chamar DoModal, mas depois que o objeto de caixa de diálogo for construído.

Se retornar DoModal, você poderá chamar outras funções membro para recuperar as configurações ou informações inseridas pelo usuário na caixa de diálogo.

COleChangeIconDialog::GetIconicMetafile

Chame essa função para obter um identificador para o metarquivo que contém o aspecto icônico do item selecionado.

HGLOBAL GetIconicMetafile() const;

Valor de retorno

O identificador do metarquivo que contém o aspecto icônico do novo ícone, se a caixa de diálogo foi descartada escolhendo OK; caso contrário, o ícone como era antes de a caixa de diálogo ser exibida.

COleChangeIconDialog::m_ci

Estrutura do tipo OLEUICHANGEICON usado para controlar o comportamento da caixa de diálogo Alterar ícone.

OLEUICHANGEICON m_ci;

Comentários

Os membros dessa estrutura podem ser modificados diretamente ou por meio de funções de membro.

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

Confira também

Classe COleDialog
Gráfico da hierarquia
Classe COleDialog