showcurrent Parameter

Forces a temporary display of the current line.

Scope: View

Syntax

query showcurrent 
set showcurrent { on | off | inverse } 

Options

on 
Display excluded line temporarily to allow the current position to be set on it.
off 
Only visible lines are made current. Excluded lines are not displayed.
inverse 
Toggle between on and off.

Description

The showcurrent on parameter allows the current line to remain visible even if it subsequently becomes an excluded line. Once the cursor is moved, the line, if in an excluded class, is no longer visible and cannot be re-selected.

The showcurrent off parameter moves the cursor from the line, if it is an excluded line, and places the cursor on the next visible line.

Example

All classes of this fragment from a C file are displayed:

/*  This is a comment  */
void f1 ( char, char, int *, int, int );
char f2 ( int );
#include <stdio.h>
main(int argc, char **argv, char **envp)
{ 
char b;
int a, c;
f1( b, b, &c, a, a );
strcpy ( b, f2(a) );
} 
void f1 ( char b, char c, int* a, int y, int z ) 
{ 
int i;
i = *a;
} 
char f2 ( int b ) 
{ 
return ('b');
} 

The cursor is on the line int i;. If showcurrent is on, and then you selected Functions from the View menu (to exclude all but functions), the following is displayed:

main(int argc, char **argv, char **envp)
void f1 ( char b, char c, int* a, int y, int z ) 
   int i;
char f2 ( int b ) 

The current position remains displayed, even though it is now an excluded line, until you move the cursor. If showcurrent is off and you select Functions from the Style menu, then only the functions are displayed but the current position moves to the next visible line.

API Return Codes

-2 
The option you specified was not on, off, or inverse. Issue the set command again using one of these options.

exclude Parameter
include Parameter