# ncurses_color_set

(PHP 4 >= 4.0.7, PHP 5 < 5.3.0, PECL ncurses >= 1.0.0)

ncurses_color_set — Set active foreground and background colors

### 说明

ncurses_color_set ( int `$pair` ) : int

Sets the active foreground and background colors. Any characters written after this function is invoked will have these colors. This function requires terminal colors to be supported and initialized using ncurses_start_color() beforehand.

ncurses uses color pairs to specify both foreground and background colors. Use ncurses_init_pair() to define a color pair.

### 参数

`pair`

  The color pair from which to get the foreground and background colors to set as the active colors.

### 返回值

Returns -1 on success, and 0 on failure.

### 范例

Example #1 Writing a string with a specified color to the screen

    <?php
    ncurses_init();

    // If the terminal supports colors, initialize and set active color
    if (ncurses_has_colors()) {
        ncurses_start_color();
        ncurses_init_pair(1, NCURSES_COLOR_YELLOW, NCURSES_COLOR_BLUE);
        ncurses_color_set(1);
    }

    // Write a string at specified location
    ncurses_mvaddstr(10, 10, "Hello world! Yellow on blue text!");

    // Flush output to screen
    ncurses_refresh();

    ncurses_end();
    ?>

### 参见

- ncurses_init_pair() - Define a color pair
- ncurses_start_color() - Initializes color functionality