Metodo IPrintOemUI2::HideStandardUI (prcomoem.h)
Il metodo IPrintOemUI2::HideStandardUI consente a un plug-in dell'interfaccia utente di specificare se le finestre delle proprietà standard devono essere visualizzate o nascoste. A partire da Microsoft Windows XP, questo metodo può essere implementato da un plug-in dell'interfaccia utente Pscript5. A partire da Windows Vista, questo metodo può essere implementato da un plug-in dell'interfaccia utente Unidrv.
Sintassi
HRESULT HideStandardUI(
DWORD dwMode
);
Parametri
dwMode
Specifica il tipo di interfaccia utente della finestra delle proprietà, ovvero la finestra delle proprietà del documento o la finestra delle proprietà del dispositivo, da nascondere. Questo parametro deve essere impostato su una delle costanti seguenti, definite in printoem.h:
| Valore | Significato |
|---|---|
| OEMCUIP_DOCPROP | Nascondere l'interfaccia utente della finestra delle proprietà del documento standard. |
| OEMCUIP_PRNPROP | Nascondere l'interfaccia utente della finestra delle proprietà del dispositivo standard. |
Valore restituito
In caso di esito positivo, questo metodo deve restituire S_OK. In caso contrario, deve restituire E_NOTIMPL. Per altre informazioni, vedere La sezione Osservazioni.
Osservazioni
Questo metodo è supportato in Windows Vista per i plug-in Pscript 5 e Unidrv e in Windows XP solo per i plug-in Pscript5.
All'interno del DrvDocumentPropertySheets o DrvDevicePropertySheets DDIs quando pPSUIInfo-->Reason è impostato su PROPSHEETUI_REASON_INIT, il driver chiama il metodo IPrintOemUI2::HideStandardUI per chiedere al plug-in dell'interfaccia utente le richieste dell'interfaccia utente. Questo metodo può rispondere in uno dei quattro modi seguenti:
- Nascondere l'interfaccia utente della finestra delle proprietà del documento standard.
- Nascondere l'interfaccia utente della finestra delle proprietà del dispositivo standard.
- Nascondi tutta l'interfaccia utente della finestra delle proprietà standard.
- Non nascondere alcuna interfaccia utente della finestra delle proprietà standard.
IPrintOemUI2::HideStandardUI risponde in ognuna di queste situazioni.
| Per indicare questa risposta... | IPrintOemUI2::HideStandardUI restituisce... |
|---|---|
| Nascondere l'interfaccia utente della finestra delle proprietà del documento standard. Il plug-in implementa la propria interfaccia utente della finestra delle proprietà del documento. | Se dwMode == OEMCUIP_DOCPROP, restituire S_OK; in caso contrario, restituire E_NOTIMPL. |
| Nascondere l'interfaccia utente della finestra delle proprietà del dispositivo standard. Il plug-in implementa la propria interfaccia utente della finestra delle proprietà del dispositivo. | Se dwMode == OEMCUIP_PRNPROP, restituire S_OK; in caso contrario, restituire E_NOTIMPL. |
| Nascondi tutta l'interfaccia utente della finestra delle proprietà standard. Il plug-in implementa la propria finestra delle proprietà del documento e l'interfaccia utente della finestra delle proprietà del dispositivo. | Restituisce S_OK, indipendentemente dal valore di dwMode. |
| Visualizza tutta l'interfaccia utente della finestra delle proprietà standard. | Restituisce E_NOTIMPL, indipendentemente dal valore di dwMode. |
Se il metodo IPrintOemUI2::HideStandardUI indica al driver che tutte le finestre delle proprietà standard devono essere nascoste, il driver omette le chiamate a compstui.dll (vedere Pscript Components) per aggiungere le finestre delle proprietà standard. Un plug-in dell'interfaccia utente deve implementare almeno un'interfaccia utente della finestra delle proprietà personalizzata se IPrintOemUI2::HideStandardUI restituisce S_OK.
Quando la stampante dispone di più plug-in dell'interfaccia utente installati, il driver chiama i plug-in dell'interfaccia utente nell'ordine in cui sono stati installati, fino a quando uno di essi non restituisce S_OK o fino a quando non vengono chiamati tutti i plug-in dell'interfaccia utente e nessuno di essi restituito S_OK. Il caso precedente indica al driver che l'interfaccia utente della finestra delle proprietà standard deve essere nascosta. Il secondo caso indica al driver che deve essere visualizzata l'interfaccia utente della finestra delle proprietà standard.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | prcomoem.h (include Prcomoem.h) |