Funzione OleUIPasteSpecialA (oledlg.h)

Articolo
11/20/2024

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

Sintassi

UINT OleUIPasteSpecialA(
  [in] LPOLEUIPASTESPECIALA unnamedParam1
);

Parametri

[in] unnamedParam1

Puntatore a una struttura OLEUIPASTESPECIAL .

Valore restituito

Definizioni di esito positivo/errore 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 è stato 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	Inizializzazione della finestra di dialogo non riuscita.
OLEUI_ERR_LOCALMEMALLOC	Chiamata a LocalAlloc o allocatore IMalloc standard .
OLEUI_ERR_GLOBALMEMALLOC	Chiamata a GlobalAlloc o allocatore IMalloc standard .
OLEUI_ERR_LOADSTRING	Impossibile chiamare LoadString per ottenere risorse localizzate dalla libreria.
OLEUI_ERR_OLEMEMALLOC	Una chiamata allocatore standard IMalloc 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 arrPasteEntries membro 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.

Osservazioni

La progettazione del finestra di dialogo Incolla speciale presuppone che se si è disposti a consentire a un utente di collegarsi a un oggetto, si è anche disposti a consentire all'utente di incorporare tale oggetto. Per questo motivo, se uno dei flag di OLEUIPASTE_LINKTYPE associati all'enumerazione OLEUIPASTEFLAG è impostato, è necessario impostare anche il flag OLEUIPASTE_PASTE affinché i formati di dati vengano visualizzati nella finestra di dialogo Incolla speciale.

Il testo visualizzato nel campo origine della finestra di dialogo standard Incolla speciale, implementata in Oledlg32.dll, è la stringa con terminazione Null il 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, nella finestra di dialogo viene visualizzato il testo associato a CF_LINKSOURCEDESCRIPTOR. Se nessuna delle due strutture è disponibile, la finestra di dialogo cerca CF_FILENAME. Se CF_FILENAME non viene trovato, nella finestra di dialogo viene visualizzata la stringa "Origine sconosciuta".

Per liberare un HMETAFILEPICT restituito dal Inserisci oggetto o finestra di dialogo Incolla speciale, eliminare il metafile associato 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	oledlg.h
libreria	OleDlg.lib
dll	OleDlg.dll

Vedere anche

OLEUIPASTEFLAG

Condividi tramite