Classe COlePropertiesDialog

Incapsula la finestra di dialogo delle proprietà dell'oggetto OLE comune di Windows.

Sintassi

class COlePropertiesDialog : public COleDialog

Membri

Costruttori pubblici

Metodi pubblici

Membri dati pubblici

Osservazioni:

Le finestre di dialogo Proprietà oggetto OLE comuni offrono un modo semplice per visualizzare e modificare le proprietà di un elemento di documento OLE in modo coerente con gli standard di Windows. Queste proprietà includono, tra le altre, informazioni sul file rappresentato dall'elemento del documento, opzioni per la visualizzazione dell'icona e del ridimensionamento delle immagini e informazioni sul collegamento dell'elemento (se l'elemento è collegato).

Per usare un COlePropertiesDialog oggetto , creare prima di tutto l'oggetto usando il COlePropertiesDialog costruttore . Dopo aver costruito la finestra di dialogo, chiamare la DoModal funzione membro per visualizzare la finestra di dialogo e consentire all'utente di modificare le proprietà dell'elemento. DoModal restituisce un valore che indica se l'utente ha selezionato ok (IDOK) o il pulsante Annulla (IDCANCEL). Oltre ai pulsanti OK e Annulla, è presente un pulsante Applica. Quando l'utente seleziona Applica, tutte le modifiche apportate alle proprietà dell'elemento del documento vengono applicate all'elemento e l'immagine viene aggiornata automaticamente, ma rimane attiva.

Il membro dati m_psh è un puntatore a una PROPSHEETHEADER struttura e nella maggior parte dei casi non sarà necessario accedervi in modo esplicito. Un'eccezione è quando sono necessarie pagine di proprietà aggiuntive oltre le pagine predefinite Generale, Visualizzazione e Collegamento. In questo caso, è possibile modificare il m_psh membro dati in modo da includere le pagine personalizzate prima di chiamare la DoModal funzione membro.

Per altre informazioni sulle finestre di dialogo OLE, vedere l'articolo Finestre di dialogo in OLE.

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COlePropertiesDialog

Requisiti

Intestazione: afxodlgs.h

COlePropertiesDialog::COlePropertiesDialog

Crea un oggetto COlePropertiesDialog.

COlePropertiesDialog(
    COleClientItem* pItem,
    UINT nScaleMin = 10,
    UINT nScaleMax = 500,
    CWnd* pParentWnd = NULL);

Parametri

pItem
Puntatore all'elemento del documento a cui si accede alle proprietà.

nScaleMin
Percentuale di ridimensionamento minima per l'immagine dell'elemento del documento.

nScaleMax
Percentuale massima di ridimensionamento per l'immagine dell'elemento del documento.

pParentWnd
Puntatore all'elemento padre o proprietario della finestra di dialogo.

Osservazioni:

Derivare la classe di dialogo proprietà oggetto OLE comune da COlePropertiesDialog per implementare il ridimensionamento per gli elementi del documento. Le finestre di dialogo implementate da un'istanza di questa classe non supporteranno il ridimensionamento dell'elemento del documento.

Per impostazione predefinita, nella finestra di dialogo Proprietà oggetto OLE comuni sono presenti tre pagine predefinite:

• Generali

  Questa pagina contiene informazioni di sistema per il file rappresentato dall'elemento del documento selezionato. Da questa pagina, l'utente può convertire l'elemento selezionato in un altro tipo.

• Visualizza

  Questa pagina contiene opzioni per la visualizzazione dell'elemento, la modifica dell'icona e la modifica del ridimensionamento dell'immagine.

• Collega

  Questa pagina contiene opzioni per modificare il percorso dell'elemento collegato e aggiornare l'elemento collegato. Da questa pagina, l'utente può interrompere il collegamento dell'elemento selezionato.

Per aggiungere pagine successive a quelle fornite per impostazione predefinita, modificare la variabile membro m_psh prima di uscire dal costruttore della COlePropertiesDialogclasse derivata da . Si tratta di un'implementazione avanzata del COlePropertiesDialog costruttore.

COlePropertiesDialog::D oModal

Chiamare questa funzione membro per visualizzare la finestra di dialogo Proprietà oggetto OLE comuni di Windows e consentire all'utente di visualizzare e/o modificare le varie proprietà dell'elemento del documento.

virtual INT_PTR DoModal();

Valore restituito

IDOK o IDCANCEL se ha esito positivo; in caso contrario, 0. IDOK e IDCANCEL sono costanti che indicano se l'utente ha selezionato il pulsante OK o Annulla.

Se viene restituito IDCANCEL, è possibile chiamare la funzione Windows CommDlgExtendedError per determinare se si è verificato un errore.

COlePropertiesDialog::m_gp

Struttura di tipo OLEUIGNRLPROPS, utilizzata per inizializzare la pagina Generale della finestra di dialogo Proprietà oggetto OLE.

OLEUIGNRLPROPS m_gp;

Osservazioni:

Questa pagina mostra il tipo e le dimensioni di un incorporamento e consente all'utente di accedere alla finestra di dialogo Converti. Questa pagina mostra anche la destinazione del collegamento se l'oggetto è un collegamento.

Per altre informazioni sulla OLEUIGNRLPROPS struttura, vedere Windows SDK.

COlePropertiesDialog::m_lp

Struttura di tipo OLEUILINKPROPS, utilizzata per inizializzare la pagina Collegamento della finestra di dialogo Proprietà oggetto OLE.

OLEUILINKPROPS m_lp;

Osservazioni:

Questa pagina mostra la posizione dell'elemento collegato e consente all'utente di aggiornare o interrompere il collegamento all'elemento.

Per altre informazioni sulla OLEUILINKPROPS struttura, vedere Windows SDK.

COlePropertiesDialog::m_op

Struttura di tipo OLEUIOBJECTPROPS, utilizzata per inizializzare la finestra di dialogo Proprietà oggetto OLE comuni.

OLEUIOBJECTPROPS m_op;

Osservazioni:

Questa struttura contiene membri utilizzati per inizializzare le pagine Generale, Collegamento e Visualizza.

Per altre informazioni, vedere le strutture OLEUIOBJECTPROPS e OLEUILINKPROPS in Windows SDK.

COlePropertiesDialog::m_psh

Struttura di tipo PROPSHEETHEADER, i cui membri archiviano le caratteristiche dell'oggetto dialogo.

PROPSHEETHEADER m_psh;

Osservazioni:

Dopo aver costruito un COlePropertiesDialog oggetto, è possibile usare m_psh per impostare vari aspetti della finestra di dialogo prima di chiamare la DoModal funzione membro.

Se si modifica direttamente il m_psh membro dati, si eseguirà l'override di qualsiasi comportamento predefinito.

Per altre informazioni sulla PROPSHEETHEADER struttura, vedere Windows SDK.

COlePropertiesDialog::m_vp

Struttura di tipo OLEUIVIEWPROPS, utilizzata per inizializzare la pagina Visualizza della finestra di dialogo Proprietà oggetto OLE.

OLEUIVIEWPROPS m_vp;

Osservazioni:

Questa pagina consente all'utente di alternare le visualizzazioni "contenuto" e "iconico" dell'oggetto e modificarne il ridimensionamento all'interno del contenitore. Consente inoltre all'utente di accedere alla finestra di dialogo Cambia icona quando l'oggetto viene visualizzato come icona.

Per altre informazioni sulla OLEUIVIEWPROPS struttura, vedere Windows SDK.

COlePropertiesDialog::OnApplyScale

Chiamato dal framework quando il valore di ridimensionamento è stato modificato e ok o Apply è stato selezionato.

virtual BOOL OnApplyScale(
    COleClientItem* pItem,
    int nCurrentScale,
    BOOL bRelativeToOrig);

Parametri

pItem
Puntatore all'elemento del documento a cui si accede alle proprietà.

nCurrentScale
Valore numerico della scala del dialogo.

bRelativeToOrig
Indica se il ridimensionamento si applica alle dimensioni originali dell'elemento del documento.

Valore restituito

Diverso da zero se gestito; in caso contrario, 0.

Osservazioni:

L'implementazione predefinita non esegue alcuna operazione. È necessario eseguire l'override di questa funzione per abilitare i controlli di ridimensionamento.

Vedi anche

Esempio MFC CIRC
Classe COleDialog
Grafico della gerarchia
Classe COleDialog
Classe CPropertyPage