Clase COleChangeSourceDialog
Se utiliza en el cuadro de diálogo Cambiar origen de OLE.
Sintaxis
class COleChangeSourceDialog : public COleDialog
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| COleChangeSourceDialog::COleChangeSourceDialog | Construye un objeto COleChangeSourceDialog. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| COleChangeSourceDialog::DoModal | Muestra el cuadro de diálogo Cambiar origen de OLE. |
| COleChangeSourceDialog::GetDisplayName | Obtiene el nombre completo de origen para mostrar. |
| COleChangeSourceDialog::GetFileName | Obtiene el nombre de archivo del nombre de origen. |
| COleChangeSourceDialog::GetFromPrefix | Obtiene el prefijo del origen anterior. |
| COleChangeSourceDialog::GetItemName | Obtiene el nombre del elemento del nombre de origen. |
| COleChangeSourceDialog::GetToPrefix | Obtiene el prefijo del origen nuevo |
| COleChangeSourceDialog::IsValidSource | Indica si el origen es válido. |
Miembros de datos públicos
| Nombre | Descripción |
|---|---|
| COleChangeSourceDialog::m_cs | Estructura que controla el comportamiento del cuadro de diálogo. |
Comentarios
Cree un objeto de clase COleChangeSourceDialog cuando quiera llamar a este cuadro de diálogo. Una vez construido un objeto COleChangeSourceDialog, puede usar la estructura m_cs para inicializar los valores o estados de los controles en el cuadro de diálogo. La estructura m_cs 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 OLEUICHANGESOURCE 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
COleChangeSourceDialog
Requisitos
Encabezado: afxodlgs.h
COleChangeSourceDialog::COleChangeSourceDialog
Esta función construye un objeto COleChangeSourceDialog.
explicit COleChangeSourceDialog(
COleClientItem* pItem,
CWnd* pParentWnd = NULL);
Parámetros
pItem
El puntero al COleClientItem vinculado cuyo origen se va a actualizar.
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 obtener más información, consulte la estructura OLEUICHANGESOURCE y la función OleUIChangeSource en Windows SDK.
COleChangeSourceDialog::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 siguientes valores:
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 más información sobre el tipo de error que se produjo. Para una lista de posibles errores, consulte la función OleUIChangeSource en Windows SDK.
Comentarios
Si quiere inicializar los distintos controles de cuadro de diálogo estableciendo miembros de la estructura m_cs, debe hacerlo antes de llamar a DoModal, pero después de construir el objeto de diálogo.
Si DoModal devuelve IDOK, puede llamar a funciones miembro para recuperar los valores especificados por el usuario o la información del cuadro de diálogo. En la lista siguiente se enumeran las funciones de consulta típicas:
COleChangeSourceDialog::GetDisplayName
Llame a esta función para recuperar el nombre para mostrar completo del elemento de cliente vinculado.
CString GetDisplayName();
Valor devuelto
El nombre completo de origen para mostrar (moniker) para el COleClientItem especificado en el constructor.
COleChangeSourceDialog::GetFileName
Llame a esta función para recuperar la parte del moniker de archivo del nombre para mostrar del elemento de cliente vinculado.
CString GetFileName();
Valor devuelto
La parte del moniker de archivo del nombre de origen para mostrar para el COleClientItem especificado en el constructor.
Comentarios
El moniker de archivo junto con el moniker del elemento proporciona el nombre para mostrar completo.
COleChangeSourceDialog::GetFromPrefix
Llame a esta función para obtener la cadena de prefijo anterior para el origen.
CString GetFromPrefix();
Valor devuelto
La cadena de prefijo anterior del origen.
Comentarios
Llame a esta función solo después de que DoModal devuelva IDOK.
Este valor procede directamente del miembro lpszFrom de la estructura OLEUICHANGESOURCE.
Para más información, consulte la estructura OLEUICHANGESOURCE en Windows SDK.
COleChangeSourceDialog::GetItemName
Llame a esta función para recuperar la parte del moniker de elemento del nombre para mostrar del elemento de cliente vinculado.
CString GetItemName();
Valor devuelto
La parte del moniker de elemento del nombre de origen para mostrar para el COleClientItem especificado en el constructor.
Comentarios
El moniker de archivo junto con el moniker del elemento proporciona el nombre para mostrar completo.
COleChangeSourceDialog::GetToPrefix
Llame a esta función para obtener la nueva cadena de prefijo para el origen.
CString GetToPrefix();
Valor devuelto
La nueva cadena de prefijo del origen.
Comentarios
Llame a esta función solo después de que DoModal devuelva IDOK.
Este valor procede directamente del miembro lpszTo de la estructura OLEUICHANGESOURCE.
Para más información, consulte la estructura OLEUICHANGESOURCE en Windows SDK.
COleChangeSourceDialog::m_cs
Este miembro de datos es una estructura de tipo OLEUICHANGESOURCE.
OLEUICHANGESOURCE m_cs;
Comentarios
OLEUICHANGESOURCE se usa para controlar el comportamiento del cuadro de diálogo Cambiar origen de OLE. Los miembros de esta estructura se pueden modificar directamente.
Para más información, consulte la estructura OLEUICHANGESOURCE en Windows SDK.
COleChangeSourceDialog::IsValidSource
Llame a esta función para determinar si el nuevo origen es válido.
BOOL IsValidSource();
Valor devuelto
Distinto de cero si el nuevo origen es válido; de lo contrario, 0.
Comentarios
Llame a esta función solo después de que DoModal devuelva IDOK.
Para más información, consulte la estructura OLEUICHANGESOURCE en Windows SDK.