Funzioni di output della console di basso livello
Importante
Questo documento descrive le funzionalità della piattaforma della console che non fanno più parte della roadmap dell'ecosistema. Non è consigliabile usare questo contenuto nei nuovi prodotti, ma continueremo a supportare gli utilizzi esistenti per il futuro indefinito. La soluzione moderna preferita è incentrata sulle sequenze di terminale virtuale per garantire la massima compatibilità negli scenari multipiattaforma. Per altre informazioni su questa decisione di progettazione, vedere il documento relativo alla console classica e al terminale virtuale.
Le funzioni di output della console di basso livello forniscono accesso diretto alle celle di caratteri di un buffer dello schermo. Un set di funzioni legge o scrive in celle consecutive che iniziano in qualsiasi posizione nel buffer dello schermo della console. Un altro set di funzioni legge o scrive in blocchi rettangolari di celle.
Le funzioni seguenti leggono o scrivono in un numero specificato di celle di caratteri consecutive in un buffer dello schermo, a partire da una cella specificata.
| Funzione | Descrizione |
|---|---|
| ReadConsoleOutputCharacter | Copia una stringa di caratteri Unicode o ANSI da un buffer dello schermo. |
| WriteConsoleOutputCharacter | Scrive una stringa di caratteri Unicode o ANSI in un buffer dello schermo. |
| ReadConsoleOutputAttribute | Copia una stringa di attributi di colore di testo e di sfondo da un buffer dello schermo. |
| WriteConsoleOutputAttribute | Scrive una stringa di attributi di colore di testo e sfondo in un buffer dello schermo. |
| FillConsoleOutputCharacter | Scrive un singolo carattere Unicode o ANSI in un numero specificato di celle consecutive in un buffer dello schermo. |
| FillConsoleOutputAttribute | Scrive una combinazione di attributi colore di testo e sfondo in un numero specificato di celle consecutive in un buffer dello schermo. |
Per tutte queste funzioni, quando viene rilevata l'ultima cella di una riga, la lettura o la scrittura esegue il wrapping nella prima cella della riga successiva. Quando viene rilevata la fine dell'ultima riga del buffer dello schermo della console, le funzioni di scrittura eliminano tutti i caratteri o gli attributi non scritti e le funzioni di lettura segnalano il numero di caratteri o attributi effettivamente scritti.
Le funzioni seguenti leggono o scrivono in blocchi rettangolari di celle di caratteri in una posizione specificata in un buffer dello schermo.
| Funzione | Descrizione |
|---|---|
| ReadConsoleOutput | Copia i dati di caratteri e colori da un blocco specificato di celle del buffer dello schermo in un determinato blocco in un buffer di destinazione. |
| WriteConsoleOutput | Scrive dati di tipo carattere e colore in un blocco specificato di celle del buffer dello schermo da un determinato blocco in un buffer di origine. |
Queste funzioni considerano buffer dello schermo e buffer di origine o di destinazione come matrici bidimensionali di strutture CHAR_INFO (contenenti dati di attributi carattere e colore per ogni cella). Le funzioni specificano la larghezza e l'altezza, nelle celle di caratteri, del buffer di origine o di destinazione e il puntatore al buffer viene considerato un puntatore alla cella di origine (0,0) della matrice bidimensionale. Le funzioni usano una struttura SMALL_RECT per specificare quale rettangolo accedere nel buffer dello schermo della console e le coordinate della cella superiore sinistra nel buffer di origine o di destinazione determinano la posizione del rettangolo corrispondente in tale buffer.
Queste funzioni ritagliano automaticamente il rettangolo del buffer dello schermo specificato per adattarsi entro i limiti del buffer dello schermo della console. Ad esempio, se il rettangolo specifica le coordinate inferiori a destra (colonna 100, riga 50) e il buffer dello schermo della console è largo solo 80 colonne, le coordinate vengono ritagliate in modo che siano (colonna 79, riga 50). Analogamente, questo rettangolo regolato viene nuovamente ritagliato per adattarsi entro i limiti del buffer di origine o di destinazione. Vengono specificate le coordinate del buffer dello schermo del rettangolo effettivo da cui è stata letta o scritta. Per un esempio che usa queste funzioni, vedere Lettura e scrittura di blocchi di caratteri e attributi.
La figura mostra un'operazione ReadConsoleOutput in cui si verifica il ritaglio quando il blocco viene letto dal buffer dello schermo della console e di nuovo quando il blocco viene copiato nel buffer di destinazione. La funzione segnala il rettangolo effettivo del buffer dello schermo da cui è stato copiato.
