Funzione OleUIPasteSpecialW (oledlg.h)

Articolo
03/01/2024

Richiama la finestra di dialogo Incolla speciale standard, consentendo all'utente di selezionare il formato dell'oggetto Appunti da incollare o incollare.

Sintassi

UINT OleUIPasteSpecialW(
  [in] LPOLEUIPASTESPECIALW unnamedParam1
);

Parametri

[in] unnamedParam1

Puntatore a una struttura OLEUIPASTESPECIAL .

Valore restituito

Definizioni di errori/esito positivo standard

Codice restituito	Descrizione
OLEUI_FALSE	Errore sconosciuto (inutilizzato).
OLEUI_OK	L'utente ha premuto il pulsante OK.
OLEUI_SUCCESS	Nessun errore, uguale a OLEUI_OK.
OLEUI_CANCEL	L'utente ha premuto il pulsante Annulla.

Errori di convalida dei campi standard

Codice restituito	Descrizione
OLEUI_ERR_STANDARDMIN	Gli errori comuni a tutte le finestre di dialogo si trovano nell'intervallo OLEUI_ERR_STANDARDMIN da OLEUI_ERR_STANDARDMAX. Questo valore consente all'applicazione di testare i messaggi standard per visualizzare i messaggi di errore all'utente.
OLEUI_ERR_STRUCTURENULL	Il puntatore a una struttura OLEUIXXX passata alla funzione era NULL.
OLEUI_ERR_STRUCTUREINVALID	Autorizzazioni insufficienti per l'accesso in lettura o scrittura a una struttura OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT	Il valore cbstruct non è corretto.
OLEUI_ERR_HWNDOWNERINVALID	Il valore hWndOwner non è valido.
OLEUI_ERR_LPSZCAPTIONINVALID	Il valore lpszCaption non è valido.
OLEUI_ERR_LPFNHOOKINVALID	Il valore lpfnHook non è valido.
OLEUI_ERR_HINSTANCEINVALID	Il valore hInstance non è valido.
OLEUI_ERR_LPSZTEMPLATEINVALID	Il valore lpszTemplate non è valido.
OLEUI_ERR_HRESOURCEINVALID	Il valore hResource non è valido.

Errori di inizializzazione

Codice restituito	Descrizione
OLEUI_ERR_FINDTEMPLATEFAILURE	Impossibile trovare il modello della finestra di dialogo.
OLEUI_ERR_LOADTEMPLATEFAILURE	Impossibile caricare il modello della finestra di dialogo.
OLEUI_ERR_DIALOGFAILURE	Impossibile inizializzare la finestra di dialogo.
OLEUI_ERR_LOCALMEMALLOC	Una chiamata a LocalAlloc o all'allocatore IMalloc standard non è riuscita.
OLEUI_ERR_GLOBALMEMALLOC	Una chiamata a GlobalAlloc o all'allocatore IMalloc standard non è riuscita.
OLEUI_ERR_LOADSTRING	Impossibile chiamare LoadString per ottenere risorse localizzate dalla libreria.
OLEUI_ERR_OLEMEMALLOC	Una chiamata all'allocatore IMalloc standard non è riuscita.

Errori specifici della funzione

Codice restituito	Descrizione
OLEUI_ERR_STANDARDMAX	Gli errori comuni a tutte le finestre di dialogo si trovano nell'intervallo OLEUI_ERR_STANDARDMIN da OLEUI_ERR_STANDARDMAX. Questo valore consente all'applicazione di testare i messaggi standard per visualizzare i messaggi di errore all'utente.
OLEUI_IOERR_SRCDATAOBJECTINVALID	Il membro lpSrcDataObject di OLEUIPASTESPECIAL non è valido.
OLEUI_IOERR_ARRPASTEENTRIESINVALID	Il membro arrPasteEntries di OLEUIPASTESPECIAL non è valido.
OLEUI_IOERR_ARRLINKTYPESINVALID	Il membro arrLinkTypes di OLEUIPASTESPECIAL non è valido.
OLEUI_PSERR_CLIPBOARDCHANGED	Il contenuto degli Appunti è stato modificato durante la visualizzazione della finestra di dialogo.
OLEUI_PSERR_GETCLIPBOAARDFAILED	Il membro lpSrcDataObj non è corretto.

Commenti

La progettazione della finestra di dialogo Incolla speciale presuppone che se si è disposti a consentire a un utente di collegare un oggetto, è anche possibile consentire all'utente di incorporare tale oggetto. Per questo motivo, se uno dei flag di OLEUIPASTE_LINKTYPE associati all'enumerazione OLEUIPASTEFLAG è impostato, il flag di OLEUIPASTE_PASTE deve essere impostato anche per consentire la visualizzazione dei formati di dati nella finestra di dialogo Incolla speciale .

Il testo visualizzato nel campo Origine della finestra di dialogo Incolla speciale standard, implementata in Oledlg32.dll, è la stringa con terminazione null la cui offset in byte viene specificato nel membro dwSrcofCopy della struttura OBJECTDESCRIPTOR per l'oggetto da incollare. Se una struttura OBJECTDESCRIPTOR non è disponibile per questo oggetto, la finestra di dialogo visualizza qualsiasi testo può essere associato a CF_LINKSOURCEDESCRIPTOR. Se nessuna struttura è disponibile, la finestra di dialogo cerca CF_FILENAME. Se CF_FILENAME non viene trovato, la finestra di dialogo visualizza la stringa "Origine sconosciuta".

Per liberare un oggetto HMETAFILEPICT restituito dalla finestra di dialogo Inserisci oggetto o Incolla speciale , eliminare il metafile collegato nell'handle, come indicato di seguito.

void FreeHmetafilepict(HMETAFILEPICT hmfp)
{
    if (hmfp != NULL)
    {
        LPMETAFILEPICT pmfp = GlobalLock(hmfp);
 
        DeleteMetaFile(pmfp->hMF);
        GlobalUnlock(hmfp);
        GlobalFree(hmfp);
    }
    else
    {
        // Handle null pointers here.
        exit(0);
    }
}

Nota

L'intestazione oledlg.h definisce OLEUIPASTESPECIAL come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oledlg.h
Libreria	OleDlg.lib
DLL	OleDlg.dll

Vedi anche

OLEUIPASTEFLAG

Condividi tramite