Classe COleChangeIconDialog

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

Sintaxe

class COleChangeIconDialog : public COleDialog

Membros

Construtores públicos

Métodos públicos

Membros de Dados Públicos

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