首页 > 代码库 > Window API译文

Window API译文

2024-07-06 20:40:49   228人阅读

public abstract class

Window

extends Object
java.lang.Object
   ? android.view.Window

Class Overview

Abstract base class for a top-level window look and behavior policy. An instance of this class should be used as the top-level view added to the window manager. It provides standard UI policies such as a background, title area, default key processing, etc.

The only existing implementation of this abstract class is android.policy.PhoneWindow, which you should instantiate when needing a Window. Eventually that class will be refactored and a factory method added for creating Window instances without knowing about a particular implementation

window是一个抽象基类，负责顶层窗口显示和行为的规则。这个类的一个实例必须被用作顶层的view加入到window manager中。它提供了标准UI规则，例如：背景，标题区域，默认的主进程等等。

这个抽象类的仅有的一个实现是android.policy.PhoneWindow。当你需要一个窗口window的时候，你需要实例化PhoneWindow。最后，PhoneWindow这个类会使用你不需要知道的特殊实现方式的重构方法进行重构，从而得到一个PhoneWindow对象，也即得到一个窗口。

Summary

Nested Classes内部类

interface

接口

Window.Callback

回调类

API from a Window back to its caller. 

应用程序编程接口：从窗口window到它的调用者

Constants
int DEFAULT_FEATURES窗口默认特征 The default features enabled 启用
int FEATURE_ACTION_BAR Flag for enabling the Action Bar.
int FEATURE_ACTION_BAR_OVERLAY Flag for requesting an Action Bar that overlays window content.
int FEATURE_ACTION_MODE_OVERLAY Flag for specifying the behavior of action modes when an Action Bar is not present.
int FEATURE_CONTEXT_MENU上下文菜单 Flag for the context menu.
int FEATURE_CUSTOM_TITLE自定义标题 Flag for custom title.
int FEATURE_INDETERMINATE_PROGRESS不确定的进度条 Flag for indeterminate progress
int FEATURE_LEFT_ICON标题区域的左图标 Flag for having an icon on the left side of the title bar
int FEATURE_NO_TITLE无标题 Flag for the "no title" feature, turning off the title at the top of the screen.
int FEATURE_OPTIONS_PANEL选项面板 Flag for the "options panel" feature.
int FEATURE_PROGRESS指示器进度条 Flag for the progress indicator feature
int FEATURE_RIGHT_ICON标题区域的右图标 Flag for having an icon on the right side of the title bar
int ID_ANDROID_CONTENT布局Layout的ID The ID that the main layout in the XML layout file should have.
int PROGRESS_END进度条的结束值 Ending value for the (primary) progress
int PROGRESS_INDETERMINATE_OFF关闭不确定的进度条 Flag for setting the progress bar‘s indeterminate mode off
int

PROGRESS_INDETERMINATE_ON开启不确定的进度条

 Flag for setting the progress bar‘s indeterminate mode on
int PROGRESS_SECONDARY_END第二进度条的最高可能值 Highest possible value for the secondary progress
int PROGRESS_SECONDARY_START第二进度条的最低可能值 Lowest possible value for the secondary progress
int PROGRESS_START进度条起始值 Starting value for the (primary) progress
int PROGRESS_VISIBILITY_OFF进度条不可见 Flag for setting the progress bar‘s visibility to GONE
int PROGRESS_VISIBILITY_ON进度条可见 Flag for setting the progress bar‘s visibility to VISIBLE
Public Constructors
  Window(Context context)构造方法
Public Methods
abstract void addContentView(View view, ViewGroup.LayoutParams params)
加Variation on setContentView(View, android.view.ViewGroup.LayoutParams) to add an additional content view to the screen.为window添加view，并且指定布局
void

addFlags(int flags)

为window添加特定的特征。

Convenience function to set the flag bits as specified in flags, as per setFlags(int, int).
void

clearFlags(int flags)

清除window的某一特征

Convenience function to clear the flag bits as specified in flags, as per setFlags(int, int).
abstract void closeAllPanels()关闭所有嵌入的面板
abstract void closePanel(int featureId)关闭某一个指定的嵌入面板
View

findViewById(int id)

通过id获取view。通过onCreate方法中处理的xml文件中标识View的 id，获取view。

Finds a view that was identified by the id attribute from the XML that was processed in onCreate(Bundle).
final WindowManager.LayoutParams

getAttributes()

获取当前窗口与这个面板相关的属性（布局信息）。

Retrieve the current window attributes associated with this panel.
final Window.Callback

getCallback()

获取这个窗口的回调接口。

Return the current Callback interface for this window.
final Window

getContainer()

获取这个窗口的容器（还是一个窗口）

Return the container for this Window.
final Context

getContext()

获取这个正在运行的窗口的上下文信息，从而可以从这些信息中获取到资源和其他的信息。

Return the Context this window policy is running in, for retrieving resources and other information.
abstract View

getCurrentFocus()

获取当前窗口中当前得到焦点的view。如果没有任何view得到焦点，则返回空。

Return the view in this Window that currently has focus, or null if there are none.
abstract View

getDecorView()

获得修饰view。获得顶层窗口的修饰view（包括标准窗口框架结构，修饰和窗口中的内容）。这个修饰view可以被当作一个window加入到window manager中。

Retrieve the top-level window decor view (containing the standard window frame/decorations and the client‘s content inside of that), which can be added as a window to the window manager.
abstract LayoutInflater

getLayoutInflater()

获得LayoutInflater实例。这个实例是从窗口从自己的上下文信息中得到的。

Quick access to the LayoutInflater instance that this Window retrieved from its Context.
abstract int getVolumeControlStream()获得音量控制流
WindowManager

getWindowManager()

获得这个window的窗口管理器window manager。window manager 允许这个window显示它的windows。

Return the window manager allowing this Window to display its own windows.
final TypedArray

getWindowStyle()

获得窗口主题的窗口属性。

Return the Window attributes from this window‘s theme.
final boolean hasChildren()有子孩子
boolean

hasFeature(int feature)

查询是否有某一个特定的特征

Query for the availability of a certain feature.
void

injectInputEvent(InputEvent event)

为窗口注册一个本地输入事件

Inject an event to window locally.
abstract void

invalidatePanelMenu(int featureId)无效的面板菜单（特征 id）

final boolean isActive()是否激活
abstract boolean

isFloating()

是否是悬浮状态

Return whether this window is being displayed with a floating style (based on the windowIsFloatingattribute in the style/theme).
abstract boolean

isShortcutKey(int keyCode, KeyEvent event)

是否是这个窗口的快捷键（键码，键盘事件）

Is a keypress one of the defined shortcut keys for this window.
final void makeActive()让这个窗口处于激活状态
abstract void

onConfigurationChanged(Configuration newConfig)

但窗口的配置信息改变时（新的配置信息）

Should be called when the configuration is changed.
abstract void openPanel(int featureId, KeyEvent event)打开面板（特征Id，键盘事件）
abstract View

peekDecorView()

获得当前窗口的修饰view：decor view.前提是这个修饰view已经被创建，否则会返回空

Retrieve the current decor view, but only if it has already been created; otherwise returns null.
abstract boolean performContextMenuIdentifierAction(int id, int flags)执行上下为文菜单某一标识的动作（id，标识）
abstract boolean performPanelIdentifierAction(int featureId, int id, int flags)执行面板标识动作（特征Id，id，标识）
abstract boolean performPanelShortcut(int featureId, int keyCode, KeyEvent event, int flags)执行面板快捷键(特征Id,键码，键盘事件)
boolean

requestFeature(int featureId)

请求某一扩展的屏幕特征有效(特征Id)

Enable extended screen features.
abstract void restoreHierarchyState(Bundle savedInstanceState)恢复等级状态(保存的实例状态)
abstract Bundle saveHierarchyState()保存等级状态
void

setAttributes(WindowManager.LayoutParams a)

设置自定义窗口属性（管理布局参数）

Specify custom window attributes.
abstract void

setBackgroundDrawable(Drawable drawable)

设置窗口背景图片(图片)

Change the background of this window to a custom Drawable.
void

setBackgroundDrawableResource(int resid)

设置窗口背景图像资源（资源Id）

Change the background of this window to a Drawable resource.
void

setCallback(Window.Callback callback)

设置这个窗口的回调接口，用于中断按键事件和其他窗口中的动态操作

Set the Callback interface for this window, used to intercept key events and other dynamic operations in the window.
abstract void setChildDrawable(int featureId, Drawable drawable)设置子图片（特征Id,图片）
abstract void setChildInt(int featureId, int value)设置子Id(特征Id，值)
void

setContainer(Window container)

为这个窗口设置容器（容器[本质还是个窗口]）

Set the container for this window.
abstract void

setContentView(View view)

设置内容view（view）。这是相对于setContetView(View,LayoutParams)的一个更直接的方法。

Convenience for setContentView(View, android.view.ViewGroup.LayoutParams) set the screen content to an explicit view.
abstract void

setContentView(int layoutResID)

设置内容view（资源）

Convenience for setContentView(View, android.view.ViewGroup.LayoutParams) to set the screen content from a layout resource.
abstract void

setContentView(View view, ViewGroup.LayoutParams params)

设置内容view（view,LayoutParams）

Set the screen content to an explicit view.
void

setDimAmount(float amount)

设置窗口背后的模糊度

Set the amount of dim behind the window when using FLAG_DIM_BEHIND.
abstract void setFeatureDrawable(int featureId, Drawable drawable)
设置特征图片（特征Id，图片）
Set an explicit Drawable value for feature of this window.
abstract void setFeatureDrawableAlpha(int featureId, int alpha)
设置特征图片透明度（特征Id，透明度）
Set a custom alpha value for the given drawale feature, controlling how much the background is visible through it.
abstract void

setFeatureDrawableResource(int featureId, int resId)

设置特征图片资源（特征id，资源）

Set the value for a drawable feature of this window, from a resource identifier.
abstract void

setFeatureDrawableUri(int featureId, Uri uri)

设置特征图片Uril（特征Id，uri）

Set the value for a drawable feature of this window, from a URI.
abstract void

setFeatureInt(int featureId, int value)

设置特征（特征Id，值）

Set the integer value for a feature.
void

setFlags(int flags, int mask)

设置window的标记，作为一个WindowManager.LayoutParams的标记。

Set the flags of the window, as per the WindowManager.LayoutParams flags.
void

setFormat(int format)

设置格式（像素格式）

Set the format of window, as per the PixelFormat types.
void

setGravity(int gravity)

设置权重（权重）

Set the gravity of the window, as per the Gravity constants.
void

setIcon(int resId)

为窗口设置设置图标（资源）

Set the primary icon for this window.
void

setLayout(int width, int height)

设置布局（宽度，高度）

Set the width and height layout parameters of the window.
void

setLocalFocus(boolean hasFocus, boolean inTouchMode)

设置本地焦点（是否具有焦点，是否是触屏模式）

Set focus locally.
void

setLogo(int resId)

设置Logo（资源）

Set the logo for this window.
void

setSoftInputMode(int mode)

设置软输入模式（模式）

Specify an explicit soft input mode to use for the window, as perWindowManager.LayoutParams.softInputMode.
abstract void

setTitle(CharSequence title)设置标题（标题）

abstract void setTitleColor(int textColor)设置标题颜色（颜色）
void

setType(int type)

设置窗口类型（类型），正如每个窗口布局的类型

Set the type of the window, as per the WindowManager.LayoutParams types.

void

setUiOptions(int uiOptions)

设置额外的UI操作（UI操作）

Set extra options that will influence the UI for this window.
void

setUiOptions(int uiOptions, int mask)

设置额外的UI操作选项（操作，动作掩码）

Set extra options that will influence the UI for this window.
abstract void setVolumeControlStream(int streamType)设置音量控制流（流类型）
void

setWindowAnimations(int resId)

设置窗口动画（动画资源）

Specify custom animations to use for the window, as per WindowManager.LayoutParams.windowAnimations.
void

setWindowManager(WindowManager wm, IBinder appToken, String appName, boolean hardwareAccelerated)

设置窗口所用的窗口管理器，如用来显示plane。

Set the window manager for use by this Window to, for example, display panels.
void

setWindowManager(WindowManager wm, IBinder appToken, String appName)

设置窗口所用的窗口管理器，如用来显示plane。

Set the window manager for use by this Window to, for example, display panels.
abstract boolean

superDispatchGenericMotionEvent(MotionEvent event)

派遣鼠标事件（鼠标事件）

被自定义的window使用，如diaglog。用于将一般的鼠标事件向下传递到view层级中。

Used by custom windows, such as Dialog, to pass the generic motion event further down the view hierarchy.
abstract boolean

superDispatchKeyEvent(KeyEvent event)

派遣键盘事件（键盘事件）

被自定义的window使用，如diaglog。用于将一般的按键事件向下传递到view层级中。

Used by custom windows, such as Dialog, to pass the key press event further down the view hierarchy.
abstract boolean

superDispatchKeyShortcutEvent(KeyEvent event)

派遣快捷键事件（键盘事件）

被自定义的window使用，如dialog。用于将一般的键盘事件向下传递到view层级中。

Used by custom windows, such as Dialog, to pass the key shortcut press event further down the view hierarchy.
abstract boolean

superDispatchTouchEvent(MotionEvent event)

派遣触摸事件（鼠标事件）

被自定义的window使用，如dialog。用于将一般的触屏事件向下传递到view层级中。

Used by custom windows, such as Dialog, to pass the touch screen event further down the view hierarchy.
abstract boolean

superDispatchTrackballEvent(MotionEvent event)

派遣轨迹事件（鼠标事件）

被自定义的window使用，如dialog，用于将轨迹事件向下传递到view的层级中。

Used by custom windows, such as Dialog, to pass the trackball event further down the view hierarchy.
abstract void

takeInputQueue(InputQueue.Callback callback)

取得输入的队列（输入回调接口）  获得输入队列的所有权

Take ownership of this window‘s InputQueue.
abstract void

takeKeyEvents(boolean get)

取得键盘事件（是否获得）  请求获得键盘事件到这个activity。

Request that key events come to this activity.
abstract void

takeSurface(SurfaceHolder.Callback2 callback)

取得该window的surface的拥有权控制权。（SurfaceHolder.CallBack2接口）

Take ownership of this window‘s surface.
abstract void togglePanel(int featureId, KeyEvent event)　　　　切换面板（特征Id,键盘事件）
Protected Methods
final int getFeatures()
获取启用的特征
Return the feature bits that are enabled.
final int

getForcedWindowFlags()

获取被客户明确设置的window flag，因此将不会被getDecorView修改。

Return the window flags that have been explicitly set by the client, so will not be modified by getDecorView().
final int

getLocalFeatures()

获取被这个窗口实现的特征

Return the feature bits that are being implemented by this Window.
final boolean

hasSoftInputMode()

是否有软输入模式

Has the app specified their own soft input mode?
abstract void onActive()是否激活
void

setDefaultWindowFormat(int format)

设置默认的窗口模式（模式）

Set the default format of window, as per the PixelFormat types.


联系
我们