ELEMENT_STRING

Use ELEMENT_STRING to display text on a gauge. ELEMENT_STRING is particularly useful when you have a string that changes as the gauge is updated; the string can be automatically updated by setting up the MODULE_VAR elements and using callback functions. Using ELEMENT_STRING, you can specify the font name, weight, background and foreground colors of the text. You can also specify a highlight text color to use when the string is selected.

typedef struct ELEMENT_STRING

{

HEADER;

MODULE_VARsource_var[3];

FLOAT64save_var[3];

PMODULE_VAR_CB source_var_cb[3];

PFN_FLOAT64source_fn;

PCHARstring;

PCHARstring_old;

PIXPOINTimg_size;

PIMAGEstring_data;

PIMAGEsave_buffer;

COLORREFfg_color;

COLORREFbg_color;

COLORREFhilite_color;

HDChdc;

HFONThfont;

HFONThfont_old;

HBITMAPhbmp;

HBITMAPhbmp_old;

HBRUSHhbrush;

HBRUSHhbrush_old;

charfont_name[32];

longfont_weight;

UINT8font_charset;

UINT32draw_text_flags;

UINT16max_string_length;

UINT16char_width;

SINT16sel_str;

SINT16sel_end;

PSEQ_RECseq;

intsave_global_seq;

} ELEMENT_STRING, *PELEMENT_STRING, **PPELEMENT_STRING;

ELEMENT_STRING uses the following members:

You can use the SEQ_REC table to automatically select a string on certain KEY_EVENTs. Flight Simulator 98 allows the user to select certain gauge elements by using different keyboard combinations. The SEQ_REC structure sets up the relationship between the current selection state and the characters that can be selected for that state. The following code example shows the SEQ_REC structure definition:

typedef struct SEQ_REC

{

int seq_id;

int sel_str;

int sel_end;

} SEQ_REC, *PSEQ_REC, **PPSEQ_REC;

SEQ_REQ uses the following members:

To mark the end of the array you must add one blank record that sets seq_id, sel_str, and sel_end to SELECT_NONE, 0, and 0, respectively. The following code example shows a sample SEQ_REC definition:

SEQ_REC seq_com[]  =

{

{SELECT_COM_WHOLE, 0, 2},

{SELECT_COM_FRACTION, 4, 5},

{SELECT_NONE, 0, 0}

};

The following table includes the gauge selection states available in Flight Simulator 98.