Metodo IPrintOemUI2::HideStandardUI (prcomoem.h)
Il IPrintOemUI2::HideStandardUI metodo consente a un plug-in dell'interfaccia utente di specificare se i fogli delle proprietà standard devono essere visualizzati o nascosti. 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 del foglio delle proprietà , ovvero foglio delle proprietà del documento o foglio 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 scheda delle proprietà del documento standard. |
| OEMCUIP_PRNPROP | Nascondere l'interfaccia utente della scheda 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 Osservazioni.
Commenti
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 di DrvDocumentPropertySheets o DrvDevicePropertySheets DDIs quando pPSUIInfo-->Reason è impostato su PROPSHEETUI_REASON_INIT, il driver chiama il metodo per chiedere al IPrintOemUI2::HideStandardUI plug-in dell'interfaccia utente le richieste di interfaccia utente. Questo metodo può rispondere in uno dei quattro modi seguenti:
- Nascondere l'interfaccia utente della scheda delle proprietà del documento standard.
- Nascondere l'interfaccia utente della scheda delle proprietà del dispositivo standard.
- Nascondere l'interfaccia utente del foglio delle proprietà standard.
- Non nascondere alcuna interfaccia utente del foglio delle proprietà standard.
IPrintOemUI2::HideStandardUI metodo risponderà in ognuna di queste situazioni.
| Per indicare questa risposta... | IPrintOemUI2::HideStandardUI restituisce... |
|---|---|
| Nascondere l'interfaccia utente della scheda delle proprietà del documento standard. Il plug-in implementa la propria interfaccia utente del foglio delle proprietà del documento. | Se dwMode == OEMCUIP_DOCPROP, restituire S_OK; in caso contrario, restituire E_NOTIMPL. |
| Nascondere l'interfaccia utente della scheda delle proprietà del dispositivo standard. Il plug-in implementa la propria interfaccia utente del foglio delle proprietà del dispositivo. | Se dwMode == OEMCUIP_PRNPROP, restituire S_OK; in caso contrario, restituire E_NOTIMPL. |
| Nascondere l'interfaccia utente del foglio delle proprietà standard. Il plug-in implementa la propria scheda delle proprietà documento e l'interfaccia utente del foglio delle proprietà del dispositivo. | Restituire S_OK, indipendentemente dal valore di dwMode. |
| Visualizzare tutta l'interfaccia utente della scheda delle proprietà standard. | Restituire E_NOTIMPL, indipendentemente dal valore dwMode. |
Se il metodo indica al driver che tutti i fogli delle proprietà standard devono essere nascosti, il IPrintOemUI2::HideStandardUI driver omette chiamate a compstui.dll (vedere Componenti Pscript) per aggiungere i fogli delle proprietà standard. Se restituisce S_OK, un plug-in dell'interfaccia utente deve implementare almeno un'interfaccia IPrintOemUI2::HideStandardUI utente personalizzata.
Quando la stampante ha installato più plug-in dell'interfaccia utente, il driver chiama plug-in dell'interfaccia utente nell'ordine in cui sono stati installati, fino a quando uno di essi restituisce S_OK o fino a quando tutti i plug-in dell'interfaccia utente sono stati chiamati 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. Quest'ultimo caso indica al driver che deve essere visualizzata l'interfaccia utente del foglio delle proprietà standard.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | prcomoem.h (include Prcomoem.h) |