Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxCustomShellListView.OnBeforeNavigation Event

In This Article

Occurs before navigating to a new shell item.

#Declaration

Delphi
property OnBeforeNavigation: TcxBeforeNavigationEvent read; write;

#Remarks

The OnBeforeNavigation event occurs before navigating to a new shell item. The new shell item is identified by the ANewAbsolutePIDL parameter. This parameter is a PItemIDList value, representing a new shell item. In order to convert this value to a readable string, use the GetPIDLName function.

The following code example prints the path to the accessed shell item within a status bar:

Delphi
procedure TForm1.cxShellListView1BeforeNavigation(Sender: TcxCustomShellListView; ANewAbsolutePIDL: PItemIDList);
begin
  StatusBar1.SimpleText := GetPidlName(ANewAbsolutePIDL);
end;
See Also