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
