Stili di controllo statici

Per creare un controllo statico usando la funzione CreateWindow o CreateWindowEx, specificare la classe STATIC, le costanti di stile della finestra appropriate e una combinazione degli stili di controllo statici seguenti.

Costante	Descrizione
SS_BITMAP	Una bitmap deve essere visualizzata nel controllo statico. Il testo è il nome di una bitmap (non un nome file) definito altrove nel file di risorse. Lo stile ignora i parametri nWidth e nHeight . Il controllo ridimensiona automaticamente se stesso per contenere la bitmap.
SS_BLACKFRAME	Casella con una cornice disegnata nello stesso colore delle cornici della finestra. Questo colore è nero nella combinazione di colori predefinita.
SS_BLACKRECT	Rettangolo riempito con il colore della cornice della finestra corrente. Questo colore è nero nella combinazione di colori predefinita.
SS_CENTER	Un rettangolo semplice e centra il testo nel rettangolo. Il testo viene formattato prima che venga visualizzato. Le parole che si estendono oltre la fine di una riga vengono racchiuse automaticamente all'inizio della riga centrata successiva. Le parole più lunghe della larghezza del controllo vengono troncate.
SS_CENTERIMAGE	Una bitmap è allineata al centro nel controllo statico che lo contiene. Il controllo non viene ridimensionato, in modo che una bitmap troppo grande per il controllo venga ritagliata. Se il controllo statico contiene una singola riga di testo, il testo viene centrato verticalmente nell'area client del controllo.
SS_EDITCONTROL	Il controllo statico duplica le caratteristiche di visualizzazione del testo di un controllo di modifica su più righe. In particolare, la larghezza media dei caratteri viene calcolata nello stesso modo di un controllo di modifica e la funzione non visualizza un'ultima riga parzialmente visibile.
SS_ENDELLIPSIS	Se la fine di una stringa non rientra nel rettangolo, viene troncata e vengono aggiunti puntini di sospensione. Se una parola non alla fine della stringa supera i limiti del rettangolo, viene troncata senza puntini di sospensione. L'uso di questo stile forza il testo del controllo su una riga senza ritorno a capo automatico. Confrontare con SS_PATHELLIPSIS e SS_WORDELLIPSIS.
SS_ENHMETAFILE	Un metafile avanzato deve essere visualizzato nel controllo statico. Il testo è il nome di un metafile. Un controllo statico metafile avanzato ha una dimensione fissa; il metafile viene ridimensionato per adattarsi all'area client del controllo statico.
SS_ETCHEDFRAME	Disegna la cornice del controllo statico utilizzando lo stile del bordo EDGE_ETCHED . Per altre informazioni, vedere la funzione DrawEdge.
SS_ETCHEDHORZ	Disegna i bordi superiore e inferiore del controllo statico utilizzando lo stile del bordo EDGE_ETCHED . Per altre informazioni, vedere la funzione DrawEdge.
SS_ETCHEDVERT	Disegna i bordi sinistro e destro del controllo statico utilizzando lo stile del bordo EDGE_ETCHED . Per altre informazioni, vedere la funzione DrawEdge.
SS_GRAYFRAME	Casella con una cornice disegnata con lo stesso colore dello sfondo dello schermo (desktop). Questo colore è grigio nella combinazione di colori predefinita.
SS_GRAYRECT	Rettangolo riempito con il colore di sfondo dello schermo corrente. Questo colore è grigio nella combinazione di colori predefinita.
SS_ICON	Icona da visualizzare nella finestra di dialogo. Se il controllo viene creato come parte di una finestra di dialogo, il testo è il nome di un'icona (non un nome file) definito altrove nel file di risorse. Se il controllo viene creato tramite CreateWindow o una funzione correlata, il testo è il nome di un'icona (non un nome file) definito nel file di risorse associato al modulo specificato dal parametro hInstance a CreateWindow. L'icona può essere un cursore animato. Lo stile ignora i parametri CreateWindow nWidth e nHeight. Il controllo ridimensiona automaticamente se stesso per contenere l'icona. Poiché usa la funzione LoadIcon, lo stile SS_ICON può caricare solo icone di dimensioni SM_CXICON e SM_CYICON. Questa restrizione può essere ignorata utilizzando lo stile SS_REALSIZEIMAGE oltre a SS_ICON. Se non è possibile caricare un'icona tramite LoadIcon, viene effettuato un tentativo di caricare la risorsa specificata come cursore usando LoadCursor. In caso di errore eccessivo, viene effettuato un tentativo di caricamento dal driver di dispositivo usando LoadImage.
SS_LEFT	Un semplice rettangolo e allinea a sinistra il testo nel rettangolo. Il testo viene formattato prima che venga visualizzato. Le parole che si estendono oltre la fine di una riga vengono racchiuse automaticamente all'inizio della riga successiva allineata a sinistra. Le parole più lunghe della larghezza del controllo vengono troncate.
SS_LEFTNOWORDWRAP	Un semplice rettangolo e allinea a sinistra il testo nel rettangolo. Le schede vengono espanse, ma le parole non vengono disposte a capo. Il testo che si estende oltre la fine di una riga viene ritagliato.
SS_NOPREFIX	Impedisce l'interpretazione di qualsiasi carattere di e commerciale (&) nel testo del controllo come caratteri di prefisso dell'acceleratore. Questi vengono visualizzati con la e commerciale rimossa e il carattere successivo nella stringa sottolineata. Questo stile di controllo statico può essere incluso in uno dei controlli statici definiti. È possibile combinare SS_NOPREFIX con altri stili. Ciò può essere utile quando i nomi file o altre stringhe che possono contenere una e commerciale (&) devono essere visualizzati in un controllo statico in una finestra di dialogo.
SS_NOTIFY	Invia la finestra padre STN_CLICKED, STN_DBLCLK, STN_DISABLE e STN_ENABLE codici di notifica quando l'utente fa clic o fa doppio clic sul controllo.
SS_OWNERDRAW	Il proprietario del controllo statico è responsabile del disegno del controllo. La finestra del proprietario riceve un messaggio WM_DRAWITEM ogni volta che è necessario disegnare il controllo.
SS_PATHELLIPSIS	Sostituisce i caratteri al centro della stringa con puntini di sospensione in modo che il risultato si adatti al rettangolo specificato. Se la stringa contiene caratteri barra rovesciata (\), SS_PATHELLIPSIS mantiene il più possibile il testo dopo l'ultima barra rovesciata. L'uso di questo stile forza il testo del controllo su una riga senza ritorno a capo automatico. Confrontare con SS_ENDELLIPSIS e SS_WORDELLIPSIS.
SS_REALSIZECONTROL	Regola la bitmap in base alle dimensioni del controllo statico. Ad esempio, la modifica delle impostazioni locali può modificare il tipo di carattere di sistema e quindi i controlli potrebbero essere ridimensionati. Se un controllo statico ha una bitmap, la bitmap non si adatta più al controllo. Questo bit di stile determina la ridimensionamento automatico delle bitmap per adattarsi ai controlli. Se si specifica SS_CENTERIMAGE , la bitmap o l'icona viene allineata al centro (e ritagliata se necessario). Se non viene specificato SS_CENTERIMAGE , la bitmap o l'icona viene estesa o compattata. Si noti che le dimensioni nei due assi sono indipendenti e il risultato può avere proporzioni modificate. Confrontare con SS_REALSIZEIMAGE.
SS_REALSIZEIMAGE	Specifica che viene usata la larghezza effettiva della risorsa e che l'icona viene caricata usando LoadImage. SS_REALSIZEIMAGE viene sempre usato insieme a SS_ICON. SS_REALSIZEIMAGE usa LoadImage, sostituendo il processo normalmente seguito in SS_ICON. Non carica i cursori; se LoadImage non riesce, non vengono eseguiti ulteriori tentativi di caricamento. Usa la larghezza effettiva della risorsa. Il controllo statico viene ridimensionato di conseguenza, ma l'icona rimane allineata ai bordi sinistro e superiore del controllo specificati in origine. Si noti che se SS_CENTERIMAGE viene specificata anche, l'icona viene allineata al centro all'interno dello spazio del controllo, specificato usando i parametri CreateWindow nWidth e nHeight. Confrontare con SS_REALSIZECONTROL.
SS_RIGHT	Un semplice rettangolo e allinea a destra il testo nel rettangolo. Il testo viene formattato prima che venga visualizzato. Le parole che si estendono oltre la fine di una riga vengono automaticamente racchiuse all'inizio della riga allineata a destra successiva. Le parole più lunghe della larghezza del controllo vengono troncate.
SS_RIGHTJUST	L'angolo inferiore destro di un controllo statico con lo stile SS_BITMAP o SS_ICON deve rimanere fisso quando il controllo viene ridimensionato. Solo i lati superiore e sinistro vengono modificati per contenere una nuova bitmap o icona.
SS_SIMPLE	Un rettangolo semplice e visualizza una singola riga di testo allineato a sinistra nel rettangolo. La riga di testo non può essere abbreviata o modificata in alcun modo. Inoltre, se il controllo è disabilitato, il controllo non ne grigio il testo.
SS_SUNKEN	Disegna un bordo incassato a metà intorno a un controllo statico.
SS_TYPEMASK	Bit di stile composito risultante dall'uso dell'operatore OR nei bit di stile SS_*. Può essere usato per mascherare i bit validi SS_* da una maschera di bit specificata. Si noti che questo non è aggiornato e non include correttamente tutti gli stili validi. Pertanto, non è consigliabile utilizzare questo stile.
SS_WHITEFRAME	Casella con una cornice disegnata con lo stesso colore dello sfondo della finestra. Questo colore è bianco nella combinazione di colori predefinita.
SS_WHITERECT	Rettangolo riempito con il colore di sfondo della finestra corrente. Questo colore è bianco nella combinazione di colori predefinita.
SS_WORDELLIPSIS	Tronca qualsiasi parola che non rientra nel rettangolo e aggiunge puntini di sospensione. L'uso di questo stile forza il testo del controllo su una riga senza ritorno a capo automatico. Confrontare con SS_ENDELLIPSIS e SS_PATHELLIPSIS.

Osservazioni:

Per utilizzare uno stile che tronca parole o stringhe con puntini di sospensione per il testo su più righe, è possibile utilizzare DrawThemeText o DrawText in un controllo di disegno proprietario con flag di formattazione DT_WORDBREAK e DT_ENDELLIPSIS impostata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Winuser.h (include Windows.h)