Clase COleChangeIconDialog

Se utiliza en el cuadro de diálogo Cambiar icono de OLE.

Sintaxis

class COleChangeIconDialog : public COleDialog

Miembros

Constructores públicos

Nombre	Descripción
COleChangeIconDialog::COleChangeIconDialog	Construye un objeto COleChangeIconDialog.

Métodos públicos

Nombre	Descripción
COleChangeIconDialog::DoChangeIcon	Realiza el cambio especificado en el cuadro de diálogo.
COleChangeIconDialog::DoModal	Muestra el cuadro de diálogo Cambiar icono de OLE 2.
COleChangeIconDialog::GetIconicMetafile	Obtiene un identificador del metarchivo asociado a la forma de icono de este elemento.

Miembros de datos públicos

Nombre	Descripción
COleChangeIconDialog::m_ci	Estructura que controla el comportamiento del cuadro de diálogo.

Comentarios

Cree un objeto de clase COleChangeIconDialog cuando quiera llamar a este cuadro de diálogo. Una vez construido un objeto COleChangeIconDialog, puede usar la estructura m_ci para inicializar los valores o estados de los controles en el cuadro de diálogo. La estructura m_ci es de tipo OLEUICHANGESOURCE. Para más información sobre el uso de esta clase de diálogo, consulte la función miembro DoModal.

Para más información, consulte la estructura OLEUICHANGEICON en Windows SDK.

Para más información sobre los cuadros de diálogo específicos de OLE, consulte el artículo Cuadros de diálogo en OLE.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

Cdialog

CCommonDialog

COleDialog

COleChangeIconDialog

Requisitos

Encabezado: afxodlgs.h

COleChangeIconDialog::COleChangeIconDialog

Esta función solo construye un objeto COleChangeIconDialog.

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

Parámetros

pItem
Apunta al elemento que se convertirá.

dwFlags
La marca de creación, que contiene cualquier número de los valores siguientes combinados mediante el operador OR bit a bit:

• CIF_SELECTCURRENT Especifica que el botón de radio Actual se seleccionará inicialmente cuando se llame al cuadro de diálogo. Esta es la configuración predeterminada.

• CIF_SELECTDEFAULT Especifica que el botón de radio Predeterminado se seleccionará inicialmente cuando se llame al cuadro de diálogo.

• CIF_SELECTFROMFILE Especifica que el botón de radio Desde archivo se seleccionará inicialmente cuando se llame al cuadro de diálogo.

• CIF_SHOWHELP Especifica que se mostrará el botón Ayuda cuando se llame al cuadro de diálogo.

• CIF_USEICONEXE Especifica que el icono se debe extraer del archivo ejecutable especificado en el campo szIconExe de m_ci en lugar de recuperarse del tipo. Esto es útil para insertar archivos que no son de OLE o vincularlos.

pParentWnd
Apunta al objeto de ventana primaria o propietaria (de tipo CWnd) al que pertenece el objeto de cuadro de diálogo. Si es NULL, la ventana primaria del cuadro de diálogo se establecerá en la ventana de aplicación principal.

Comentarios

Para mostrar el cuadro de diálogo, llame a la función DoModal.

Para más información, consulte la estructura OLEUICHANGEICON en Windows SDK.

COleChangeIconDialog::DoChangeIcon

Llame a esta función para cambiar el icono que representa el elemento al seleccionado en el cuadro de diálogo después de que DoModal devuelva IDOK.

BOOL DoChangeIcon(COleClientItem* pItem);

Parámetros

pItem
Apunta al elemento cuyo icono está cambiando.

Valor devuelto

Distinto de cero si el cambio se realiza correctamente; de lo contrario, 0.

COleChangeIconDialog::DoModal

Llame a esta función para mostrar el cuadro de diálogo Cambiar origen de OLE.

virtual INT_PTR DoModal();

Valor devuelto

Estado de finalización del cuadro de diálogo. Uno de los valores siguientes:

• IDOK si el cuadro de diálogo se mostró correctamente.

• IDCANCEL si el usuario canceló el cuadro de diálogo.

• IDABORT si se produjo un error. Si se devuelve IDABORT, llame a la función miembro COleDialog::GetLastError para obtener más información sobre el tipo de error que se produjo. Para una lista de posibles errores, consulte la función OleUIChangeIcon en Windows SDK.

Comentarios

Si quiere inicializar los distintos controles de cuadro de diálogo estableciendo miembros de la estructura m_ci, debe hacerlo antes de llamar a DoModal, pero después de construir el objeto de cuadro de diálogo.

Si DoModal devuelve IDOK, puede llamar a otras funciones miembro para recuperar la configuración o la información que el usuario especificó en el cuadro de diálogo.

COleChangeIconDialog::GetIconicMetafile

Llame a esta función para obtener un manipulador del metarchivo que contiene el aspecto de icono del elemento seleccionado.

HGLOBAL GetIconicMetafile() const;

Valor devuelto

El manipulador del metarchivo que contiene el aspecto del nuevo icono, si el cuadro de diálogo se descartó eligiendo Aceptar; de lo contrario, el icono tal como estaba antes de que se mostrara el cuadro de diálogo.

COleChangeIconDialog::m_ci

Estructura de tipo OLEUICHANGEICON utilizada para controlar el comportamiento del cuadro de diálogo Cambiar icono.

OLEUICHANGEICON m_ci;

Comentarios

Los miembros de esta estructura se pueden modificar directamente o a través de funciones miembro.

Para más información, consulte la estructura OLEUICHANGEICON en Windows SDK.

Consulte también

COleDialog (clase)
Gráfico de jerarquías
COleDialog (clase)